com.thekeirs.games.engine

Class GameViewThread

java.lang.Object

java.lang.Thread

com.thekeirs.games.engine.GameViewThread

All Implemented Interfaces:

java.lang.Runnable

public class GameViewThread
extends java.lang.Thread

[internal] This is the thread where all update() and draw() calls are done for every game object

It is prohibited to run CPU-intensive work on the UI Thread in Android, so we launch this separate thread whenever the UI is ready, and take it down any time the UI becomes un-ready.

The main Game Activity for the app is responsible for configuring this thread with a GameView.IGameLogicService and GameView.IRedrawService to pass along the actual update() and draw() calls.

Nested Class Summary

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

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

Field Summary

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Constructor and Description
GameViewThread(android.view.SurfaceHolder holder, GameView.IGameLogicService gameLogic, GameView.IRedrawService redrawService)

Method Summary

Modifier and Type	Method and Description
void	gracefulStop()
void	queueEvent(GameView.UIEvent e) UI Events arrive on the UI thread and must be handed off to the worker thread
void	run()
void	setEventScalingFactors(float xfactor, float yfactor) Set factors to normalize user input event coordinates into range 0.0-1.0

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

Constructor Detail

GameViewThread

public GameViewThread(android.view.SurfaceHolder holder,
                      GameView.IGameLogicService gameLogic,
                      GameView.IRedrawService redrawService)

Method Detail

setEventScalingFactors

public void setEventScalingFactors(float xfactor,
                                   float yfactor)

Set factors to normalize user input event coordinates into range 0.0-1.0

queueEvent

public void queueEvent(GameView.UIEvent e)

UI Events arrive on the UI thread and must be handed off to the worker thread

run

public void run()

Specified by:

run in interface java.lang.Runnable

Overrides:

run in class java.lang.Thread

gracefulStop

public void gracefulStop()