com.mousebird.maply

Class LayerThread

java.lang.Object

java.lang.Thread

android.os.HandlerThread

com.mousebird.maply.LayerThread

All Implemented Interfaces:

java.lang.Runnable

public class LayerThread
extends android.os.HandlerThread

The layer thread runs tasks we want off the UI thread, but still need some control over. The layer thread has some of its own state, including ChangeSets and similar objects.

When you call addTask on the MaplyController, the Runnable probably ends up here.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	LayerThread.ViewWatcherInterface Objects that want to be called when the view updates its position fill out this interface and register with the layer thread.

Nested classes/interfaces inherited from class java.lang.Thread

java.lang.Thread.State, java.lang.Thread.UncaughtExceptionHandler

Field Summary

Fields

Modifier and Type	Field and Description
protected ChangeSet	changes
RenderController	renderer
Scene	scene
static long	UpdatePeriod
View	view
protected boolean	viewUpdates

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Method Summary

Modifier and Type	Method and Description
void	addChanges(ChangeSet newChanges) Add a set of change requests to the scene.
android.os.Handler	addDelayedTask(java.lang.Runnable run, long time) Add a Runnable to the queue, but only execute after the given amount of time.
void	addLayer(Layer layer)
android.os.Handler	addTask(java.lang.Runnable run) Add a Runnable to our queue.
android.os.Handler	addTask(java.lang.Runnable run, boolean wait) Add a Runnable to this thread's queue.
void	addWatcher(LayerThread.ViewWatcherInterface watcher) Add an object that we'd like to track changes to the view as the user moves around.
void	removeLayer(Layer layer)
void	removeWatcher(LayerThread.ViewWatcherInterface watcher) Remove a view watcher that was added previously.
void	viewUpdated(View view)

Methods inherited from class android.os.HandlerThread

getLooper, getThreadId, onLooperPrepared, quit, quitSafely, run

Methods inherited from class java.lang.Thread

activeCount, checkAccess, clone, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, toString, yield

Methods inherited from class java.lang.Object

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

Field Detail

view

public View view

scene

public Scene scene

renderer

public RenderController renderer

viewUpdates

protected boolean viewUpdates

changes

protected ChangeSet changes

UpdatePeriod

public static long UpdatePeriod

Method Detail

addLayer

public void addLayer(Layer layer)

removeLayer

public void removeLayer(Layer layer)

addChanges

public void addChanges(ChangeSet newChanges)

Add a set of change requests to the scene.

Parameters:

newChanges - Change requests to process.

addTask

public android.os.Handler addTask(java.lang.Runnable run)

Add a Runnable to our queue. This will be executed at some point in the future.

Parameters:

run - Runnable to run

Returns:

The Handler if you want to cancel this at some point in the future.

addDelayedTask

public android.os.Handler addDelayedTask(java.lang.Runnable run,
                                         long time)

Add a Runnable to the queue, but only execute after the given amount of time.

Parameters:

run - Runnable to add to the queue

Returns:

The Handler if you want to cancel this at some point in the future.

addTask

public android.os.Handler addTask(java.lang.Runnable run,
                                  boolean wait)

Add a Runnable to this thread's queue. It will be executed at some point in the future.

Parameters:

run - Runnable to run

wait - If true we'll always put the Runnable in the queue. If false we'll see if we're already on the layer thread and just execute the runnable instead.

Returns:

Returns a Handler if you want to cancel the task later. Returns null if we were on the layer thread and no Handler was needed.

addWatcher

public void addWatcher(LayerThread.ViewWatcherInterface watcher)

Add an object that we'd like to track changes to the view as the user moves around. This is typically called by a Layer in the startLayer() call.

Parameters:

watcher - Watcher to add to the list.

removeWatcher

public void removeWatcher(LayerThread.ViewWatcherInterface watcher)

Remove a view watcher that was added previously. That object will no longer get view updates.

viewUpdated

public void viewUpdated(View view)