com.mousebird.maply

Class UpdateLayer

java.lang.Object

com.mousebird.maply.Layer

com.mousebird.maply.UpdateLayer

All Implemented Interfaces:

LayerThread.ViewWatcherInterface

public class UpdateLayer
extends Layer
implements LayerThread.ViewWatcherInterface

This layer will call a delegate as the user moves around, but constrained to distance and time. This layer is responsible for calling a delegate you provide as the user moves their viewpoint around. You'll be called if they move from than a certain amount, but not more often than the minimum time.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	UpdateLayer.Delegate Fill in the delegate for callbacks

Field Summary

Fields

Modifier and Type	Field and Description
UpdateLayer.Delegate	delegate
float	maxLag
float	minTime
float	moveDist

Fields inherited from class com.mousebird.maply.Layer

layerThread

Constructor Summary

Constructors

Constructor and Description
UpdateLayer(float moveDist, float minTime, UpdateLayer.Delegate delegate, BaseController inMaplyControl)

Method Summary

Modifier and Type	Method and Description
float	getMaxLagTime() How long the layer can go without a viewUpdated() call.
float	getMinTime() This minimum time before unique viewUpdated() calls.
void	shutdown() This method is called when a layer is to be removed.
void	startLayer(LayerThread inLayerThread) Once your layer is created and handed to the LayerThread, it needs to actually be started on that layer.
void	viewUpdated(ViewState newViewState) This method is called when the view updates, but no more often then the minTime().

Methods inherited from class com.mousebird.maply.Layer

preSceneFlush

Methods inherited from class java.lang.Object

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

Field Detail

delegate

public UpdateLayer.Delegate delegate

moveDist

public float moveDist

minTime

public float minTime

maxLag

public float maxLag

Constructor Detail

UpdateLayer

public UpdateLayer(float moveDist,
                   float minTime,
                   UpdateLayer.Delegate delegate,
                   BaseController inMaplyControl)

Method Detail

startLayer

public void startLayer(LayerThread inLayerThread)

Description copied from class: Layer

Once your layer is created and handed to the LayerThread, it needs to actually be started on that layer. This call indicates the layer has been started on the thread and can hook itself into the system, generating geometry or registering for view changes and such.

Overrides:

startLayer in class Layer

shutdown

public void shutdown()

Description copied from class: Layer

This method is called when a layer is to be removed. The layer should clean up any objects it may have created.

If the MaplyController is shut down, you may not get this call and instead may simply be deleted.

Overrides:

shutdown in class Layer

viewUpdated

public void viewUpdated(ViewState newViewState)

Description copied from interface: LayerThread.ViewWatcherInterface

This method is called when the view updates, but no more often then the minTime().

Specified by:

viewUpdated in interface LayerThread.ViewWatcherInterface

Parameters:

newViewState - The new state for the view associated with the MaplyController.

getMinTime

public float getMinTime()

Description copied from interface: LayerThread.ViewWatcherInterface

This minimum time before unique viewUpdated() calls. Layers can't handle rapid changes of the view, typically. So we pick a period, such as 1/10s that we can handle and specify that here. The viewUpdated() calls will come no more often than this.

Specified by:

getMinTime in interface LayerThread.ViewWatcherInterface

getMaxLagTime

public float getMaxLagTime()

Description copied from interface: LayerThread.ViewWatcherInterface

How long the layer can go without a viewUpdated() call.

Specified by:

getMaxLagTime in interface LayerThread.ViewWatcherInterface