diff options
author | Kenneth Russel <kbrussel@alum.mit.edu> | 2006-02-15 20:13:12 +0000 |
---|---|---|
committer | Kenneth Russel <kbrussel@alum.mit.edu> | 2006-02-15 20:13:12 +0000 |
commit | b5dd8c190c83e9b0059093eb01f60379b1bfe256 (patch) | |
tree | bd2a615b766ea9ddf8e08ebc1a12dfe87aefb7a1 /src/classes/javax/media | |
parent | bceb098ac0a594198301b35df7f0b14f532501e6 (diff) |
Added note on limitations of OpenGL context sharing to spec overview
and pointed to it from GLDrawableFactory, GLDrawable, GLCanvas and
GLJPanel
git-svn-id: file:///usr/local/projects/SUN/JOGL/git-svn/svn-server-sync/jogl/trunk@611 232f8b59-042b-4e1e-8c03-345bb8c30851
Diffstat (limited to 'src/classes/javax/media')
-rw-r--r-- | src/classes/javax/media/opengl/GLCanvas.java | 11 | ||||
-rw-r--r-- | src/classes/javax/media/opengl/GLDrawable.java | 6 | ||||
-rw-r--r-- | src/classes/javax/media/opengl/GLDrawableFactory.java | 5 | ||||
-rw-r--r-- | src/classes/javax/media/opengl/GLJPanel.java | 4 |
4 files changed, 18 insertions, 8 deletions
diff --git a/src/classes/javax/media/opengl/GLCanvas.java b/src/classes/javax/media/opengl/GLCanvas.java index b6c1ca0d0..0329e4017 100644 --- a/src/classes/javax/media/opengl/GLCanvas.java +++ b/src/classes/javax/media/opengl/GLCanvas.java @@ -90,10 +90,13 @@ public class GLCanvas extends Canvas implements GLAutoDrawable { is used if null is passed for this argument. The passed GLContext specifies an OpenGL context with which to share textures, display lists and other OpenGL state, and may be null - if sharing is not desired. The passed GraphicsDevice indicates - the screen on which to create the GLCanvas; the - GLDrawableFactory uses the default screen device of the local - GraphicsEnvironment if null is passed for this argument. */ + if sharing is not desired. See the note in the overview + documentation on <a + href="../../../overview-summary.html#SHARING">context + sharing</a>. The passed GraphicsDevice indicates the screen on + which to create the GLCanvas; the GLDrawableFactory uses the + default screen device of the local GraphicsEnvironment if null + is passed for this argument. */ public GLCanvas(GLCapabilities capabilities, GLCapabilitiesChooser chooser, GLContext shareWith, diff --git a/src/classes/javax/media/opengl/GLDrawable.java b/src/classes/javax/media/opengl/GLDrawable.java index a1780bd2a..13b905167 100644 --- a/src/classes/javax/media/opengl/GLDrawable.java +++ b/src/classes/javax/media/opengl/GLDrawable.java @@ -71,11 +71,13 @@ public interface GLDrawable { /** * Creates a new context for drawing to this drawable that will * optionally share display lists and other server-side OpenGL - * objects with the specified GLContext. + * objects with the specified GLContext. <P> * * The GLContext <code>share</code> need not be associated with this * GLDrawable and may be null if sharing of display lists and other - * objects is not desired. + * objects is not desired. See the note in the overview + * documentation on + * <a href="../../../overview-summary.html#SHARING">context sharing</a>. */ public GLContext createContext(GLContext shareWith); diff --git a/src/classes/javax/media/opengl/GLDrawableFactory.java b/src/classes/javax/media/opengl/GLDrawableFactory.java index ded3a0304..fd934195c 100644 --- a/src/classes/javax/media/opengl/GLDrawableFactory.java +++ b/src/classes/javax/media/opengl/GLDrawableFactory.java @@ -186,7 +186,10 @@ public abstract class GLDrawableFactory { public abstract boolean canCreateGLPbuffer(); /** - * Creates a GLPbuffer with the given capabilites and dimensions. + * Creates a GLPbuffer with the given capabilites and dimensions. <P> + * + * See the note in the overview documentation on + * <a href="../../../overview-summary.html#SHARING">context sharing</a>. * * @throws GLException if any window system-specific errors caused * the creation of the GLPbuffer to fail. diff --git a/src/classes/javax/media/opengl/GLJPanel.java b/src/classes/javax/media/opengl/GLJPanel.java index dbc5e432a..086e7c055 100644 --- a/src/classes/javax/media/opengl/GLJPanel.java +++ b/src/classes/javax/media/opengl/GLJPanel.java @@ -213,7 +213,9 @@ public class GLJPanel extends JPanel implements GLAutoDrawable { is used if null is passed for this argument. The passed GLContext specifies an OpenGL context with which to share textures, display lists and other OpenGL state, and may be null - if sharing is not desired. */ + if sharing is not desired. See the note in the overview documentation on + <a href="../../../overview-summary.html#SHARING">context sharing</a>. + */ public GLJPanel(GLCapabilities capabilities, GLCapabilitiesChooser chooser, GLContext shareWith) { super(); |