Java Bindings for OpenGL: Difference between revisions

Revision as of 15:09, 2 August 2010

Latest revision as of 00:14, 3 March 2025

(20 intermediate revisions by 13 users not shown)

Line 1:

{{norefrefimprove|date=August 2010}}

{{examplefarmexample farm|date=August 2010}}

{{Use mdy dates|date=March 2025}}

'''Java Binding for the OpenGL API''' is a [[Java Community Process|JSR]] [[API]] specification (JSR 231) for the [[Java SEPlatform, Standard Edition]] platform which allows to use [[OpenGL]] <ref>All functions in core OpenGL 2.0 have been included.</ref> on the [[Java Platform]]. There is also '''Java Binding for the OpenGL ES API''' (JSRsoftware 239platform) for the [[Java ME]] platform.<ref>{{cite web

| url=http://jcp.org/en/jsr/detail?id=231

| title=JSR 231: JavaBinding for the OpenGL API

| publisher=[[Java Community Process]]

| accessdate=February 6, 2011}}</ref> There is also '''Java Binding for the OpenGL ES API''' (JSR 239) for the [[Java Platform, Micro Edition]].

== Programming concepts ==

Core OpenGL API and [[OpenGL Utility Library|GLU]] library calls are available from [[Java (programming language)|Java]] through a thin wrapper looking very much as the original OpenGL [[C (programming language)|C]] API, <ref>Except GLU [[Nonuniform rational B-spline|NURBS]] routines which are not exposed through the public API.</ref>.

All platform specific libraries (available from the [[Core OpenGL|CGL]] API for [[Mac OS X]], [[GLX]] for [[X Window System]], and [[WiggleWin32WGL (software)|WGL]] for [[Microsoft Windows]]) are also abstracted out to create a platform independent way of selecting [[Framebuffer]] attributes and performing platform specific Framebuffer operations<ref>Platform-specific extensions are not included in the public API. Each implementation can choose to export some of these APIs via the [http://download.java.net/media/jogl/builds/nightly/javadoc_public/javax/media/opengl/GL.html#getPlatformGLExtensions() GL.getPlatformGLExtensions()] and [http://download.java.net/media/jogl/builds/nightly/javadoc_public/javax/media/opengl/GL.html#getExtension() GL.getExtension(String)] method calls which return Objects whose data types are specific to the given implementation.</ref>.

Platform-specific extensions are not included in the public API. Each implementation can choose to export some of these APIs via the [http://jogamp.org/deployment/jogamp-next/javadoc/jogl/javadoc/javax/media/opengl/GLBase.html#getPlatformGLExtensions%28%29 GL.getPlatformGLExtensions()] {{Webarchive|url=https://web.archive.org/web/20110217002436/http://jogamp.org/deployment/jogamp-next/javadoc/jogl/javadoc/javax/media/opengl/GLBase.html#getPlatformGLExtensions%28%29 |date=February 17, 2011 }} and [http://jogamp.org/deployment/jogamp-next/javadoc/jogl/javadoc/javax/media/opengl/GLBase.html#getExtension%28java.lang.String%29 GL.getExtension(String)] {{Webarchive|url=https://web.archive.org/web/20110217002436/http://jogamp.org/deployment/jogamp-next/javadoc/jogl/javadoc/javax/media/opengl/GLBase.html#getExtension%28java.lang.String%29 |date=February 17, 2011 }} method calls which return Objects whose data types are specific to the given implementation.

==Example==

This examplesexample shows how to draw a polygon (without initialization or repaint code) .<ref>Borrowed from the [http://nehe.gamedev.net/lesson.asp?index=01 Nehe tutorial] {{Webarchive|url=https://web.archive.org/web/20070406193934/http://nehe.gamedev.net/lesson.asp?index=01 |date=April 6, 2007 }}, whose code is free to use elsewhere.</ref>. Here is the reference [[C (programming language)|C]] implementation:

<sourcesyntaxhighlight lang="c">

int DrawGLScene(GLvoid) {

glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT);

Line 30 ⟶ 37:

return TRUE;

}

</syntaxhighlight>

</source>

Which translates to the following [[Java (programming language)|Java]] implementation:

<sourcesyntaxhighlight lang="java">

public void display(GLAutoDrawable gLDrawableglDrawable) {

final GL gl = gLDrawableglDrawable.getGL();

gl.glClear(GL.GL_COLOR_BUFFER_BIT | GL.GL_DEPTH_BUFFER_BIT);

gl.glLoadIdentity();

Line 53 ⟶ 60:

gl.glFlush();

}

</syntaxhighlight>

</source>

== Implementations ==

*[[Java OpenGL]] : The reference implementation, available on [[Microsoft Windows]], [[Linux]], [[Mac OS X]], and [[Solaris (operating system)|Solaris]] platforms.<ref>{{cite web

| url=http://jcp.org/aboutJava/communityprocess/final/jsr231/index.html

| title=JSR-000231 Java Bindings for the OpenGL API

== References ==

| publisher=[[Java Community Process]]

<references/>

| quote=''In order to facilitate maximum community participation for the Java Binding for the OpenGL API, we use the JOGL project on java.net found at jogl.dev.java.net. The JOGL source code can be found there, licensed under a liberal source code license (mostly licensed as BSD except where we use other parties' licensed code). We take a snapshot of the code from this project every few months, run the Technology Compatibility Kit on the source code, and then officially make it the Reference Implementation for each formal Java Binding for the OpenGL API release.''

| accessdate=February 6, 2011}}</ref>

== See also ==

*[[OpenGL]]

*[[Java Community Process]]

== References ==

{{Reflist}}

== External links ==

* [http://www.jcp.org/en/jsr/detail?id=231 JSR web page for Java Binding for the OpenGL API]

* [http://www.jcp.org/en/jsr/detail?id=239 JSR web page for Java Binding for the OpenGL ES API]

* [httpshttp://jogljogamp.dev.java.netorg/ JOGL home page]

* [http://downloadjogamp.java.netorg/mediadeployment/jogljogamp-next/buildsjavadoc/nightlyjogl/javadoc_publicjavadoc/overview-summary.html JSR 231 Specification (draft)]

{{Java desktop}}

{{DEFAULTSORT:Java Bindings For Opengl}}

[[Category:Java platform]]

[[Category:Java specification requests]]

[[Category:Java APIs]]