From 989a20559ebaa387f8f253c8415e41f6da925d82 Mon Sep 17 00:00:00 2001
From: Sven Gothel <sgothel@jausoft.com>
Date: Tue, 21 Mar 2023 09:42:49 +0100
Subject: GraphUI UISceneDemo*: Use lambdas for GLAutoDrawable.invoke(..) to
 reduce LOC

GLAutoDrawable.invoke(..) API doc: Add semantics about GLRunnable return value.
---
 src/jogl/classes/com/jogamp/opengl/GLAutoDrawable.java | 7 +++++++
 1 file changed, 7 insertions(+)

(limited to 'src/jogl/classes')

diff --git a/src/jogl/classes/com/jogamp/opengl/GLAutoDrawable.java b/src/jogl/classes/com/jogamp/opengl/GLAutoDrawable.java
index b9ed73650..a2a04f3fe 100644
--- a/src/jogl/classes/com/jogamp/opengl/GLAutoDrawable.java
+++ b/src/jogl/classes/com/jogamp/opengl/GLAutoDrawable.java
@@ -417,6 +417,13 @@ public interface GLAutoDrawable extends GLDrawable {
    * {@link GLEventListener#display(GLAutoDrawable) display(GLAutoDrawable)}
    * methods have been called.
    * <p>
+   * The given {@link GLRunnable#run(GLAutoDrawable)} shall return true to indicate
+   * that the GL [back] framebuffer remains intact by this runnable. <br/>
+   * If returning false {@link GLAutoDrawable} will call
+   * {@link GLEventListener#display(GLAutoDrawable) display(GLAutoDrawable)}
+   * of all registered {@link GLEventListener}s once more to reinstate the framebuffer.
+   * </p>
+   * <p>
    * If no {@link GLAnimatorControl} is animating (default),<br>
    * or if the current thread is the animator thread,<br>
    * a {@link #display()} call is issued after enqueue the <code>GLRunnable</code>,
-- 
cgit v1.2.3