com.visioglobe.VisioSample.Blocks

Class VgMyStackedLayerAndCameraHandler

java.lang.Object

com.visioglobe.VisioSample.Blocks.VgMyStackedLayerAndCameraHandler

All Implemented Interfaces:

VgMyLayerAndCameraHandler

public class VgMyStackedLayerAndCameraHandler
extends java.lang.Object
implements VgMyLayerAndCameraHandler

Controls the camera & the Layer display. This helper simplifies the management of the camera wihtin a stack of layer. This layers are usually floors. IMPLEMENTATION TIPS: This is an advanced class. You can customize it at will to change its behavior or get some inspiration to build other eye-candy display & behavior for your layers (carousel for example) This would require knowledge in 3D mathematics.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	VgMyStackedLayerAndCameraHandler.VgMyConfigurableParam The below enum represents parameters that can be configured to change the behaviour of the VgMyStackedLayerAndCameraHandler object.

Field Summary

Fields

Modifier and Type	Field and Description
long	mCurrentLayerIndex
protected boolean	mSetFovOnce Setup the elements which are associated with the view's width and height

Constructor Summary

Constructors

Constructor and Description
VgMyStackedLayerAndCameraHandler(VgMySurfaceView pSurfaceView, VgMyLayerAndCameraListener pLayerUpdateListener, long pViewWidthInPixels, long pViewHeightInPixels)

Method Summary

Methods

Modifier and Type	Method and Description
void	animateCameraToViewPoint(VgIViewPoint pViewPoint, float pDuration, boolean pIsAnimated) Animates the camera from its current view point to the given view point
void	animateLayersFromCloseToStackView(com.visioglobe.VisioSample.Blocks.VgMyStackedLayerAndCameraHandler.eFromToViewEnum pDirection, float pDuration, boolean pIsAnimated)
void	animateLayerToPositionAndRotation(VgLayerRefPtr pLayer, VgPosition pStartPos, VgPosition pEndPos, VgIAnimationCallbackRefPtr pCallback, float pDuration, float pStartAngle, float pEndAngle) Gets the position for a layer when in detailed view.
protected void	calculateDynamicStackParams()
static double	computeAngularDistance(double pA, double pB)
VgPosition	getCameraPosition()
java.lang.String	getFocusedLayerName() Note: mCurrentLayerIndex is only valid when mIsLayerInitialized is true
boolean	getLayerName(long pLayerIndex, java.lang.String pLayerNameOut)
long	getNumberOfLayers()
double	getParam(VgMyStackedLayerAndCameraHandler.VgMyConfigurableParam pParam)
VgPosition	getPositionForLayerInDetailedView(long pLayerIndex, long pFocusedLayer)
VgPosition	getPositionForLayerInGlobalView(long pLayerIndex, long pFocusedLayer)
VgPosition	getStackCenter()
VgIViewPoint	getStackViewPoint()
void	gotoLayer(long pLayerIndex, boolean pIsAnimated) Focus a specific layer
void	gotoLayer(java.lang.String pLayerName, boolean pIsAnimated) Focus a specific layer
void	gotoLayerInDetailedView(long pLayerIndex, boolean pIsAnimated)
void	gotoLayerInGlobalView(long pLayerIndex, boolean pIsAnimated)
void	gotoLookAtPosition(VgPosition pPosition, java.lang.String pLayerName, boolean pIsAnimated) Moves the camera so that it is focused on a given position.
void	gotoViewpoint(VgIViewPoint pViewPoint, java.lang.String pLayerName, boolean pIsAnimated) Moves the camera to a specific view point.
boolean	isGlobalView()
void	onLayerSelected()
void	onSelectorReady()
void	refreshParameters(long pWidth, long pHeight) Refreshes the inner parameters.
void	refreshStackView()
void	release() This method should be called when the activity dies to notify that we should release/unregister all VisioDevKit objects, and null out as much references on other objects as possible.
protected void	setDefaultStackParams()
void	setParam(VgMyStackedLayerAndCameraHandler.VgMyConfigurableParam pParam, double pDouble)
void	setStackCenterPosition(VgPosition pCenterPos)
void	switchToDetailedView(boolean pIsAnimated) Switches from the global to the detailed view.
void	switchToGlobalView(boolean pIsAnimated) Switches from the detailledView to the global view.
void	updateManipulatorForGlobalView(boolean pIsGlobalView)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

