summaryrefslogtreecommitdiffstats
path: root/src/classes/javax/media
diff options
context:
space:
mode:
authorKenneth Russel <kbrussel@alum.mit.edu>2006-02-15 20:13:12 +0000
committerKenneth Russel <kbrussel@alum.mit.edu>2006-02-15 20:13:12 +0000
commitb5dd8c190c83e9b0059093eb01f60379b1bfe256 (patch)
treebd2a615b766ea9ddf8e08ebc1a12dfe87aefb7a1 /src/classes/javax/media
parentbceb098ac0a594198301b35df7f0b14f532501e6 (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.java11
-rw-r--r--src/classes/javax/media/opengl/GLDrawable.java6
-rw-r--r--src/classes/javax/media/opengl/GLDrawableFactory.java5
-rw-r--r--src/classes/javax/media/opengl/GLJPanel.java4
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();