diff options
| author | gfxadmin <[email protected]> | 2006-02-10 01:21:10 +0000 |
|---|---|---|
| committer | gfxadmin <[email protected]> | 2006-02-10 01:21:10 +0000 |
| commit | a9e4c4d1b136ac13ab5f1aff33c81f4306636e2a (patch) | |
| tree | eca657a5d5823dabd311db725c7022c06c836916 /make | |
| parent | d2b9ef0612d278ad1fb8ca4501ee028004c53dc3 (diff) | |
Issue number:
Obtained from:
Submitted by: Travis
Reviewed by:
These are all documentation changes in preparation for the Proposed Final
Draft submission.
Carefully separated out references to the implementation from the
specification. Did not delete any comments, just made sure that it was
clear when it was the Reference Implementation being referred to.
Add note to Spec Overview about version information. We now include
version information in the manifest of the jar file and we require
this of all implementations. This is currently done automatically
as part of the build process and is easy to access at runtime with
the java.lang.Package APIs.
git-svn-id: file:///usr/local/projects/SUN/JOGL/git-svn/svn-server-sync/jogl/trunk@592 232f8b59-042b-4e1e-8c03-345bb8c30851
Diffstat (limited to 'make')
| -rw-r--r-- | make/glu-common.cfg | 6 | ||||
| -rw-r--r-- | make/spec-overview.html | 518 |
2 files changed, 272 insertions, 252 deletions
diff --git a/make/glu-common.cfg b/make/glu-common.cfg index f99e874ca..5a0f06fa1 100644 --- a/make/glu-common.cfg +++ b/make/glu-common.cfg @@ -70,10 +70,12 @@ Ignore GLU_EXT_.+ ClassJavadoc GLU /** ClassJavadoc GLU * Provides access to the OpenGL Utility Library (GLU). This library ClassJavadoc GLU * provides standard methods for setting up view volumes, building -ClassJavadoc GLU * mipmaps and performing other common operations. -ClassJavadoc GLU * +ClassJavadoc GLU * mipmaps and performing other common operations. The GLU NURBS +ClassJavadoc GLU * routines are not currently exposed. +ClassJavadoc GLU * ClassJavadoc GLU * <P> ClassJavadoc GLU * +ClassJavadoc GLU * Notes from the Reference Implementation for this class: ClassJavadoc GLU * Thanks to the contributions of many individuals, this class is a ClassJavadoc GLU * pure Java port of SGI's original C sources. All of the projection, ClassJavadoc GLU * mipmap, scaling, and tessellation routines that are exposed are diff --git a/make/spec-overview.html b/make/spec-overview.html index fdeb972c2..c8c45142a 100644 --- a/make/spec-overview.html +++ b/make/spec-overview.html @@ -4,329 +4,347 @@ <title>JSR 231 Draft Public Review Specification</title> </head> <body> - + <h2>JSR 231 Specification Overview</h2> - + <h3>Preface</h3> - This specification, an optional set of packages, describes the Java(TM) bindings -to the native 3D graphics library, OpenGL(R).<br> - <br> - + This specification, an optional set of packages, describes the Java(TM) +bindings to the native 3D graphics library, OpenGL(R).<br> + <br> + <h3>Package Structure</h3> - The packages defined by this specification include:<br> - + The packages defined by this specification include:<br> + <ul> - <li> + <li> <p>The javax.media.opengl package<br> - <br> - This package contains Java bindings for all core OpenGL methods through version -2.0, inclusive, as well as most OpenGL extensions defined at the time of -this specification. Early OpenGL extensions whose functionality was incorporated -into core OpenGL by version 1.3, inclusive, are specifically excluded.</p> - </li> - <li>The javax.media.opengl.glu package</li> - <br> - This package contains bindings for the OpenGL Graphics System Utility (GLU) -Library version 1.3, inclusive, with the exception of the GLU NURBS routines + <br> + This package contains Java bindings for all core OpenGL methods through +version 2.0, inclusive, as well as most OpenGL extensions defined at the +time of this specification. Early OpenGL extensions whose functionality +was incorporated into core OpenGL by version 1.3, inclusive, are specifically +excluded.</p> + </li> + <li>The javax.media.opengl.glu package</li> + <br> + This package contains bindings for the OpenGL Graphics System Utility (GLU) +Library version 1.3, inclusive, with the exception of the GLU NURBS routines which are not exposed.<br> - <br> - + <br> + </ul> - + <h3>API Binding Conventions</h3> - The Java language bindings to the pre-existing C APIs in these packages have -been created using a consistent set of rules. Vendor-defined extensions should -make use of the same rules in order to provide a consistent developer experience.<br> - <br> - The rules for creating the Java language binding are described in the following -sections. These rules should be followed as closely as possible for all future + The Java language bindings to the pre-existing C APIs in these packages +have been created using a consistent set of rules. Vendor-defined extensions +should make use of the same rules in order to provide a consistent developer +experience.<br> + <br> + The rules for creating the Java language binding are described in the following +sections. These rules should be followed as closely as possible for all future APIs that share the javax.media.opengl namespace.<br> - + <h4>Function Naming</h4> - Functions are named in the same way as in the C binding. That is, an OpenGL -API function glClear is bound to Java method GL.glClear. Although it would -be possible to drop the gl prefix (since it is redundant with the interface -name GL), the resulting code was deemed to look too foreign to experienced -OpenGL developers. For the same reason, we have also carried over all type + Functions are named in the same way as in the C binding. That is, an OpenGL +API function glClear is bound to Java method GL.glClear. Although it would +be possible to drop the gl prefix (since it is redundant with the interface +name GL), the resulting code was deemed to look too foreign to experienced +OpenGL developers. For the same reason, we have also carried over all type suffixes like 3f and 3fv from methods such as glColor3f and glColor3fv, respectively.<br> - <br> - Extension suffixes, such as EXT, ARB, and vendor-specific suffixes, are retained -so as to match C conventions.<br> - + <br> + Extension suffixes, such as EXT, ARB, and vendor-specific suffixes, are +retained so as to match C conventions.<br> + <h4>Mapping of Constants</h4> - Constants are named in the same way as in the C binding. For instance, the -OpenGL constant GL_RGB is bound to Java constant GL.GL_RGB.<br> - + Constants are named in the same way as in the C binding. For instance, +the OpenGL constant GL_RGB is bound to Java constant GL.GL_RGB.<br> + <h4>Mapping of Primitive Types</h4> - All 8-bit integral types become byte, all 16-bit integral types become short, -and all 32-bit integral types become int. All 32-bit floating-point types -become float and all 64-bit floating-point types become double.<br> - <br> - Integer return values that can only be GL_TRUE or GL_FALSE are mapped to + All 8-bit integral types become byte, all 16-bit integral types become +short, and all 32-bit integral types become int. All 32-bit floating-point +types become float and all 64-bit floating-point types become double.<br> + <br> + Integer return values that can only be GL_TRUE or GL_FALSE are mapped to boolean.<br> -<h4>Mapping of Pointer Arguments</h4> - OpenGL functions that take pointer arguments fall into several categories:<br> +<h4>Mapping of Pointer Arguments</h4> + OpenGL functions that take pointer arguments fall into several categories:<br> + <ul> - <li>Functions that take an untyped pointer argument for immediate use</li> - <li>Functions that take a typed pointer argument for immediate use</li> - <li>Functions that take an untyped pointer argument for deferred use</li> - <li>Functions that take a typed pointer argument for deferred use<br> - </li> - + <li>Functions that take an untyped pointer argument for immediate use</li> + <li>Functions that take a typed pointer argument for immediate use</li> + <li>Functions that take an untyped pointer argument for deferred use</li> + <li>Functions that take a typed pointer argument for deferred use<br> + </li> + </ul> - Functions that take an untyped (void*) pointer argument for immediate use -are given a single binding that takes a New I/O (NIO) Buffer object. The -Buffer may be of any type allowable by the function (and compatible with -the other arguments to the function) and may be direct or indirect. An example -of an OpenGL API in this category is glTexImage2D.<br> - <br> - Functions that take a typed pointer (e.g., GLfloat *) argument for immediate -use are given two bindings. The first takes a Java primitive array with a -type that matches the C pointer type (i.e., GLfloat* maps to float[]). The -second takes a typed Buffer object (i.e., GLfloat* maps to FloatBuffer). - An example of an OpenGL API in this category is glColor3fv.<br> - <br> - Functions that take an untyped (void*) pointer argument for deferred use -are given a single binding that takes a Buffer object. The Buffer may be -of any type allowable by the function (and compatible with the other arguments -to the function), but must be direct. That is, it may not have been created -from a Java primitive array using the wrap method. The functions that fall -into this category generally have names ending with the suffix "pointer." -An example of an OpenGL API in this category is glVertexPointer. Because -these functions do not consume the data located at the given pointer immediately, -but only at some unspecified later time, it is not possible to use a Java + Functions that take an untyped (void*) pointer argument for immediate use +are given a single binding that takes a New I/O (NIO) Buffer object. The Buffer +may be of any type allowable by the function (and compatible with the other +arguments to the function) and may be direct or indirect. An example of +an OpenGL API in this category is glTexImage2D.<br> + <br> + Functions that take a typed pointer (e.g., GLfloat *) argument for immediate +use are given two bindings. The first takes a Java primitive array with a +type that matches the C pointer type (i.e., GLfloat* maps to float[]). The +second takes a typed Buffer object (i.e., GLfloat* maps to FloatBuffer). +An example of an OpenGL API in this category is glColor3fv.<br> + <br> + Functions that take an untyped (void*) pointer argument for deferred use +are given a single binding that takes a Buffer object. The Buffer may be of +any type allowable by the function (and compatible with the other arguments +to the function), but must be direct. That is, it may not have been created +from a Java primitive array using the wrap method. The functions that fall +into this category generally have names ending with the suffix "pointer." +An example of an OpenGL API in this category is glVertexPointer. Because these +functions do not consume the data located at the given pointer immediately, +but only at some unspecified later time, it is not possible to use a Java primitive array whose memory location may change.<br> - <br> - Functions that take a typed (e.g., GLfloat*) pointer argument for deferred -use are given a single binding that takes a typed Buffer object (i.e., GLfloat* -maps to FloatBuffer). The Buffer must be direct. That is, it may not have -been created from a Java primitive array using the wrap method. An example + <br> + Functions that take a typed (e.g., GLfloat*) pointer argument for deferred +use are given a single binding that takes a typed Buffer object (i.e., GLfloat* +maps to FloatBuffer). The Buffer must be direct. That is, it may not have +been created from a Java primitive array using the wrap method. An example of an OpenGL API in this category is glFeedbackBuffer.<br> + <br> + Methods that read or write a specific number of values from an array or +Buffer argument do not read or write any subsequent elements of the array +or Buffer.<br> <br> - Methods that read or write a specific number of values from an array or Buffer -argument do not read or write any subsequent elements of the array or Buffer.<br> -<br> -An outgoing C char* pointer, if representing a null-terminated, read-only C string, maps to a Java String. An outgoing C char** pointer, if similarly representing an array of read-only C strings, maps to a Java String[] (array of String objects). All other char* pointers, including those representing mutable C strings as used in some Get methods, are mapped to byte[] and ByteBuffer. -<br> - + An outgoing C char* pointer, if representing a null-terminated, read-only +C string, maps to a Java String. An outgoing C char** pointer, if similarly +representing an array of read-only C strings, maps to a Java String[] (array +of String objects). All other char* pointers, including those representing +mutable C strings as used in some Get methods, are mapped to byte[] and ByteBuffer. + <br> + <h4>Index Parameter for Arrays</h4> - Each C method argument that is mapped to a primitive array in Java is actually -mapped to two separate parameters: the appropriate primitive array type in -Java and an integer offset parameter. The value of the integer offset is -the index which the method will start reading from within the array. Earlier -indices will be ignored. This mapping provides more congruity with existing -Java APIs and allows reuse of a single array across multiple Java method -calls by changing the index in much the same way that C pointers permit for -C arrays.<br> - + Each C method argument that is mapped to a primitive array in Java is actually +mapped to two separate parameters: the appropriate primitive array type in +Java and an integer offset parameter. The value of the integer offset is +the index which the method will start reading from within the array. Earlier +indices will be ignored. This mapping provides more congruity with existing +Java APIs and allows reuse of a single array across multiple Java method calls +by changing the index in much the same way that C pointers permit for C arrays.<br> + <h4>Reduction of Method Explosions</h4> - Since there are two ways to expand a given C method pointer parameter, it -would be possible for C methods with multiple pointer arguments to expand -to many Java methods if one was to consider every possible combination of -mappings (the C method would expand to the number of pointer parameters to -the power of 2). In order to avoid an API explosion, we restrict a given -Java method to like kind mappings only. In other words, a given C method -with N typed pointer parameters for immediate use, where N >= 1, will -map to exactly two Java methods: One with all primitive arrays and one with -all Buffer types.<br> - <br> - Also, methods that accept multiple Buffer arguments require all direct or -all non-direct Buffers. Direct and non-direct buffers should never be mixed -within an API call by an application.<br> - + Since there are two ways to expand a given C method pointer parameter, +it would be possible for C methods with multiple pointer arguments to expand +to many Java methods if one was to consider every possible combination of +mappings (the C method would expand to the number of pointer parameters to +the power of 2). In order to avoid an API explosion, we restrict a given +Java method to like kind mappings only. In other words, a given C method +with N typed pointer parameters for immediate use, where N >= 1, will map +to exactly two Java methods: One with all primitive arrays and one with all +Buffer types.<br> + <br> + Also, methods that accept multiple Buffer arguments require all direct +or all non-direct Buffers. Direct and non-direct buffers should never be +mixed within an API call by an application.<br> + <h4>Byte ordering of Buffers</h4> - When allocating a New I/O Buffer (in particular, a direct ByteBuffer) -to be passed to the APIs in these packages, it is essential to set the -<em>byte ordering</em> of the newly-allocated ByteBuffer to the -<em>native</em> byte ordering of the platform: -e.g. <code>ByteBuffer.allocateDirect(...).order(ByteOrder.nativeOrder());</code>. -The byte order of the ByteBuffer indicates how multi-byte values such -as int and float are stored in the Buffer either using methods like -putInt and putFloat or views such as IntBuffer or FloatBuffer. The -Java bindings perform no conversion or byte swapping on the outgoing -data to OpenGL, and the native OpenGL implementation expects data in -the host CPU's byte order, so it is essential to always match the byte -order of the underlying platform when filling Buffers with data. <br> - + When allocating a New I/O Buffer (in particular, a direct ByteBuffer) to +be passed to the APIs in these packages, it is essential to set the <em>byte +ordering</em> of the newly-allocated ByteBuffer to the <em>native</em> byte +ordering of the platform: e.g. <code>ByteBuffer.allocateDirect(...).order(ByteOrder.nativeOrder());</code>. +The byte order of the ByteBuffer indicates how multi-byte values such as +int and float are stored in the Buffer either using methods like putInt and +putFloat or views such as IntBuffer or FloatBuffer. The Java bindings perform +no conversion or byte swapping on the outgoing data to OpenGL, and the native +OpenGL implementation expects data in the host CPU's byte order, so it is +essential to always match the byte order of the underlying platform when +filling Buffers with data. <br> + <h4>Auto-slicing of Buffers</h4> - When a Buffer object is passed to an OpenGL function binding, the actual -pointer argument that is passed down to the OpenGL C implementation is equal -to the starting pointer of the Buffer data, plus an offset given by the Buffer.position() -function, multiplied by the data type size in bytes (1 for a ByteBuffer, -2 for a ShortBuffer, 4 for a IntBuffer or FloatBuffer, and 8 for DoubleBuffer). - The array offset given by Buffer<type>.arrayOffset() is also added + When a Buffer object is passed to an OpenGL function binding, the actual +pointer argument that is passed down to the OpenGL C implementation is equal +to the starting pointer of the Buffer data, plus an offset given by the Buffer.position() +function, multiplied by the data type size in bytes (1 for a ByteBuffer, 2 +for a ShortBuffer, 4 for a IntBuffer or FloatBuffer, and 8 for DoubleBuffer). + The array offset given by Buffer<type>.arrayOffset() is also added in the offset for wrapped arrays.<br> - <br> - This feature is known as "auto-slicing," as it mimics the effect of calling + <br> + This feature is known as "auto-slicing," as it mimics the effect of calling slice() on the Buffer object without the overhead of explicit object creation.<br> - + <h4>Errors and Exceptions</h4> - For performance reasons, OpenGL functions do not return error values directly. -Instead, applications must query for errors using functions such as glGetError. -This behavior is largely preserved in the Java language bindings, as described + For performance reasons, OpenGL functions do not return error values directly. +Instead, applications must query for errors using functions such as glGetError. +This behavior is largely preserved in the Java language bindings, as described below.<br> - <br> - In the interest of efficiency, the Java API does not generally throw exceptions. - However, running an application with the DebugGL composable pipeline, which -is part of the API, will force an exception to be thrown at the point of -failure.<br> - <br> - Many errors are defined by OpenGL merely to set the error code, rather than -throwing an exception. For example, passing a bad enumerated parameter value -may result in the error flag being set to GL.GL_INVALID_VALUE. Attempting -to check for such errors in the binding layer would require either replicating -the error-checking logic of the underlying engine, or querying the error -state after every function. This would greatly impact performance by inhibiting + <br> + In the interest of efficiency, the Java API does not generally throw exceptions. + However, running an application with the DebugGL composable pipeline, which +is part of the API, will force an exception to be thrown at the point of failure.<br> + <br> + Many errors are defined by OpenGL merely to set the error code, rather +than throwing an exception. For example, passing a bad enumerated parameter +value may result in the error flag being set to GL.GL_INVALID_VALUE. Attempting +to check for such errors in the binding layer would require either replicating +the error-checking logic of the underlying engine, or querying the error state +after every function. This would greatly impact performance by inhibiting the ability of the hardware to pipeline work.<br> - + <h4>Security</h4> - Exception behavior is defined in cases that could otherwise lead to illegal -memory accesses in the underlying OpenGL engine. Implementations should take -necessary steps to prevent the GL from accessing or overwriting memory except + Exception behavior is defined in cases that could otherwise lead to illegal +memory accesses in the underlying OpenGL engine. Implementations should take +necessary steps to prevent the GL from accessing or overwriting memory except for properly allocated Buffers and array method arguments.<br> - <br> - An implementation should take care to validate arguments correctly before -invoking native methods that could potentially access memory illegally. In -particular, methods that validate the contents of an array (such as a list -of GL attributes) or a Buffer should take precautions against exploits in -which a separate thread attempts to alter the contents of the argument during -the time interval following validation but preceding passage of the argument + <br> + An implementation should take care to validate arguments correctly before +invoking native methods that could potentially access memory illegally. In +particular, methods that validate the contents of an array (such as a list +of GL attributes) or a Buffer should take precautions against exploits in +which a separate thread attempts to alter the contents of the argument during +the time interval following validation but preceding passage of the argument to the underlying native engine.<br> - + <h3>Criteria Used for Inclusion of APIs into the Java Bindings</h3> - + <h4>OpenGL API Inclusion Criteria</h4> - OpenGL functions and OpenGL extensions have been included in the Java bindings + OpenGL functions and OpenGL extensions have been included in the Java bindings according the following rules: <br> + <ul> - <li>All functions in core OpenGL 2.0, inclusive, have been included.</li> - <li>If the functionality of the OpenGL extension was subsumed into core + <li>All functions in core OpenGL 2.0, inclusive, have been included.</li> + <li>If the functionality of the OpenGL extension was subsumed into core OpenGL by version 1.3, then the extension was dropped from the Java bindings.</li> - <li>Functions that deal with explicit pointer values in such a way that -they cannot be properly implemented in Java have been excluded. This -includes retrieval methods with a C void ** in the OpenGL signature like -glGetBufferPointerv, glGetPointerv, glGetVertexAttribPointerv, as well as -functions that require persistent pointer to pointer storage across function -calls like vertex array lists.</li> - <li>If the extension is registered in the official OpenGL extension registry -but the specification was never completed or was discontinued (as indicated -in the specification and/or lack of inclusion in SGI's official OpenGL header -files), then the extension was not included. Using these criteria, -ARB extensions through number 42 (GL_ARB_pixel_buffer_object), inclusive, -and non-ARB extensions through number 311 (GL_REMEDY_string_marker), inclusive, -have been included in the Java bindings according to the numbering scheme + <li>Functions that deal with explicit pointer values in such a way that +they cannot be properly implemented in Java have been excluded. This +includes retrieval methods with a C void ** in the OpenGL signature like glGetBufferPointerv, +glGetPointerv, glGetVertexAttribPointerv, as well as functions that require +persistent pointer to pointer storage across function calls like vertex array +lists.</li> + <li>If the extension is registered in the official OpenGL extension registry +but the specification was never completed or was discontinued (as indicated +in the specification and/or lack of inclusion in SGI's official OpenGL header +files), then the extension was not included. Using these criteria, ARB +extensions through number 42 (GL_ARB_pixel_buffer_object), inclusive, and +non-ARB extensions through number 311 (GL_REMEDY_string_marker), inclusive, +have been included in the Java bindings according to the numbering scheme found in the official OpenGL extension registry.</li> - <li>Some bindings to several vendor-specific extensions have been included -that are not found in the OpenGL extension registry. These extensions + <li>Some bindings to several vendor-specific extensions have been included +that are not found in the OpenGL extension registry. These extensions were deemed popular enough and/or were specifically requested by users.</li> - <li>Platform-specific extensions, such as those that begin with WGL, GLX, -CGL, etc., have been excluded from the public API. See the section -"Accessing platform-specific extensions" for more information about accessing -these functions on certain implementations.<br> - </li> -</ul> + <li>Platform-specific extensions, such as those that begin with WGL, GLX, +CGL, etc., have been excluded from the public API. See the section "Accessing +platform-specific extensions" for more information about accessing these +functions on certain implementations.<br> + </li> +</ul> + <h4>OpenGL GLU API Inclusion Criteria</h4> -Bindings for all core GLU APIs have been included with the exception of the -GLU NURBS APIs. These APIs may be included in a future maintenance + Bindings for all core GLU APIs have been included with the exception of +the GLU NURBS APIs. These APIs may be included in a future maintenance release of the Java bindings.<br> -<h3>OpenGL Extensions</h3> +<h3>OpenGL Extensions</h3> + <h4>Creating New Extensions</h4> -While the Java APIs for OpenGL extensions are unconditionally exposed, the -underlying functions may not be present. A program can query whether a potentially -unavailable function is actually available at runtime by using the method + While the Java APIs for OpenGL extensions are unconditionally exposed, the +underlying functions may not be present. A program can query whether a potentially +unavailable function is actually available at runtime by using the method GL.isFunctionAvailable.<br> - <br> - Bindings for OpenGL extensions not covered in this specification may be supplied -by individual vendors or groups. Such bindings may be considered for inclusion -in a future version of the JSR. In order to avoid fragmentation, vendors -creating extension bindings should expose new extensions using the method -GL.getExtension. This method is intended to provide a mechanism for vendors -who wish to provide access to new OpenGL extensions without changing the -public API of the core package. <br> - <br> - Names for added extension methods and extension-defined constants and Java -bindings for C parameters should follow the guidelines set forth in this -specfication.<br> + <br> + Bindings for OpenGL extensions not covered in this specification may be +supplied by individual vendors or groups. Such bindings may be considered +for inclusion in a future version of the JSR. In order to avoid fragmentation, +vendors creating extension bindings should expose new extensions using the +method GL.getExtension. This method is intended to provide a mechanism for +vendors who wish to provide access to new OpenGL extensions without changing +the public API of the core package. <br> + <br> + Names for added extension methods and extension-defined constants and Java +bindings for C parameters should follow the guidelines set forth in this specfication.<br> + <h4>Accessing Platform-Specific Extensions</h4> -Platform-specific extensions such as those that begin with WGL, GLX, CGL, -etc. are not included in the API. Each implementation can choose to -export all, some, or none of these APIs via the GL.getPlatformGLExtensions -API which returns an Object whose underlying data type is specific to a given + Platform-specific extensions such as those that begin with WGL, GLX, CGL, +etc. are not included in the API. Each implementation can choose to +export all, some, or none of these APIs via the GL.getPlatformGLExtensions +API which returns an Object whose underlying data type is specific to a given implementation.<br> - + <br> -Therefore, any usage of these APIs is both platform and implementation specific.<br> + Therefore, any usage of these APIs is both platform and implementation specific.<br> + <h3>OpenGL Version on Runtime System</h3> -Even though OpenGL extensions whose functionality was included into core -OpenGL by version 1.3, inclusive, are not included in the bindings, it should -be noted that OpenGL version 1.3 is not an absolute requirement on the runtime -system. This is because a user could query whether any particular function -is available before calling certain core APIs that might not be present. -However, in general, it is reasonable to expect at least OpenGL 1.3 to be -installed on the runtime system and an implementor of the API is free to -require the presence of at least OpenGL 1.3 on the target system.<br> - + Even though OpenGL extensions whose functionality was included into core +OpenGL by version 1.3, inclusive, are not included in the bindings, it should +be noted that OpenGL version 1.3 is not an absolute requirement on the runtime +system. This is because a user could query whether any particular function +is available before calling certain core APIs that might not be present. +However, in general, it is reasonable to expect at least OpenGL 1.3 to be +installed on the runtime system and an implementor of the API is free to require +the presence of at least OpenGL 1.3 on the target system.<br> + <br> -In future revisions of the API, this minimum standard may be raised.<br> + In future revisions of the API, this minimum standard may be raised.<br> + +<h3>Runtime Version Information</h3> +Any Java Bindings for OpenGL implementation should include version information +in its jar manifest file. This information can then easily be accessed +at runtime via the java.lang.Package API. At least the following information +is included in the Reference Implementation jar file manifest: Specification +Title, Specification Vendor, Specification Version, Implementation Vendor, +and Implementation Version.<br> <h3>Future Maintenance Updates</h3> -New core APIs found in future versions of OpenGL, as well as new OpenGL extensions, -are expected to be added to the bindings and included into the javax.media.opengl -namespace via future maintenance updates to the API.<br> - + New core APIs found in future versions of OpenGL, as well as new OpenGL +extensions, are expected to be added to the bindings and included into the +javax.media.opengl namespace via future maintenance updates to the API.<br> + <h3>Related Links</h3> - + <ul> - <li> JSR 231 JCP Web Page</li> - + <li> JSR 231 JCP Web Page</li> + </ul> - + <blockquote><a href="http://www.jcp.org/en/jsr/detail?id=231"> http://www.jcp.org/en/jsr/detail?id=231</a></blockquote> - + <ul> - <li>OpenGL 2.0 Specification</li> - + <li>OpenGL 2.0 Specification</li> + </ul> - + <blockquote><a - href="http://www.opengl.org/documentation/specs/version2.0/glspec20.pdf"> + href="http://www.opengl.org/documentation/specs/version2.0/glspec20.pdf"> http://www.opengl.org/documentation/specs/version2.0/glspec20.pdf</a></blockquote> - + <ul> - <li> OpenGL Extension Registry</li> - + <li> OpenGL Extension Registry</li> + </ul> - + <blockquote><a href="http://oss.sgi.com/projects/ogl-sample/registry/index.html"> http://oss.sgi.com/projects/ogl-sample/registry/index.html</a></blockquote> - + <pre></pre> - + <ul> - <li>OpenGL Utility Library: GLU 1.3 Specificiation</li> - + <li>OpenGL Utility Library: GLU 1.3 Specificiation</li> + </ul> - + <blockquote><a href="http://www.opengl.org/documentation/specs/glu/glu1_3.pdf"> http://www.opengl.org/documentation/specs/glu/glu1_3.pdf</a></blockquote> - + <ul> - <li>OpenGL ARB Web site</li> - + <li>OpenGL ARB Web site</li> + </ul> - + <blockquote><a href="http://www.opengl.org/about/arb/index.html"> http://www.opengl.org/about/arb/index.html</a></blockquote> - + <h3><br> - </h3> - + </h3> + <h3>Revision History<br> - </h3> - -<pre>Early Draft Review, October/November 2005<br><br>Public Review, December/January 2005 <br></pre> - <br> + </h3> + +<pre>Early Draft Review, October/November 2005<br><br>Public Review, December/January 2005 <br><br>Proposed Final Draft Review, February/March 2006<br></pre> + <br> + <br> <br> </body> </html> |