mCurrentLayerIndex

public long mCurrentLayerIndex

mSetFovOnce

protected boolean mSetFovOnce

Setup the elements which are associated with the view's width and height

Constructor Detail

VgMyStackedLayerAndCameraHandler

public VgMyStackedLayerAndCameraHandler(VgMySurfaceView pSurfaceView,
                                VgMyLayerAndCameraListener pLayerUpdateListener,
                                long pViewWidthInPixels,
                                long pViewHeightInPixels)

Method Detail

setDefaultStackParams

protected void setDefaultStackParams()

updateManipulatorForGlobalView

public void updateManipulatorForGlobalView(boolean pIsGlobalView)

isGlobalView

public boolean isGlobalView()

Specified by:

isGlobalView in interface VgMyLayerAndCameraHandler

Returns:

True if the Handler displays the global view. False if displaying the detailed view.

switchToGlobalView

public void switchToGlobalView(boolean pIsAnimated)

Description copied from interface: VgMyLayerAndCameraHandler

Switches from the detailledView to the global view. Do nothing if already in global view.

Specified by:

switchToGlobalView in interface VgMyLayerAndCameraHandler

Parameters:

pIsAnimated - If true then animates the transition, otherwise does not.

switchToDetailedView

public void switchToDetailedView(boolean pIsAnimated)

Description copied from interface: VgMyLayerAndCameraHandler

Switches from the global to the detailed view. Do nothing if already in detailed view.

Specified by:

switchToDetailedView in interface VgMyLayerAndCameraHandler

Parameters:

pIsAnimated - If true then animates the transition, otherwise does not.

getFocusedLayerName

public java.lang.String getFocusedLayerName()

Note: mCurrentLayerIndex is only valid when mIsLayerInitialized is true

Specified by:

getFocusedLayerName in interface VgMyLayerAndCameraHandler

Returns:

The focused layer's name.

getNumberOfLayers

public long getNumberOfLayers()

getLayerName

public boolean getLayerName(long pLayerIndex,
                   java.lang.String pLayerNameOut)

gotoLayer

public void gotoLayer(java.lang.String pLayerName,
             boolean pIsAnimated)

Description copied from interface: VgMyLayerAndCameraHandler

Focus a specific layer

Specified by:

gotoLayer in interface VgMyLayerAndCameraHandler

Parameters:

pLayerName - Layer that will be focused. keeps current mode.

pIsAnimated - If true then animates the transition, otherwise does not.

gotoLayer

public void gotoLayer(long pLayerIndex,
             boolean pIsAnimated)

Description copied from interface: VgMyLayerAndCameraHandler

Focus a specific layer

Specified by:

gotoLayer in interface VgMyLayerAndCameraHandler

Parameters:

pLayerIndex - Layer index which is associated with the returned list given by VgLayerManager::getLayers(). keeps current mode.

pIsAnimated - If true then animates the transition, otherwise does not.

gotoLayerInGlobalView

public void gotoLayerInGlobalView(long pLayerIndex,
                         boolean pIsAnimated)

gotoLayerInDetailedView

public void gotoLayerInDetailedView(long pLayerIndex,
                           boolean pIsAnimated)

getPositionForLayerInGlobalView

public VgPosition getPositionForLayerInGlobalView(long pLayerIndex,
                                         long pFocusedLayer)

getPositionForLayerInDetailedView

public VgPosition getPositionForLayerInDetailedView(long pLayerIndex,
                                           long pFocusedLayer)

gotoViewpoint

