From cbf9a1b1a489cbc6b87815c590ce94869316fc5a Mon Sep 17 00:00:00 2001
From: ckline <ckline@dev.java.net>
Date: Sun, 22 Jun 2003 21:19:46 +0000
Subject: Merged code comments and some javadoc comments from old Jungle source
tree.
git-svn-id: file:///usr/local/projects/SUN/JOGL/git-svn/svn-server-sync/jogl/trunk@10 232f8b59-042b-4e1e-8c03-345bb8c30851
---
src/net/java/games/jogl/Animator.java | 19 +++++++++++++++++++
1 file changed, 19 insertions(+)
(limited to 'src/net/java/games/jogl')
diff --git a/src/net/java/games/jogl/Animator.java b/src/net/java/games/jogl/Animator.java
index d9f2c6729..d21d483e1 100644
--- a/src/net/java/games/jogl/Animator.java
+++ b/src/net/java/games/jogl/Animator.java
@@ -62,6 +62,7 @@ public class Animator {
private Thread thread;
private boolean shouldStop;
+ /** Creates a new Animator for a particular drawable. */
public Animator(GLDrawable drawable) {
this.drawable = drawable;
@@ -71,6 +72,7 @@ public class Animator {
}
}
+ /** Starts this animator. */
public synchronized void start() {
if (thread != null) {
throw new GLException("Already started");
@@ -78,8 +80,23 @@ public class Animator {
if (runnable == null) {
runnable = new Runnable() {
public void run() {
+ // Try to get OpenGL context optimization since we know we
+ // will be rendering this one drawable continually from
+ // this thread; make the context current once instead of
+ // making it current and freeing it each frame.
drawable.setRenderingThread(Thread.currentThread());
+
+ // Since setRenderingThread is currently advisory (because
+ // of the poor JAWT implementation in the Motif AWT, which
+ // performs excessive locking) we also prevent repaint(),
+ // which is called from the AWT thread, from having an
+ // effect for better multithreading behavior. This call is
+ // not strictly necessary, but if end users write their
+ // own animation loops which update multiple drawables per
+ // tick then it may be necessary to enforce the order of
+ // updates.
drawable.setNoAutoRedrawMode(true);
+
boolean noException = false;
try {
while (!shouldStop) {
@@ -108,6 +125,8 @@ public class Animator {
thread.start();
}
+ /** Stops this animator, blocking until the animation thread has
+ finished. */
public synchronized void stop() {
shouldStop = true;
while (shouldStop && thread != null) {
--
cgit v1.2.3