Singleton thread upon which all OpenGL work is performed by default. Unfortunately many vendors' OpenGL drivers are not really thread-safe and stability is much improved by performing OpenGL work on at most one thread. This is the default behavior of the GLAutoDrawable implementations according to the Threading class. The GLWorkerThread replaces the original AWT event queue thread-based mechanism for two reasons: first, more than one AWT event queue thread may be spawned, for example if a dialog is being shown; second, it avoids blocking the AWT event queue thread during OpenGL rendering.

Nested and Inner Type Summary

Modifier and Type	Class and Description
pack-priv static class	GLWorkerThread.WorkerRunnable

Field Summary

Modifier and Type	Field and Description
private static volatile Throwable	exception
private static Object	lock
private static List<Runnable>	queue
private static volatile boolean	shouldTerminate
private static volatile boolean	started
private static volatile Thread	thread
private static volatile Runnable	work

Access	Constructor and Description
public	GLWorkerThread()

Method Summary

Modifier and Type	Method and Description
protected static String	getThreadName()
public static void	invoke(final boolean wait, final Runnable runnable)
public static void	invokeAndWait(final Runnable runnable)
public static void	invokeLater(final Runnable runnable)
public static boolean	isStarted() Indicates whether the OpenGL worker thread was started, i.e., whether it is currently in use.
public static boolean	isWorkerThread() Indicates whether the current thread is the OpenGL worker thread.
public static void	start() Should only be called by Threading class if creation of the GLWorkerThread was requested via the opengl.1thread system property.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

exception	back to summary
private static volatile Throwable exception

lock	back to summary
private static Object lock

queue	back to summary
private static List<Runnable> queue

shouldTerminate	back to summary
private static volatile boolean shouldTerminate

started	back to summary
private static volatile boolean started

thread	back to summary
private static volatile Thread thread

work	back to summary
private static volatile Runnable work

GLWorkerThread	back to summary
public GLWorkerThread()

Method Detail

getThreadName	back to summary
protected static String getThreadName()

invoke	back to summary
public static void invoke(final boolean wait, final Runnable runnable) throws InvocationTargetException, InterruptedException

invokeAndWait	back to summary
public static void invokeAndWait(final Runnable runnable) throws InvocationTargetException, InterruptedException

invokeLater	back to summary
public static void invokeLater(final Runnable runnable)

isStarted	back to summary
public static boolean isStarted() Indicates whether the OpenGL worker thread was started, i.e., whether it is currently in use.

isWorkerThread	back to summary
public static boolean isWorkerThread() Indicates whether the current thread is the OpenGL worker thread.

start	back to summary
public static void start() Should only be called by Threading class if creation of the GLWorkerThread was requested via the opengl.1thread system property. Start the GLWorkerThread iff not started yet!