public void gotoViewpoint(VgIViewPoint pViewPoint,
                 java.lang.String pLayerName,
                 boolean pIsAnimated)

Description copied from interface: VgMyLayerAndCameraHandler

Moves the camera to a specific view point. If the pLayerName isn't the currently focused layer, then before any camera movement is invoked, pLayerName becomes the focused layer.

Specified by:

gotoViewpoint in interface VgMyLayerAndCameraHandler

Parameters:

pViewPoint - The view point to associate with the camera

pLayerName - The layer which should be given the focus.

pIsAnimated - If true then animates the transition, otherwise does not.

gotoLookAtPosition

public void gotoLookAtPosition(VgPosition pPosition,
                      java.lang.String pLayerName,
                      boolean pIsAnimated)

Description copied from interface: VgMyLayerAndCameraHandler

Moves the camera so that it is focused on a given position. The camera's view, heading, pitch are always conserved. The altitude of pPosition is automatically set to zero. If the pLayerName isn't the currently focused layer, then before any camera movement is invoked, pLayerName becomes the focused layer.

Specified by:

gotoLookAtPosition in interface VgMyLayerAndCameraHandler

Parameters:

pPosition - The position to focus on.

pLayerName - The name of the layer associated with the position.

pIsAnimated - If true then animates the transition, otherwise does not.

animateLayersFromCloseToStackView

public void animateLayersFromCloseToStackView(com.visioglobe.VisioSample.Blocks.VgMyStackedLayerAndCameraHandler.eFromToViewEnum pDirection,
                                     float pDuration,
                                     boolean pIsAnimated)

animateLayerToPositionAndRotation

public void animateLayerToPositionAndRotation(VgLayerRefPtr pLayer,
                                     VgPosition pStartPos,
                                     VgPosition pEndPos,
                                     VgIAnimationCallbackRefPtr pCallback,
                                     float pDuration,
                                     float pStartAngle,
                                     float pEndAngle)

Gets the position for a layer when in detailed view.

Parameters:

pLayer - pointer to layer to manipulate

pStartPos - starting position of layer. If not the same as its current position it will jump.

pEndPos - ending position of layer.

pCallback - callback at end of animation.

pDuration - duration of animation in seconds.

pStartAngle - start angle of layer, used for carrousel mode, otherwise use 0.0f

pEndAngle - start angle of layer, used for carrousel mode, otherwise use 0.0f

getStackViewPoint

public VgIViewPoint getStackViewPoint()

animateCameraToViewPoint

public void animateCameraToViewPoint(VgIViewPoint pViewPoint,
                            float pDuration,
                            boolean pIsAnimated)

Animates the camera from its current view point to the given view point

Parameters:

pViewPoint - The view point to move the camera to.

pDuration - Animation duration in seconds.

getCameraPosition

public VgPosition getCameraPosition()

onLayerSelected

public void onLayerSelected()

onSelectorReady

public void onSelectorReady()

refreshParameters

public void refreshParameters(long pWidth,
                     long pHeight)

Description copied from interface: VgMyLayerAndCameraHandler

Refreshes the inner parameters. Typically, subclasses can use it to recompute their view parameters when the rendering size changes.

Specified by:

refreshParameters in interface VgMyLayerAndCameraHandler

refreshStackView

public void refreshStackView()

calculateDynamicStackParams

protected void calculateDynamicStackParams()

setStackCenterPosition

public void setStackCenterPosition(VgPosition pCenterPos)

getStackCenter

public VgPosition getStackCenter()

setParam

public void setParam(VgMyStackedLayerAndCameraHandler.VgMyConfigurableParam pParam,
            double pDouble)

getParam

public double getParam(VgMyStackedLayerAndCameraHandler.VgMyConfigurableParam pParam)

release

public void release()

This method should be called when the activity dies to notify that we should release/unregister all VisioDevKit objects, and null out as much references on other objects as possible.

Specified by:

release in interface VgMyLayerAndCameraHandler

computeAngularDistance

public static double computeAngularDistance(double pA,
                            double pB)