com.visioglobe.VisioSample.Interfaces

Interface VgMyLayerAndCameraHandler

All Known Implementing Classes:

VgMyBasicApplicationController, VgMyStackedLayerAndCameraHandler

public interface VgMyLayerAndCameraHandler

Interface for Objects that handle the display of the layers, the camera and their respective animations. It basically handles two layer layout : global and detailed view. A Global View displays multiple layers. A Detailed View displays only one layer.

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	getFocusedLayerName() Gets the focused layer's name.
void	gotoLayer(long pLayerIndex, boolean pIsAnimated) Focus a specific layer
void	gotoLayer(java.lang.String pLayerName, boolean pIsAnimated) Focus a specific layer
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	refreshParameters(long pWidth, long pHeight) Refreshes the inner parameters.
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.
void	switchToDetailedView(boolean pIsAnimated) Switches from the global to the detailed view.
void	switchToGlobalView(boolean pIsAnimated) Switches from the detailledView to the global view.

Method Detail

isGlobalView

boolean isGlobalView()

Returns:

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

switchToGlobalView

void switchToGlobalView(boolean pIsAnimated)

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

Parameters:

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

switchToDetailedView

void switchToDetailedView(boolean pIsAnimated)

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

Parameters:

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

getFocusedLayerName

java.lang.String getFocusedLayerName()

Gets the focused layer's name. The "focused" layer is the one that is displayed in the detailed view. if the global view is displayed, the focused layer should be the most visible one.

Returns:

The focused layer's name.

gotoLayer

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

Focus a specific layer

Parameters:

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

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

gotoLayer

void gotoLayer(long pLayerIndex,
             boolean pIsAnimated)

Focus a specific layer

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.

gotoViewpoint

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

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.

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

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

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.

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.

refreshParameters

void refreshParameters(long pWidth,
                     long pHeight)

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

release

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.