Added thrown exception information for GLDrawableFactory's

createGLPbuffer, createExternalGLContext and createExternalGLDrawable.

Fixed build breakage with last checkin.


git-svn-id: file:///usr/local/projects/SUN/JOGL/git-svn/svn-server-sync/jogl/trunk@480 232f8b59-042b-4e1e-8c03-345bb8c30851

1 files changed, 15 insertions, 3 deletions

diff --git a/src/classes/javax/media/opengl/GLDrawableFactory.java b/src/classes/javax/media/opengl/GLDrawableFactory.java
index 7f62e1af4..ded3a0304 100644
--- a/src/classes/javax/media/opengl/GLDrawableFactory.java
+++ b/src/classes/javax/media/opengl/GLDrawableFactory.java
@@ -187,12 +187,16 @@ public abstract class GLDrawableFactory {
 
   /**
    * Creates a GLPbuffer with the given capabilites and dimensions.
+   *
+   * @throws GLException if any window system-specific errors caused
+   *         the creation of the GLPbuffer to fail.
    */
   public abstract GLPbuffer createGLPbuffer(GLCapabilities capabilities,
                                             GLCapabilitiesChooser chooser,
                                             int initialWidth,
                                             int initialHeight,
-                                            GLContext shareWith);
+                                            GLContext shareWith)
+    throws GLException;
 
   //----------------------------------------------------------------------
   // Methods for interacting with third-party OpenGL libraries
@@ -215,8 +219,12 @@ public abstract class GLDrawableFactory {
    * the <code>GLContext</code>. A new <code>GLContext</code> object
    * should be created for each newly-created underlying OpenGL
    * context.
+   *
+   * @throws GLException if any window system-specific errors caused
+   *         the creation of the external GLContext to fail.
    */
-  public abstract GLContext createExternalGLContext();
+  public abstract GLContext createExternalGLContext()
+    throws GLException;
 
   /**
    * Returns true if it is possible to create an external GLDrawable
@@ -257,6 +265,10 @@ public abstract class GLDrawableFactory {
    * {@link #canCreateExternalGLDrawable} should be called first to
    * see if it is present. For example, on X11 platforms, this API
    * requires the presence of GLX 1.3 or later.
+   *
+   * @throws GLException if any window system-specific errors caused
+   *         the creation of the external GLDrawable to fail.
    */
-  public abstract GLDrawable createExternalGLDrawable();
+  public abstract GLDrawable createExternalGLDrawable()
+    throws GLException;
 }