JogampWiki - User contributions [en]

JOCL FAQ

2011-04-05T19:26:50Z

Mbien: /* Is it possible to run JOCL based app without JOGL? */

__TOC__

== What OpenCL platforms / Operating Systems / JDKs are supported? ==
OpenCL Platforms:
* all of them. We are testing every build (in fact every commit) on AMD, Nvidia and Intel SDKs.
* If you are running on a different platform or would like to provide a build server, please let us know.

Operating Systems:
* Linux 32/64, Mac OS and Windows 32/64
* Building JOCL on other systems is easy provided that a OpenCL implementation for that system.
(e.g. OpenSolaris doesn't have OpenCL drivers yet)

Java Runtime Environments:
* We are testing on Oracle JDK and OpenJDK
* Java 5+ is required to run JOCL.

== How do I get the Source Code? ==
The project repository is located on [http://github.com/mbien/jocl github].

You can create a local copy/branch of the git repository,
either anonymous:

* git clone git://github.com/mbien/gluegen.git gluegen
* git clone git://github.com/mbien/jocl.git jocl
* git clone git://github.com/mbien/jocl-demos.git jocl-demos
* git clone git://github.com/mbien/jogl.git jogl

or via SSH and your user credential, so you can easily push back your
changes to the github server:

* git clone git@github.com:username/gluegen.git gluegen
* git clone git@github.com:username/jocl.git jocl
* git clone git@github.com:username/jocl-demos.git jocl-demos
* git clone git@github.com:username/jogl.git jogl

== What are the Build Dependencies? ==
JOCL depends on [[GlueGen_Wiki|GlueGen]] and [[JOGL_Wiki|JOGL]]

JDK6 and ANT 1.8 or later. JUnit tests require OpenCL capable hardware and OpenCL drivers.

== I have all the Sourcecode, how do I build it? ==
Please refer to [https://jogamp.org/jocl/doc/HowToBuild.html this HowTo]

== What files do I need at Runtime? ==
JOCL consists of two files:
* jocl.jar
* and one system dependent native library (e.g libjocl.so or jocl.dll or ..).
additionally you will have to provide
* gluegen-rt.jar
* and the corresponding native library (e.g libgluegen-rt.so or gluegen.dll or ...)
optionally you might want to add JOGL if you want to do OpenGL - OpenCL interoperability
* see [{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html JOGL deployment options]

== How do I Get Started? ==
* [http://michael-bien.com/mbien/entry/java_binding_for_the_opencl Short Introduction to JOCL]
* [[JOCL_Tutorial|Hello JOCL]]
* [http://jogamp.org/jocl-demos/www JOCL Demo Projects]

== How can I test if OpenCL is properly set up on my system? ==
* run [http://jogamp.org/deployment/webstart-next/jocl-demos/clinfo.jnlp CLInfo] via webstart for basic OpenCL diagnostic readouts
* or invoke:
java -jar jocl.jar:gluegen-rt.jar -Djava.library.path="path/to/jocl/libs:path/to/gluegen-rt/libs" com.jogamp.opencl.util.CLInfo

: '''note1:''' replace ':' with ';' on windows
: '''note2:''' extract gluegen-rt-natives-xxx.jar and jocl-natives-xxx.jar. It won't work if you place the jars in the library path!

* run some of the other [http://jogamp.org/jocl-demos/www/ webstart demos]

== Is it possible to run JOCL based app without JOGL? ==
Yes. JOCL is independent from JOGL and can be used without JOGL in the classpath.
In fact you have to explicitly create a shared context from a existing JOGL context if you want to interoperate with OpenGL.

// creates a pure OpenCL context
CLContext context = [http://jogamp.org/deployment/webstart-next/javadoc/jocl/javadoc/com/jogamp/opencl/CLContext.html CLContext].create();

// creates a shared context. This context can be used to share memory with JOGL's OpenGL context
CLGLContext context = [http://jogamp.org/deployment/webstart-next/javadoc/jocl/javadoc/com/jogamp/opencl/gl/CLGLContext.html CLGLContext].create(glContext);

== Can I allocate a CLBuffer without allocating a java.nio.Buffer? ==
yes, just use the right context.createBuffer() method.

discussion: http://forum.jogamp.org/Allocate-memory-object-on-device-only-tp2465039p2465039.html

== How do I do image processing with JOCL? ==
For a simple example take a look at the [https://github.com/mbien/jocl-demos/blob/master/src/com/jogamp/opencl/demos/gamma/CLSimpleGammaCorrection.java gamma correction demo] from the
[http://jogamp.org/jocl-demos/www/ jocl-demos] repository.

== Is jocl.org the same as JOCL? ==
no its not. Both are independent projects and do not share the same codebase.

JOCL FAQ

2011-04-04T18:49:40Z

Mbien: /* How can I test if OpenCL is properly set up on my system? */

__TOC__

== What OpenCL platforms / Operating Systems / JDKs are supported? ==
OpenCL Platforms:
* all of them. We are testing every build (in fact every commit) on AMD, Nvidia and Intel SDKs.
* If you are running on a different platform or would like to provide a build server, please let us know.

Operating Systems:
* Linux 32/64, Mac OS and Windows 32/64
* Building JOCL on other systems is easy provided that a OpenCL implementation for that system.
(e.g. OpenSolaris doesn't have OpenCL drivers yet)

Java Runtime Environments:
* We are testing on Oracle JDK and OpenJDK
* Java 5+ is required to run JOCL.

== How do I get the Source Code? ==
The project repository is located on [http://github.com/mbien/jocl github].

You can create a local copy/branch of the git repository,
either anonymous:

* git clone git://github.com/mbien/gluegen.git gluegen
* git clone git://github.com/mbien/jocl.git jocl
* git clone git://github.com/mbien/jocl-demos.git jocl-demos
* git clone git://github.com/mbien/jogl.git jogl

or via SSH and your user credential, so you can easily push back your
changes to the github server:

* git clone git@github.com:username/gluegen.git gluegen
* git clone git@github.com:username/jocl.git jocl
* git clone git@github.com:username/jocl-demos.git jocl-demos
* git clone git@github.com:username/jogl.git jogl

== What are the Build Dependencies? ==
JOCL depends on [[GlueGen_Wiki|GlueGen]] and [[JOGL_Wiki|JOGL]]

JDK6 and ANT 1.8 or later. JUnit tests require OpenCL capable hardware and OpenCL drivers.

== I have all the Sourcecode, how do I build it? ==
Please refer to [https://jogamp.org/jocl/doc/HowToBuild.html this HowTo]

== What files do I need at Runtime? ==
JOCL consists of two files:
* jocl.jar
* and one system dependent native library (e.g libjocl.so or jocl.dll or ..).
additionally you will have to provide
* gluegen-rt.jar
* and the corresponding native library (e.g libgluegen-rt.so or gluegen.dll or ...)
optionally you might want to add JOGL if you want to do OpenGL - OpenCL interoperability
* see [{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html JOGL deployment options]

== How do I Get Started? ==
* [http://michael-bien.com/mbien/entry/java_binding_for_the_opencl Short Introduction to JOCL]
* [[JOCL_Tutorial|Hello JOCL]]
* [http://jogamp.org/jocl-demos/www JOCL Demo Projects]

== How can I test if OpenCL is properly set up on my system? ==
* run [http://jogamp.org/deployment/webstart-next/jocl-demos/clinfo.jnlp CLInfo] via webstart for basic OpenCL diagnostic readouts
* or invoke:
java -jar jocl.jar:gluegen-rt.jar -Djava.library.path="path/to/jocl/libs:path/to/gluegen-rt/libs" com.jogamp.opencl.util.CLInfo

: '''note1:''' replace ':' with ';' on windows
: '''note2:''' extract gluegen-rt-natives-xxx.jar and jocl-natives-xxx.jar. It won't work if you place the jars in the library path!

* run some of the other [http://jogamp.org/jocl-demos/www/ webstart demos]

== Is it possible to run JOCL based app without JOGL? ==
Yes. JOCL is independent from JOGL and can be used without JOGL in the classpath.
In fact you have to explicitly create a shared context from a existing JOGL context if you want to interoperate with OpenGL.

// creates a pure OpenCL context
[http://jogamp.org/deployment/webstart-next/javadoc/jocl/javadoc/com/jogamp/opencl/CLContext.html CLContext].create();

// creates a shared context. This context can be used to share memory with JOGL's OpenGL context
[http://jogamp.org/deployment/webstart-next/javadoc/jocl/javadoc/com/jogamp/opencl/gl/CLGLContext.html CLGLContext].create(glContext);

== Can I allocate a CLBuffer without allocating a java.nio.Buffer? ==
yes, just use the right context.createBuffer() method.

discussion: http://forum.jogamp.org/Allocate-memory-object-on-device-only-tp2465039p2465039.html

== How do I do image processing with JOCL? ==
For a simple example take a look at the [https://github.com/mbien/jocl-demos/blob/master/src/com/jogamp/opencl/demos/gamma/CLSimpleGammaCorrection.java gamma correction demo] from the
[http://jogamp.org/jocl-demos/www/ jocl-demos] repository.

== Is jocl.org the same as JOCL? ==
no its not. Both are independent projects and do not share the same codebase.

Jogl Tutorial

2011-02-19T13:36:00Z

Mbien: moved jogl1 tutorials to the bottom

* Getting started
**[[Downloading and installing JOGL|Downloading and installing JOGL]]
**[[Setting up an JogAmp project in your favourite IDE|Setting up a JogAmp project in your favorite IDE]]
** [[Using JOGL in AWT SWT and Swing|Using JOGL in AWT, SWT, and Swing]]
** [http://ramisantina.com/blog/?p=8 Rami's Guide how to setup a JOGL Eclipse project]

* Wade's JOGL tutorials
** [http://wadeawalker.wordpress.com/2010/10/09/tutorial-a-cross-platform-workbench-program-using-java-opengl-and-eclipse/ Cross-platform workbench program using Eclipse and JOGL]
** [http://wadeawalker.wordpress.com/2010/10/17/tutorial-faster-rendering-with-vertex-buffer-objects/ Faster rendering with vertex buffer objects]
** [http://wadeawalker.wordpress.com/2010/10/24/tutorial-creating-native-binary-executables-for-multi-platform-java-apps-with-opengl-and-eclipse-rcp/ Creating native binary executables for multi-platform Java apps with OpenGL and Eclipse RCP]
** [http://wadeawalker.wordpress.com/2010/12/06/tutorial-displaying-java-opengl-in-an-eclipse-editor-with-a-menu-bar-and-a-runpause-button/ Displaying Java OpenGL in an Eclipse RCP editor with a menu bar and a run/pause button]

* [https://sites.google.com/site/justinscsstuff/jogl-tutorials Justin's Getting Started with JOGL 2 Tutorials]
** [https://sites.google.com/site/justinscsstuff/jogl-tutorial-1 JOGL Tutorial 1 - Environment Setup]
** [https://sites.google.com/site/justinscsstuff/jogl-tutorial-2 JOGL Tutorial 2 - Creating a Window]
** [https://sites.google.com/site/justinscsstuff/jogl-tutorial-3 JOGL Tutorial 3 - Creating a Render Loop]

* [http://leolol.com/tutorials/graphics_tutorials.html LeoLoL.com Tutorials]
** [http://leolol.com/tutorials/graphics/lesson01.html Lesson 1 - Setting up a JOGL Template]
** [http://leolol.com/tutorials/graphics/lesson02.html Lesson 2 - Drawing basic 2D shapes]
** [http://leolol.com/tutorials/graphics/lesson03.html Lesson 3 - Adding colour]
** [http://leolol.com/tutorials/graphics/lesson04.html Lesson 4 - 3D Shapes and Rotation]

* Courses
** [http://www.informatik.uni-oldenburg.de/~trigger/opengl_course.html Johannes's Courses at University of Oldenburg (German)]

* Older .. jogl v1 related
** [http://www.felixgers.de/teaching/jogl/ Felix's OpenGL and JOGL]

* [http://www.sjonesart.com/gl.php Ste3e's JOGL tutorials]
** [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fENGE3ZmZkOGItZGYzZC00ZDgzLTg0NTAtMTk1MTAwMzYxYzNk&hl=en Keys and Mouse]
** [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fEYTFiMmFiYzQtMDA0MC00ZWI0LWI1NjItODE3ZjM2OGUxOWEw&hl=en First-Person Shooter]
** [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fEZGI2NTZhZTMtYWYwNS00NTljLWFiNGQtM2UyNTYyNjAzNDYy&hl=en Vertex Buffer Objects]
** [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fENWFhODk0M2UtZDY0Ni00YWM5LWIxZGUtMzM0YzMxMmRlODgx&hl=en Shader Setup]
** [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fEMzNjNDBmMjUtNGQzNS00ODY0LWJkYmUtNDM5Y2I5ODc0Y2Nj&hl=en Texture Using Shaders]

(The old (not quite up-to-date) JOGL Userguide is currently available [http://jogamp.org/jogl/doc/userguide/ here])

JOCL Tutorial

2011-02-18T21:53:32Z

Mbien:

Hello JOCL host program:
<pre>
package com.jogamp.opencl.demos.hellojocl;

import com.jogamp.opencl.CLBuffer;
import com.jogamp.opencl.CLCommandQueue;
import com.jogamp.opencl.CLContext;
import com.jogamp.opencl.CLDevice;
import com.jogamp.opencl.CLKernel;
import com.jogamp.opencl.CLProgram;
import java.io.IOException;
import java.nio.FloatBuffer;
import java.util.Random;

import static java.lang.System.*;
import static com.jogamp.opencl.CLMemory.Mem.*;
import static java.lang.Math.*;

/**
* Hello Java OpenCL example. Adds all elements of buffer A to buffer B
* and stores the result in buffer C.<br/>
* Sample was inspired by the Nvidia VectorAdd example written in C/C++
* which is bundled in the Nvidia OpenCL SDK.
* @author Michael Bien
*/
public class HelloJOCL {

public static void main(String[] args) throws IOException {

// set up (uses default CLPlatform and creates context for all devices)
CLContext context = CLContext.create();
out.println("created "+context);

// always make sure to release the context under all circumstances
// not needed for this particular sample but recommented
try{

// select fastest device
CLDevice device = context.getMaxFlopsDevice();
out.println("using "+device);

// create command queue on device.
CLCommandQueue queue = device.createCommandQueue();

int elementCount = 1444477; // Length of arrays to process
int localWorkSize = min(device.getMaxWorkGroupSize(), 256); // Local work size dimensions
int globalWorkSize = roundUp(localWorkSize, elementCount); // rounded up to the nearest multiple of the localWorkSize

// load sources, create and build program
CLProgram program = context.createProgram(HelloJOCL.class.getResourceAsStream("VectorAdd.cl")).build();

// A, B are input buffers, C is for the result
CLBuffer<FloatBuffer> clBufferA = context.createFloatBuffer(globalWorkSize, READ_ONLY);
CLBuffer<FloatBuffer> clBufferB = context.createFloatBuffer(globalWorkSize, READ_ONLY);
CLBuffer<FloatBuffer> clBufferC = context.createFloatBuffer(globalWorkSize, WRITE_ONLY);

out.println("used device memory: "
+ (clBufferA.getCLSize()+clBufferB.getCLSize()+clBufferC.getCLSize())/1000000 +"MB");

// fill input buffers with random numbers
// (just to have test data; seed is fixed -> results will not change between runs).
fillBuffer(clBufferA.getBuffer(), 12345);
fillBuffer(clBufferB.getBuffer(), 67890);

// get a reference to the kernel function with the name 'VectorAdd'
// and map the buffers to its input parameters.
CLKernel kernel = program.createCLKernel("VectorAdd");
kernel.putArgs(clBufferA, clBufferB, clBufferC).putArg(elementCount);

// asynchronous write of data to GPU device,
// followed by blocking read to get the computed results back.
long time = nanoTime();
queue.putWriteBuffer(clBufferA, false)
.putWriteBuffer(clBufferB, false)
.put1DRangeKernel(kernel, 0, globalWorkSize, localWorkSize)
.putReadBuffer(clBufferC, true);
time = nanoTime() - time;

// print first few elements of the resulting buffer to the console.
out.println("a+b=c results snapshot: ");
for(int i = 0; i < 10; i++)
out.print(clBufferC.getBuffer().get() + ", ");
out.println("...; " + clBufferC.getBuffer().remaining() + " more");

out.println("computation took: "+(time/1000000)+"ms");

}finally{
// cleanup all resources associated with this context.
context.release();
}

}

private static void fillBuffer(FloatBuffer buffer, int seed) {
Random rnd = new Random(seed);
while(buffer.remaining() != 0)
buffer.put(rnd.nextFloat()*100);
buffer.rewind();
}

private static int roundUp(int groupSize, int globalSize) {
int r = globalSize % groupSize;
if (r == 0) {
return globalSize;
} else {
return globalSize + groupSize - r;
}
}

}
</pre>

Hello JOCL Kernel:

<pre>
// OpenCL Kernel Function for element by element vector addition
kernel void VectorAdd(global const float* a, global const float* b, global float* c, int numElements) {

// get index into global data array
int iGID = get_global_id(0);

// bound check, equivalent to the limit on a 'for' loop
if (iGID >= numElements) {
return;
}

// add the vector elements
c[iGID] = a[iGID] + b[iGID];
}
</pre>

JOCL FAQ

2011-02-16T20:51:01Z

Mbien:

__TOC__

== What OpenCL platforms / Operating Systems / JDKs are supported? ==
OpenCL Platforms:
* all of them. We are testing every build (in fact every commit) on AMD, Nvidia and Intel SDKs.
* If you are running on a different platform or would like to provide a build server, please let us know.

Operating Systems:
* Linux 32/64, Mac OS and Windows 32/64
* Building JOCL on other systems is easy provided that a OpenCL implementation for that system.
(e.g. OpenSolaris doesn't have OpenCL drivers yet)

Java Runtime Environments:
* We are testing on Oracle JDK and OpenJDK
* Java 5+ is required to run JOCL.

== How do I get the Source Code? ==
The project repository is located on [http://github.com/mbien/jocl github].

You can create a local copy/branch of the git repository,
either anonymous:

* git clone git://github.com/mbien/gluegen.git gluegen
* git clone git://github.com/mbien/jocl.git jocl
* git clone git://github.com/mbien/jocl-demos.git jocl-demos
* git clone git://github.com/mbien/jogl.git jogl

or via SSH and your user credential, so you can easily push back your
changes to the github server:

* git clone git@github.com:username/gluegen.git gluegen
* git clone git@github.com:username/jocl.git jocl
* git clone git@github.com:username/jocl-demos.git jocl-demos
* git clone git@github.com:username/jogl.git jogl

== What are the Build Dependencies? ==
JOCL depends on [[GlueGen_Wiki|GlueGen]] and [[JOGL_Wiki|JOGL]]

JDK6 and ANT 1.8 or later. JUnit tests require OpenCL capable hardware and OpenCL drivers.

== I have all the Sourcecode, how do I build it? ==
Please refer to [https://jogamp.org/jocl/doc/HowToBuild.html this HowTo]

== What files do I need at Runtime? ==
JOCL consists of two files:
* jocl.jar
* and one system dependent native library (e.g libjocl.so or jocl.dll or ..).
additionally you will have to provide
* gluegen-rt.jar
* and the corresponding native library (e.g libgluegen-rt.so or gluegen.dll or ...)
optionally you might want to add JOGL if you want to do OpenGL - OpenCL interoperability
* see [{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html JOGL deployment options]

== How do I Get Started? ==
* [http://michael-bien.com/mbien/entry/java_binding_for_the_opencl Short Introduction to JOCL]
* [[JOCL_Tutorial|Hello JOCL]]
* [http://jogamp.org/jocl-demos/www JOCL Demo Projects]

== How can I test if OpenCL is properly set up on my system? ==
* run [http://jogamp.org/deployment/webstart-next/jocl-demos/clinfo.jnlp CLInfo] via webstart for basic OpenCL diagnostic readouts
* or invoke: java -jar jocl.jar -Djava.library.path="path/to/jocl/libs" com.jogamp.opencl.util.CLInfo
* run some of the other [http://jogamp.org/jocl-demos/www/ webstart demos]

== Is it possible to run JOCL based app without JOGL? ==
Yes. JOCL is independent from JOGL and can be used without JOGL in the classpath.
In fact you have to explicitly create a shared context from a existing JOGL context if you want to interoperate with OpenGL.

// creates a pure OpenCL context
[http://jogamp.org/deployment/webstart-next/javadoc/jocl/javadoc/com/jogamp/opencl/CLContext.html CLContext].create();

// creates a shared context. This context can be used to share memory with JOGL's OpenGL context
[http://jogamp.org/deployment/webstart-next/javadoc/jocl/javadoc/com/jogamp/opencl/gl/CLGLContext.html CLGLContext].create(glContext);

== Can I allocate a CLBuffer without allocating a java.nio.Buffer? ==
yes, just use the right context.createBuffer() method.

discussion: http://forum.jogamp.org/Allocate-memory-object-on-device-only-tp2465039p2465039.html

== How do I do image processing with JOCL? ==
For a simple example take a look at the [https://github.com/mbien/jocl-demos/blob/master/src/com/jogamp/opencl/demos/gamma/CLSimpleGammaCorrection.java gamma correction demo] from the
[http://jogamp.org/jocl-demos/www/ jocl-demos] repository.

== Is jocl.org the same as JOCL? ==
no its not. Both are independent projects and do not share the same codebase.

JOCL FAQ

2011-02-16T20:05:58Z

Mbien:

__TOC__

== What OpenCL platforms / Operating Systems / JDKs are supported? ==
OpenCL Platforms:
* all of them. We are testing every build (in fact every commit) on AMD, Nvidia and Intel SDKs.
* If you are running on a different platform or would like to provide a build server, please let us know.

Operating Systems:
* Linux 32/64, Mac OS and Windows 32/64
* Building JOCL on other systems is easy provided that a OpenCL implementation for that system.
(e.g. OpenSolaris doesn't have OpenCL drivers yet)

Java Runtime Environments:
* We are testing on Oracle JDK and OpenJDK
* Java 5+ is required to run JOCL.

== How do I get the Source Code? ==
The project repository is located on [http://github.com/mbien/jocl github].

You can create a local copy/branch of the git repository,
either anonymous:

* git clone git://github.com/mbien/gluegen.git gluegen
* git clone git://github.com/mbien/jocl.git jocl
* git clone git://github.com/mbien/jocl-demos.git jocl-demos
* git clone git://github.com/mbien/jogl.git jogl

or via SSH and your user credential, so you can easily push back your
changes to the github server:

* git clone git@github.com:username/gluegen.git gluegen
* git clone git@github.com:username/jocl.git jocl
* git clone git@github.com:username/jocl-demos.git jocl-demos
* git clone git@github.com:username/jogl.git jogl

== What are the Build Dependencies? ==
JOCL depends on [[GlueGen_Wiki|GlueGen]] and [[JOGL_Wiki|JOGL]]

JDK6 and ANT 1.8 or later. JUnit tests require OpenCL capable hardware and OpenCL drivers.

== I have all the Sourcecode, how do I build it? ==
Please refer to [https://jogamp.org/jocl/doc/HowToBuild.html this HowTo]

== What files do I need at Runtime? ==
JOCL consists of two files:
* jocl.jar
* and one system dependent native library (e.g libjocl.so or jocl.dll or ..).
additionally you will have to provide
* gluegen-rt.jar
* and the corresponding native library (e.g libgluegen-rt.so or gluegen.dll or ...)
optionally you might want to add JOGL if you want to do OpenGL - OpenCL interoperability
* see [{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html JOGL deployment options]

== How do I Get Started? ==
* [http://michael-bien.com/mbien/entry/java_binding_for_the_opencl Short Introduction to JOCL]
* [[JOCL_Tutorial|Hello JOCL]]
* [http://jogamp.org/jocl-demos/www JOCL Demo Projects]

== Is it possible to run JOCL based app without JOGL? ==
Yes. JOCL is independent from JOGL and can be used without JOGL in the classpath.
In fact you have to explicitly create a shared context from a existing JOGL context if you want to interoperate with OpenGL.

// creates a pure OpenCL context
[http://jogamp.org/deployment/webstart-next/javadoc/jocl/javadoc/com/jogamp/opencl/CLContext.html CLContext].create();

// creates a shared context. This context can be used to share memory with JOGL's OpenGL context
[http://jogamp.org/deployment/webstart-next/javadoc/jocl/javadoc/com/jogamp/opencl/gl/CLGLContext.html CLGLContext].create(glContext);

== Can I allocate a CLBuffer without allocating a java.nio.Buffer? ==
yes, just use the right context.createBuffer() method.

discussion: http://forum.jogamp.org/Allocate-memory-object-on-device-only-tp2465039p2465039.html

== Is jocl.org the same as JOCL? ==
no its not. Both are independent projects and do not share the same codebase.

Maintainer and Contacts

2011-02-12T22:19:57Z

Mbien: updated forum link

= Maintainer =

* Gluegen
** Sven Gothel
* JOAL
** Sven Gothel
* JOGL
** Sven Gothel
* JOCL
** Michael Bien
* Art
** Dominik Ströhlein
* <i>Open Positions</i>
** jogl-utils

= Contacts =

You can address the JogAmp Community via:
* [http://jogamp.org/ Web]
* [http://forum.jogamp.org/ Forum/Mailinglist]
* JogAmp Channel
** server: conference.jabber.org room: jogamp
* Email
** mediastream [@] jogamp.org

You may also contact Individuals via:
* Sven Gothel
** sgothel [@] jausoft.com
* Michael Bien
** mbien [@] fh-landshut.de
** [http://blog.michael-bien.com/ blog.michael-bien.com]

If you have commercial support requests<br>
please feel free to contact the module maintainer.

We are confident to make your JogAmp experience a successful story.

JOCL Tutorial

2011-02-12T20:11:04Z

Mbien: updated sourcecode

JOCL FAQ

2011-02-12T02:55:42Z

Mbien: /* Is jocl.org the same as JOCL? */

__TOC__

== How do I get the Source Code? ==
The project repository is located on [http://github.com/mbien/jocl github].

You can create a local copy/branch of the git repository,
either anonymous:

* git clone git://github.com/mbien/gluegen.git gluegen
* git clone git://github.com/mbien/jocl.git jocl
* git clone git://github.com/mbien/jocl-demos.git jocl-demos
* git clone git://github.com/mbien/jogl.git jogl

or via SSH and your user credential, so you can easily push back your
changes to the github server:

* git clone git@github.com:username/gluegen.git gluegen
* git clone git@github.com:username/jocl.git jocl
* git clone git@github.com:username/jocl-demos.git jocl-demos
* git clone git@github.com:username/jogl.git jogl

== What are the Build Dependencies? ==
JOCL depends on [[GlueGen_Wiki|GlueGen]] and [[JOGL_Wiki|JOGL]]

JDK6 and ANT 1.8 or later. JUnit tests require OpenCL capable hardware and OpenCL drivers.

== I have all the Sourcecode, how do I build it? ==
Please refer to [https://jogamp.org/jocl/doc/HowToBuild.html this HowTo]

== What files do I need at Runtime? ==
JOCL consists of two files:
* jocl.jar
* and one system dependent native library (e.g libjocl.so or jocl.dll or ..).
additionally you will have to provide
* gluegen-rt.jar
* and the corresponding native library (e.g libgluegen-rt.so or gluegen.dll or ...)
optionally you might want to add JOGL if you want to do OpenGL - OpenCL interoperability
* see [{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html JOGL deployment options]

== How do I Get Started? ==
* [http://michael-bien.com/mbien/entry/java_binding_for_the_opencl Short Introduction to JOCL]
* [[JOCL_Tutorial|Hello JOCL]]
* [http://jogamp.org/jocl-demos/www JOCL Demo Projects]

== Is it possible to run JOCL based app without JOGL? ==
Yes. JOCL is independent from JOGL and can be used without JOGL in the classpath.
In fact you have to explicitly create a shared context from a existing JOGL context if you want to interoperate with OpenGL.

// creates a pure OpenCL context
[http://jogamp.org/deployment/webstart-next/javadoc/jocl/javadoc/com/jogamp/opencl/CLContext.html CLContext].create();

// creates a shared context. This context can be used to share memory with JOGL's OpenGL context
[http://jogamp.org/deployment/webstart-next/javadoc/jocl/javadoc/com/jogamp/opencl/gl/CLGLContext.html CLGLContext].create(glContext);

== Can I allocate a CLBuffer without allocating a java.nio.Buffer? ==
yes, just use the right context.createBuffer() method.

discussion: http://forum.jogamp.org/Allocate-memory-object-on-device-only-tp2465039p2465039.html

== Is jocl.org the same as JOCL? ==
no its not. Both are independent projects and don't stay in any relation.

JOCL FAQ

2011-02-12T02:55:03Z

Mbien:

JOCL FAQ

2011-02-12T02:41:25Z

Mbien: /* Can I allocate a CLBuffer without allocating a java.nio.Buffer? */

JOCL FAQ

2011-02-10T14:33:04Z

Mbien:

__TOC__

== How do I get the Source Code? ==
The project repository is located on [http://github.com/mbien/jocl github].

You can create a local copy/branch of the git repository,
either anonymous:

* git clone git://github.com/mbien/gluegen.git gluegen
* git clone git://github.com/mbien/jocl.git jocl
* git clone git://github.com/mbien/jocl-demos.git jocl-demos
* git clone git://github.com/mbien/jogl.git jogl

or via SSH and your user credential, so you can easily push back your
changes to the github server:

* git clone git@github.com:username/gluegen.git gluegen
* git clone git@github.com:username/jocl.git jocl
* git clone git@github.com:username/jocl-demos.git jocl-demos
* git clone git@github.com:username/jogl.git jogl

== What are the Build Dependencies? ==
JOCL depends on [[GlueGen_Wiki|GlueGen]] and [[JOGL_Wiki|JOGL]]

JDK6 and ANT 1.8 or later. JUnit tests require OpenCL capable hardware and OpenCL drivers.

== I have all the Sourcecode, how do I build it? ==
Please refer to [https://jogamp.org/jocl/doc/HowToBuild.html this HowTo]

== What files do I need at Runtime? ==
JOCL consists of two files:
* jocl.jar
* and one system dependent native library (e.g libjocl.so or jocl.dll or ..).
additionally you will have to provide
* gluegen-rt.jar
* and the corresponding native library (e.g libgluegen-rt.so or gluegen.dll or ...)
optionally you might want to add JOGL if you want to do OpenGL - OpenCL interoperability
* see [{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html JOGL deployment options]

== How do I Get Started? ==
* [http://michael-bien.com/mbien/entry/java_binding_for_the_opencl Short Introduction to JOCL]
* [[JOCL_Tutorial|Hello JOCL]]
* [http://jogamp.org/jocl-demos/www JOCL Demo Projects]

== Is it possible to run JOCL based app without JOGL? ==
Yes. JOCL is independent from JOGL and can be used without JOGL in the classpath.
In fact you have to explicitly create a shared context from a existing JOGL context if you want to interoperate with OpenGL.

// creates a pure OpenCL context
[http://jogamp.org/deployment/webstart-next/javadoc/jocl/javadoc/com/jogamp/opencl/CLContext.html CLContext].create();

// creates a shared context. This context can be used to share memory with JOGL's OpenGL context
[http://jogamp.org/deployment/webstart-next/javadoc/jocl/javadoc/com/jogamp/opencl/gl/CLGLContext.html CLGLContext].create(glContext);

== Can I allocate a CLBuffer without allocating a java.nio.Buffer? ==
yes, just use the right context.createBuffer() method: http://jogamp.762907.n3.nabble.com/Allocate-memory-object-on-device-only-td2465039.html

JOCL FAQ

2011-02-10T01:46:42Z

Mbien: /* How do I Get Started? */

JOCL FAQ

2011-02-10T01:40:16Z

Mbien: /* Is it possible to run JOCL based app without JOGL? */

__TOC__

== How do I get the Source Code? ==
The project repository is located on [http://github.com/mbien/jocl github].

You can create a local copy/branch of the git repository,
either anonymous:

* git clone git://github.com/mbien/gluegen.git gluegen
* git clone git://github.com/mbien/jocl.git jocl
* git clone git://github.com/mbien/jocl-demos.git jocl-demos
* git clone git://github.com/mbien/jogl.git jogl

or via SSH and your user credential, so you can easily push back your
changes to the github server:

* git clone git@github.com:username/gluegen.git gluegen
* git clone git@github.com:username/jocl.git jocl
* git clone git@github.com:username/jocl-demos.git jocl-demos
* git clone git@github.com:username/jogl.git jogl

== What are the Build Dependencies? ==
JOCL depends on [[GlueGen_Wiki|GlueGen]] and [[JOGL_Wiki|JOGL]]

JDK6 and ANT 1.8 or later. JUnit tests require OpenCL capable hardware and OpenCL drivers.

== I have all the Sourcecode, how do I build it? ==
Please refer to [https://jogamp.org/jocl/doc/HowToBuild.html this HowTo]

== What files do I need at Runtime? ==
JOCL consists of two files:
* jocl.jar
* and one system dependent native library (e.g libjocl.so or jocl.dll or ..).
additionally you will have to provide
* gluegen-rt.jar
* and the corresponding native library (e.g libgluegen-rt.so or gluegen.dll or ...)
optionally you might want to add JOGL if you want to do OpenGL - OpenCL interoperability
* see [{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html JOGL deployment options]

== How do I Get Started? ==
* [http://michael-bien.com/mbien/entry/java_binding_for_the_opencl| Short Introduction to JOCL]
* [[JOCL_Tutorial|Hello JOCL]]
* [http://jogamp.org/jocl-demos/www JOCL Demo Projects]

== Is it possible to run JOCL based app without JOGL? ==
Yes. JOCL is independent from JOGL and can be used without JOGL in the classpath.
In fact you have to explicitly create a shared context from a existing JOGL context if you want to interoperate with OpenGL.

// creates a pure OpenCL context
[http://jogamp.org/deployment/webstart-next/javadoc/jocl/javadoc/com/jogamp/opencl/CLContext.html CLContext].create();

// creates a shared context. This context can be used to share memory with JOGL's OpenGL context
[http://jogamp.org/deployment/webstart-next/javadoc/jocl/javadoc/com/jogamp/opencl/gl/CLGLContext.html CLGLContext].create(glContext);

JOCL FAQ

2011-02-10T01:23:18Z

Mbien:

__TOC__

== How do I get the Source Code? ==
The project repository is located on [http://github.com/mbien/jocl github].

You can create a local copy/branch of the git repository,
either anonymous:

* git clone git://github.com/mbien/gluegen.git gluegen
* git clone git://github.com/mbien/jocl.git jocl
* git clone git://github.com/mbien/jocl-demos.git jocl-demos
* git clone git://github.com/mbien/jogl.git jogl

or via SSH and your user credential, so you can easily push back your
changes to the github server:

* git clone git@github.com:username/gluegen.git gluegen
* git clone git@github.com:username/jocl.git jocl
* git clone git@github.com:username/jocl-demos.git jocl-demos
* git clone git@github.com:username/jogl.git jogl

== What are the Build Dependencies? ==
JOCL depends on [[GlueGen_Wiki|GlueGen]] and [[JOGL_Wiki|JOGL]]

JDK6 and ANT 1.8 or later. JUnit tests require OpenCL capable hardware and OpenCL drivers.

== I have all the Sourcecode, how do I build it? ==
Please refer to [https://jogamp.org/jocl/doc/HowToBuild.html this HowTo]

== What files do I need at Runtime? ==
JOCL consists of two files:
* jocl.jar
* and one system dependent native library (e.g libjocl.so or jocl.dll or ..).
additionally you will have to provide
* gluegen-rt.jar
* and the corresponding native library (e.g libgluegen-rt.so or gluegen.dll or ...)
optionally you might want to add JOGL if you want to do OpenGL - OpenCL interoperability
* see [{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html JOGL deployment options]

== How do I Get Started? ==
* [http://michael-bien.com/mbien/entry/java_binding_for_the_opencl| Short Introduction to JOCL]
* [[JOCL_Tutorial|Hello JOCL]]
* [http://jogamp.org/jocl-demos/www JOCL Demo Projects]

== Is it possible to run JOCL based app without JOGL? ==
Yes. JOCL is completely independent from JOGL. In fact you have to explicitly create a shared context if you want to interoperate with JOGL.
* [http://jogamp.org/deployment/webstart-next/javadoc/jocl/javadoc/com/jogamp/opencl/CLContext.html CLContext].create(); // creates a pure OpenCL context
* [http://jogamp.org/deployment/webstart-next/javadoc/jocl/javadoc/com/jogamp/opencl/gl/CLGLContext.html CLGLContext].create(glContext); // creates a shared context. This context can be used to share memory with OpenGL

Main Page

2011-01-23T15:58:18Z

Mbien: removed the border

__NOTOC__
{| width="100%"
|-
|
<div>
Welcome to the [{{SERVER}}/ JogAmp] wiki. It documents JOGL, JOCL and JOAL, the cross-platform bindings to the OpenGL, OpenCL, and OpenAL APIs.
</div>
|-
|
{| style="width: 100%;"
|-
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Get started with JogAmp</h3>
*[[Downloading and installing JOGL|Download and install JOGL]]
*[[Setting up an JogAmp project in your favourite IDE|Setting up an JogAmp project in your favourite IDE]]
*[{{SERVER}}/forum.html Ask a question on our forum]
*[[Jogl FAQ#Bugreports & Testing|Report a bug]]
*[[chatroom|Jabber (XMPP) JogAmp Channel]]
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>The JogAmp community</h3>
*[[How to Contribute|Contribute to JogAmp]]
*[[Maintainer and Contacts]]
*[[Jogamp Versioning and Releases|Versioning and Releases]]
*[[Jogamp SCM Repositories|Source Code Repositories]]
*[{{SERVER}}/chuck/ Build and Test Server]
*[[SW Tracking|Tracking Reports]]
*[{{SERVER}}/bugzilla/ Bugzilla]
|}
|-

{| style=" width: 100%;"
|-
|colspan="2"|<h1>JogAmp Modules</h1>
|-
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>JOGL</h3>
*[[Jogl Overview|Overview]]
*[[Jogl Tutorial|Tutorial]]
*[[Jogl FAQ|FAQ]]
*[{{SERVER}}/git/?p=jogl.git;a=blob;f=LICENSE.txt License]
*API Doc [ [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc/ Public], Specs [ [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_nativewindow_spec/ Nativewindow], [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_jogl_spec/ JOGL] ], [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_dev/ Internal] ]
*[{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html JOGL Deployment]
*[{{SERVER}}/jogl/doc/HowToBuild.html How to Build JOGL]
*[{{SERVER}}/jogl/doc/userguide/ Simple Userguide] (not up2date)
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>JOCL</h3>
*[[JOCL Overview|Overview]]
*[[JOCL Tutorial|Tutorial]]
*[[JOCL FAQ|FAQ]]
*[{{SERVER}}/git/?p=jocl.git;a=blob;f=LICENSE License]
*[{{SERVER}}/deployment/jogamp-next/javadoc/jocl/javadoc/ API Doc]
*[{{SERVER}}/jocl/doc/HowToBuild.html How to Build JOCL]
|-
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>JOAL</h3>
*[[Joal Overview|Overview]]
*[[Joal Tutorial|Tutorial]]
*[[Joal FAQ|FAQ]]
*[{{SERVER}}/git/?p=joal.git;a=blob;f=LICENSE.txt License]
*API Doc [ [{{SERVER}}/deployment/jogamp-next/javadoc/joal/javadoc/ Public], [{{SERVER}}/deployment/jogamp-next/javadoc/joal/javadoc_dev/ Internal] ]
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>GlueGen</h3>
* [[GlueGen_Wiki|Overview]]
* [{{SERVER}}/git/?p=gluegen.git;a=blob;f=LICENSE.txt License]
* [{{SERVER}}/deployment/jogamp-next/javadoc/gluegen/javadoc/ API Doc]
|}

Chatroom

2011-01-23T15:51:25Z

Mbien:

== Jabber (XMPP) JogAmp Channel ==
: '''url: conference.jabber.org'''
: '''room: jogamp'''

all you have to do is to create an account on e.g. http://www.jabber.org, http://jabbear.com, .. or take your existing xmpp account and join our channel with the client of your choice.
Alternatively you could also use a so called "transport server" to join even from a different IM protocol.

== New to XMPP? ==
* [http://en.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol XMPP on wikipedia]
* [http://xmpp.org/services/ public servers]
* [http://xmpp.org/xmpp-software/clients/ clients]

== No Client? ==
* try a web based client like [https://www.jappix.com/ jappix]

Chatroom

2011-01-23T15:40:58Z

Mbien:

Maintainer and Contacts

2011-01-19T21:37:00Z

Mbien: /* Contacts */

= Maintainer =

* Gluegen
** Sven Gothel
* JOAL
** Sven Gothel
* JOGL
** Sven Gothel
* JOCL
** Michael Bien
* Art
** Dominik Ströhlein
* <i>Open Positions</i>
** jogl-utils

= Contacts =

You can address the JogAmp Community via:
* [http://jogamp.org/ Web]
* [http://jogamp.762907.n3.nabble.com/ Forum/Mailinglist]
* JogAmp Channel
** server: conference.jabber.org room: jogamp
* Email
** mediastream [@] jogamp.org

You may also contact Individuals via:
* Sven Gothel
** sgothel [@] jausoft.com
* Michael Bien
** mbien [@] fh-landshut.de
** [http://blog.michael-bien.com/ blog.michael-bien.com]

If you have commercial support requests<br>
please feel free to contact the module maintainer.

We are confident to make your JogAmp experience a successful story.

JOCL Overview

2011-01-19T21:32:34Z

Mbien:

== Project Goal ==
JOCL provides java bindings to OpenCL, the open computing language.

JOCL enables applications running on the JVM to use OpenCL for massively parallel, high performance computing tasks, executed on heterogeneous hardware (GPUs, CPUs, FPGAs etc) in a platform independent manner. JOCL consists of two parts, the low level and the high level binding.

== Low level Bindings ==
The low level bindings (LLB) are generated from the Khronos OpenCL headers and provide a high performance, JNI based, 1:1 mapping to the C functions.

This has the following advantages:
* reduces maintenance overhead and ensures spec conformance
* compiletime JNI bindings are the fastest way to access native libs from the JVM
* makes translating OpenCL C code into Java + JOCL very easy (e.g. from books or tutorials)
* flexibility and stability: OpenCL libs are loaded dynamically and accessed via function pointers

== High level Bindings ==
The hand written high level bindings (HLB) is build on top of LLB and hides most boilerplate code (like object IDs, pointers and resource management) behind easy to use java objects. HLB use direct NIO buffers internally for fast memory transfers between the JVM and the OpenCL implementation and is very GC friendly. Most of the API is designed for method chaining but of course you don't have to use it this way if you don't want to. JOCL also seamlessly integrates with JOGL 2 (both are built and tested together). Just pass the JOGL context as parameter to the JOCL context factory and you will receive a shared context. If you already know OpenCL and Java, HLB should be very intuitive for you.

== Links ==
* [http://jogamp.org/jocl/www/ project page]
* [http://github.com/mbien/jocl main source repository]
* [http://jogamp.org/chuck/job/jocl/ continuous integration server]
* [[JOCL_FAQ|FAQ]]

JOCL FAQ

2011-01-19T21:14:04Z

Mbien: fixed links

JOCL FAQ

2011-01-19T21:13:00Z

Mbien:

JOCL FAQ

2011-01-19T21:11:10Z

Mbien:

__TOC__

== Get the Source Code ==
The project repository is located on [http://github.com/mbien/jocl github].

You can create a local copy/branch of the git repository,
either anonymous:

* git clone git://github.com/mbien/gluegen.git gluegen
* git clone git://github.com/mbien/jocl.git jocl
* git clone git://github.com/mbien/jocl-demos.git jocl-demos
* git clone git://github.com/mbien/jogl.git jogl

or via SSH and your user credential, so you can easily push back your
changes to the github server:

* git clone git@github.com:username/gluegen.git gluegen
* git clone git@github.com:username/jocl.git jocl
* git clone git@github.com:username/jocl-demos.git jocl-demos
* git clone git@github.com:username/jogl.git jogl

== What are the Build Dependencies? ==
JOCL depends on [[GlueGen_Wiki|GlueGen]] and [[JOGL_Wiki|JOGL]]

JDK6 and ANT 1.8 or later. JUnit tests require OpenCL capable hardware and OpenCL drivers.

== I have all the Sourcecode, how do I build it? ==
Please refer to [https://jogamp.org/jocl/doc/HowToBuild.html| this HowTo]

== What files do I need at Runtime? ==
JOCL consists of two files:
* jocl.jar
* and one system dependent native library (e.g libjocl.so or jocl.dll or ..).
additionally you will have to provide
* gluegen-rt.jar
* and the corresponding native library (e.g libgluegen-rt.so or gluegen.dll or ...)
optionally you might want to add JOGL if you want to do OpenGL - OpenCL interoperability
* see [{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html JOGL deployment options]

== Getting Started ==
* [http://michael-bien.com/mbien/entry/java_binding_for_the_opencl| Short Introduction to JOCL]
* [[JOCL_Tutorial|Hello JOCL]]
* [http://jogamp.org/jocl-demos/www|JOCL Demo Projects]

How to Contribute

2011-01-19T20:44:44Z

Mbien: /* Steps */

= Overview =

Our modules have been [http://blog.jausoft.com/2009/07/08/svn-to-git-migration-1/ migrated to git], thanks to the great git toolchain.<br>
In the past we were using a centralized repository only, ''SVN'', and you really needed access to a central repository.

Chose a media to offer your branch to the [[Maintainer and Contacts#Maintainer|module maintainer]].
This may be via
* [http://www.kernel.org/pub/software/scm/git/docs/everyday.html#Individual%20Developer%20%28Participant%29 email]
* [http://weblog.masukomi.org/wp-content/uploads/2008/03/config_remote_repo.svg http]
* [http://kernel.org/pub/software/scm/git/docs/howto/use-git-daemon.txt git]

Surely it's most easy for us to access your git repository via the git protocol
you may host on a free git server like [[http://github.com github]].

Just '''create a branch of your own and make it available''', then you may ask
the [[Maintainer and Contacts#Maintainer|module maintainer]] to pull, review and merge your branch.<br>
[http://whygitisbetterthanx.com/#any-workflow Collaboration] using a [http://whygitisbetterthanx.com/#distributed distributed SCM] is easy.

= Steps =

* fork a [[Jogamp SCM Repositories|SCM repository]]
* do with it as you please while obeying the modules license and <i>the law</i>.
* tell us about the earth shaking improvements you made via the [http://jogamp.org/forum.html mailinglists/forum] and contact the [[Maintainer and Contacts#Maintainer|module maintainer]]
* if everything works fine we will probably integrate it soon, <b>if</b>
** you include a [http://jogamp.org/git/?p=jogl.git;a=blob;f=src/junit/com/jogamp/test/junit/newt/TestGLWindows00NEWT.java <b>a junit test</b>] reflecting your changes / feature
** you comply with the module's license and contribute under it's terms
** we can <i>somehow</i> verify your identity, at least you use your <b>full name</b> in your [http://help.github.com/git-email-settings/ git commits]

For more details, see [[Contributing a new feature or fix|these instructions on how to contribute a new feature or fix]].

To actually build the beast, please refer to the following manuals:
* [{{SERVER}}/jogl/doc/HowToBuild.html How To Build JOGL]
* [{{SERVER}}/jocl/doc/HowToBuild.html How To Build JOCL]
* [[Building JOGL on the command line|Building JOGL on the command line]]
* [[Downloading and installing JOGL|Downloading and installing JOGL]]
* [[Building JOGL in Eclipse|Building JOGL in Eclipse]]
* [[Setting up an JogAmp project in your favourite IDE|Setting up an JogAmp project in your favourite IDE]]

= Git References =
* http://help.github.com/git-installation-redirect
* http://help.github.com/git-email-settings/
* http://help.github.com/
* [http://git.or.cz/course/svn.html GIT Manual for SVN Experts]

Setting up a JogAmp project in your favorite IDE

2011-01-17T23:55:36Z

Mbien:

__TOC__

It's very simple to set up a project of your favorite IDE to use a JogAmp library. These instructions assume you've already created a new project in the IDE.

= Download a JogAmp project =

If you haven't done so already, download and extract for example JOGL as described at [[Downloading_and_installing_JOGL]].

To be able to use a JogAmp library you will have to add the jar files to the classpath and the native files to the library path of your projects run configuration.
Please note that all projects depend on the GlueGen runtime libraries which are for convenience reasons included in every JogAmp project but only required once in the classpath/library path of your application.

= Eclipse IDE =
=== Create a user library ===

You can make your new Eclipse project depend directly on all the JARs and native libraries, but it's inconvenient to do that every time you create a new project. Creating a user library bundles all the files together so you can include them in one step.

* Click "Window > Preferences", then select "Java > Build Path > User Libraries" on the left.
* Click the "New..." button, type "JOAL", "JOCL", "JOGL" or "GlueGen RT" for the library name, and click "OK".
* Click the "Add JARs..." button, navigate to the directory where you've stored the JARs, select them, then click "Open".
* Expand the jar in the list, double-click "Native library location", type the directory where native library files are stored, and click "OK".
* Click "OK" to exit Preferences dialog.

=== Add JOGL to your project's dependencies ===

* Right-click your project in the Package Explorer and clock "Properties".
* Select "Java Build Path" and click the "Libraries" tab.
* Click "Add Library...", select "User Library", click "Next", check "JOGL", and click "Finish".
* Click "OK" to dismiss the Properties dialog.

That's it! You can now use the library in your project.

= IntelliJ IDEA =
=== Add JOGL dependency to project ===

* Click "File > Project Structure".
* Select "Modules" on the left, then click the "Dependencies" tab on the right.
* Click the "Add..." button, then click "Library...".
* Type "JOAL", "JOCL", "JOGL" or "GlueGen RT" as the library name.
* Click "Attach JAR Directories...", navigate to the directory where you extracted the JARs and click "OK".
* Click "OK" to dismiss the Configure Library dialog.
* Click "OK" to dismiss the Project Structure dialog.
* Click "Run > Edit Configurations".
* Type <tt>-Djava.library.path=your/path/to/native/library/files</tt> in the "VM Parameters" box.
* Click "OK" to dismiss the Run/Debug Configurations dialog.

That's it! You can now use the library in your project.

= NetBeans IDE =
=== Create a JOGL library dependency ===

* Right-click your project and click "Properties".
* Select "Libraries" on the left and click "Add Library...".
* Click the "Create" button, then type "JOAL", "JOCL", "JOGL" or "GlueGen RT" for the library name and click "OK".
* Click "Add JAR/Folder...", then navigate to the directory you extracted the JAR files, select them and click "Add JAR/Folder".
* Click "OK" to dismiss the Customize Library dialog.
* Click "Add Library" to dismiss the Add Library dialog.
* Click "OK" to dismiss the Project Properties dialog.
* Click "Run > Set Project Configuration > Customize...". Select "Run" on the left if it isn't selected already.
* Type <tt>-Djava.library.path=your/path/to/native/library/files</tt> in the "VM Options" box.
* Click "OK" to dismiss the Project Properties dialog.

That's it! You can now use the library in your project.

= Vi =
=== Open a shell of your choice ===
$vi <return>

That's it!

Main Page

2011-01-17T23:51:05Z

Mbien: generic IDE howto

__NOTOC__
{| width="100%"
|-
|
<div>
Welcome to the [{{SERVER}}/ JogAmp] wiki. It documents JOGL, JOCL and JOAL, the cross-platform bindings to the OpenGL, OpenCL, and OpenAL APIs.
</div>
|-
|
{| style="border: solid 1px #4e789d; width: 100%;"
|-
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Get started with JogAmp</h3>
*[[Downloading and installing JOGL|Download and install JOGL]]
*[[Setting up an JogAmp project in your favourite IDE|Setting up an JogAmp project in your favourite IDE]]
*[{{SERVER}}/forum.html Ask a question on our forum]
*[[Jogl FAQ#Bugreports & Testing|Report a bug]]
*[[chatroom|Jabber (XMPP) JogAmp Channel]]
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>The JogAmp community</h3>
*[[How to Contribute|Contribute to JogAmp]]
*[[Maintainer and Contacts]]
*[[Jogamp Versioning and Releases|Versioning and Releases]]
*[[Jogamp SCM Repositories|Source Code Repositories]]
*[{{SERVER}}/chuck/ Build and Test Server]
*[[SW Tracking|Tracking Reports]]
*[{{SERVER}}/bugzilla/ Bugzilla]
|}
|-
|

{| style="border: solid 1px #4e789d; width: 100%;"
|-
|colspan="2"|<h1>JogAmp Modules</h1>
|-
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>JOGL</h3>
*[[Jogl Overview|Overview]]
*[[Jogl Tutorial|Tutorial]]
*[[Jogl FAQ|FAQ]]
*[{{SERVER}}/git/?p=jogl.git;a=blob;f=LICENSE.txt License]
*API Doc [ [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc/ Public], Specs [ [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_nativewindow_spec/ Nativewindow], [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_jogl_spec/ JOGL] ], [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_dev/ Internal] ]
*[{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html JOGL Deployment]
*[{{SERVER}}/jogl/doc/HowToBuild.html How to Build JOGL]
*[{{SERVER}}/jogl/doc/userguide/ Simple Userguide] (not up2date)
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>JOCL</h3>
*[[JOCL Overview|Overview]]
*[[JOCL Tutorial|Tutorial]]
*[[JOCL FAQ|FAQ]]
*[{{SERVER}}/git/?p=jocl.git;a=blob;f=LICENSE License]
*[{{SERVER}}/deployment/jogamp-next/javadoc/jocl/javadoc/ API Doc]
*[{{SERVER}}/jocl/doc/HowToBuild.html How to Build JOCL]
|-
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>JOAL</h3>
*[[Joal Overview|Overview]]
*[[Joal Tutorial|Tutorial]]
*[[Joal FAQ|FAQ]]
*[{{SERVER}}/git/?p=joal.git;a=blob;f=LICENSE.txt License]
*API Doc [ [{{SERVER}}/deployment/jogamp-next/javadoc/joal/javadoc/ Public], [{{SERVER}}/deployment/jogamp-next/javadoc/joal/javadoc_dev/ Internal] ]
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>GlueGen</h3>
* [[GlueGen_Wiki|Overview]]
* [{{SERVER}}/git/?p=gluegen.git;a=blob;f=LICENSE.txt License]
* [{{SERVER}}/deployment/jogamp-next/javadoc/gluegen/javadoc/ API Doc]
|}

Setting up an Eclipse project that uses JOGL

2011-01-17T23:48:57Z

Mbien: moved Setting up an Eclipse project that uses JOGL to Setting up an JogAmp project in your favourite IDE

#REDIRECT [[Setting up an JogAmp project in your favourite IDE]]

Setting up a JogAmp project in your favorite IDE

2011-01-17T23:48:57Z

Mbien: moved Setting up an Eclipse project that uses JOGL to Setting up an JogAmp project in your favourite IDE

__TOC__

It's very simple to set up a project of your favourite IDE to use a JogAmp library. These instructions assume you've already created a new project in the IDE.

= Download a JogAmp project =

If you haven't done so already, download and extract for example JOGL as described at [[Downloading_and_installing_JOGL]].

To be able to use a JogAmp library you will have to add the jar files to the classpath and the native files to the library path of your projects run configuration.
Please note that all projects depend on the GlueGen runtime libraries which are for convenience reasons included in every JogAmp project but only required once in the classpath/library path of your application.

= Eclipse IDE =
=== Create a user library ===

You can make your new Eclipse project depend directly on all the JARs and native libraries, but it's inconvenient to do that every time you create a new project. Creating a user library bundles all the files together so you can include them in one step.

* Click "Window > Preferences", then select "Java > Build Path > User Libraries" on the left.
* Click the "New..." button, type "JOAL", "JOCL", "JOGL" or "GlueGen RT" for the library name, and click "OK".
* Click the "Add JARs..." button, navigate to the directory where you've stored the JARs, select them, then click "Open".
* Expand the jar in the list, double-click "Native library location", type the directory where native library files are stored, and click "OK".
* Click "OK" to exit Preferences dialog.

=== Add JOGL to your project's dependencies ===

* Right-click your project in the Package Explorer and clock "Properties".
* Select "Java Build Path" and click the "Libraries" tab.
* Click "Add Library...", select "User Library", click "Next", check "JOGL", and click "Finish".
* Click "OK" to dismiss the Properties dialog.

That's it! You can now use the library in your project.

= IntelliJ IDEA =
=== Add JOGL dependency to project ===

* Click "File > Project Structure".
* Select "Modules" on the left, then click the "Dependencies" tab on the right.
* Click the "Add..." button, then click "Library...".
* Type "JOAL", "JOCL", "JOGL" or "GlueGen RT" as the library name.
* Click "Attach JAR Directories...", navigate to the directory where you extracted the JARs and click "OK".
* Click "OK" to dismiss the Configure Library dialog.
* Click "OK" to dismiss the Project Structure dialog.
* Click "Run > Edit Configurations".
* Type <tt>-Djava.library.path=your/path/to/native/library/files</tt> in the "VM Parameters" box.
* Click "OK" to dismiss the Run/Debug Configurations dialog.

That's it! You can now use the library in your project.

= NetBeans IDE =
=== Create a JOGL library dependency ===

* Right-click your project and click "Properties".
* Select "Libraries" on the left and click "Add Library...".
* Click the "Create" button, then type "JOAL", "JOCL", "JOGL" or "GlueGen RT" for the library name and click "OK".
* Click "Add JAR/Folder...", then navigate to the directory you extracted the JAR files, select them and click "Add JAR/Folder".
* Click "OK" to dismiss the Customize Library dialog.
* Click "Add Library" to dismiss the Add Library dialog.
* Click "OK" to dismiss the Project Properties dialog.
* Click "Run > Set Project Configuration > Customize...". Select "Run" on the left if it isn't selected already.
* Type <tt>-Djava.library.path=your/path/to/native/library/files</tt> in the "VM Options" box.
* Click "OK" to dismiss the Project Properties dialog.

That's it! You can now use the library in your project.

= Vi =
=== Open a shell of your choice ===
$vi <return>

That's it!

Setting up a JogAmp project in your favorite IDE

2011-01-17T23:48:18Z

Mbien: joined with intellij and netbeans howto + made more generic to apply for all jogamp projects

Main Page

2010-12-31T12:35:28Z

Mbien: fixed bullets

<b> Main page for all [{{SERVER}}/ JOGAMP] projects</b>

__TOC__

== Community ==
* [[How to Contribute]]
* [[Jogl FAQ#Bugreports & Testing|Bug Reporting]]
* [[chatroom|Jabber (XMPP) JogAmp Channel]]
* [{{SERVER}}/forum.html Forums & Mailinglists]

== SW Management ==
* [[Maintainer and Contacts]]
* [[Jogamp Versioning and Releases|Versioning and Releases]]
* [[Jogamp SCM Repositories|Source Code Repositories]]
* [{{SERVER}}/chuck/ Build and Test Server]
* Bug Tracking
** [[SW Tracking|Tracking Reports]]
** [{{SERVER}}/bugzilla/ Bugzilla]

== Modules ==

=== GlueGen ===
* [[GlueGen_Wiki|Overview]]
* [{{SERVER}}/git/?p=gluegen.git;a=blob;f=LICENSE.txt License]
* [{{SERVER}}/deployment/jogamp-next/javadoc/gluegen/javadoc/ API Doc]

=== JOAL ===
* [[Joal Overview|Overview]]
* [[Joal Tutorial|Tutorial]]
* [[Joal FAQ|FAQ]]
* [{{SERVER}}/git/?p=joal.git;a=blob;f=LICENSE.txt License]
* API Doc [ [{{SERVER}}/deployment/jogamp-next/javadoc/joal/javadoc/ Public], [{{SERVER}}/deployment/jogamp-next/javadoc/joal/javadoc_dev/ Internal] ]

=== JOGL ===
* [[Jogl Overview|Overview]]
* [[Jogl Tutorial|Tutorial]]
* [[Jogl FAQ|FAQ]]
* [{{SERVER}}/git/?p=jogl.git;a=blob;f=LICENSE.txt License]
* API Doc [ [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc/ Public], Specs [ [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_nativewindow_spec/ Nativewindow], [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_jogl_spec/ JOGL] ], [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_dev/ Internal] ]
* [{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html JOGL Deployment]
* [{{SERVER}}/jogl/doc/HowToBuild.html How to Build JOGL]
* [{{SERVER}}/jogl/doc/userguide/ Simple Userguide] (not up2date)

=== JOCL ===
* [[JOCL Overview|Overview]]
* [[JOCL Tutorial|Tutorial]]
* [[JOCL FAQ|FAQ]]
* [{{SERVER}}/git/?p=jocl.git;a=blob;f=LICENSE License]
* [{{SERVER}}/deployment/jogamp-next/javadoc/jocl/javadoc/ API Doc]
* [{{SERVER}}/jocl/doc/HowToBuild.html How to Build JOCL]

Jogl Tutorial

2010-12-31T12:32:29Z

Mbien: removed jogl 1.x link

* JOGL with IDEs
** Eclipse
*** [http://ramisantina.blogspot.com/2010/08/creating-jogl-eclipse-project.html Rami's Guide how to setup a JOGL Eclipse project]
*** [http://wadeawalker.wordpress.com/2010/10/09/tutorial-a-cross-platform-workbench-program-using-java-opengl-and-eclipse/ Wade's Cross Platform Workbench Program using Eclipse and JOGL]
*** [http://wadeawalker.wordpress.com/2010/10/24/tutorial-creating-native-binary-executables-for-multi-platform-java-apps-with-opengl-and-eclipse-rcp/ Wade's Creating native binary executables for multi-platform Java apps with OpenGL and Eclipse RCP]
** Netbeans
*** Netbeans project configurations are included in the source, hence you just can load them in NB ..

* [https://sites.google.com/site/justinscsstuff/jogl-tutorials Justin's Getting Started with JOGL 2 Tutorials]
** [https://sites.google.com/site/justinscsstuff/jogl-tutorial-1 JOGL Tutorial 1 - Environment Setup]
** [https://sites.google.com/site/justinscsstuff/jogl-tutorial-2 JOGL Tutorial 2 - Creating a Window]
** [https://sites.google.com/site/justinscsstuff/jogl-tutorial-3 JOGL Tutorial 3 - Creating a Render Loop]


* [http://wadeawalker.wordpress.com/2010/10/17/tutorial-faster-rendering-with-vertex-buffer-objects/ Wade's Faster rendering with vertex buffer objects]

* [http://leolol.com/tutorials/graphics_tutorials.html LeoLoL.com Tutorials]
** [http://leolol.com/tutorials/graphics/lesson01.html Lesson 1 - Setting up a JOGL Template]
** [http://leolol.com/tutorials/graphics/lesson02.html Lesson 2 - Drawing basic 2D shapes]
** [http://leolol.com/tutorials/graphics/lesson03.html Lesson 3 - Adding colour]
** [http://leolol.com/tutorials/graphics/lesson04.html Lesson 4 - 3D Shapes and Rotation]

* Courses
** [http://www.informatik.uni-oldenburg.de/~trigger/opengl_course.html Johannes's Courses at University of Oldenburg (German)]

(The old (not quite up2date) JOGL Userguide is currently available [http://jogamp.org/jogl/doc/userguide/ here])

Jogl Tutorial

2010-12-31T12:21:56Z

Mbien: updated link

* JOGL with IDEs
** Eclipse
*** [http://ramisantina.blogspot.com/2010/08/creating-jogl-eclipse-project.html Rami's Guide how to setup a JOGL Eclipse project]
*** [http://wadeawalker.wordpress.com/2010/10/09/tutorial-a-cross-platform-workbench-program-using-java-opengl-and-eclipse/ Wade's Cross Platform Workbench Program using Eclipse and JOGL]
*** [http://wadeawalker.wordpress.com/2010/10/24/tutorial-creating-native-binary-executables-for-multi-platform-java-apps-with-opengl-and-eclipse-rcp/ Wade's Creating native binary executables for multi-platform Java apps with OpenGL and Eclipse RCP]
** Netbeans
*** Netbeans project configurations are included in the source, hence you just can load them in NB ..
* [https://sites.google.com/site/justinscsstuff/jogl-tutorials Justin's Getting Started with JOGL 2 Tutorials]
** [https://sites.google.com/site/justinscsstuff/jogl-tutorial-1 JOGL Tutorial 1 - Environment Setup]
** [https://sites.google.com/site/justinscsstuff/jogl-tutorial-2 JOGL Tutorial 2 - Creating a Window]
** [https://sites.google.com/site/justinscsstuff/jogl-tutorial-3 JOGL Tutorial 3 - Creating a Render Loop]
* [http://www.felixgers.de/teaching/jogl/ Felix's OpenGL and JOGL]
* [http://wadeawalker.wordpress.com/2010/10/17/tutorial-faster-rendering-with-vertex-buffer-objects/ Wade's Faster rendering with vertex buffer objects]
* [http://leolol.com/tutorials/graphics_tutorials.html LeoLoL.com Tutorials]
** [http://leolol.com/tutorials/graphics/lesson01.html Lesson 1 - Setting up a JOGL Template]
** [http://leolol.com/tutorials/graphics/lesson02.html Lesson 2 - Drawing basic 2D shapes]
** [http://leolol.com/tutorials/graphics/lesson03.html Lesson 3 - Adding colour]
** [http://leolol.com/tutorials/graphics/lesson04.html Lesson 4 - 3D Shapes and Rotation]
* [http://www.informatik.uni-oldenburg.de/~trigger/opengl_course.html Johannes's Courses at University of Oldenburg (German)]

(The old (not quite up2date) JOGL Userguide is currently available [http://jogamp.org/jogl/doc/userguide/ here])

JOCL Overview

2010-11-23T16:29:09Z

Mbien: initial version

Jogl Tutorial

2010-10-10T12:23:13Z

Mbien: /* Setting up JOGL */

== Justin's getting started with JOGL 2 tutorials ==
* [https://sites.google.com/site/justinscsstuff/jogl-tutorials index]
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-1 JOGL Tutorial 1 - Environment Setup]
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-2 JOGL Tutorial 2 - Creating a Window]
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-3 JOGL Tutorial 3 - Creating a Render Loop]

== Tutorials on LeoLoL.com ==
* [http://leolol.com/tutorials/graphics_tutorials.html index]
* [http://leolol.com/tutorials/graphics/lesson01.html Lesson 1 - Setting up a JOGL Template]
* [http://leolol.com/tutorials/graphics/lesson02.html Lesson 2 - Drawing basic 2D shapes]
* [http://leolol.com/tutorials/graphics/lesson03.html Lesson 3 - Adding colour]
* [http://leolol.com/tutorials/graphics/lesson04.html Lesson 4 - 3D Shapes and Rotation]

== RCP tutorials ==
* [http://wadeawalker.wordpress.com/2010/10/09/tutorial-a-cross-platform-workbench-program-using-java-opengl-and-eclipse/ Wade Walker's Cross Platform Workbench Program using Eclipse and JOGL]

== Setting up JOGL ==
* [http://ramisantina.blogspot.com/2010/08/creating-jogl-eclipse-project.html Rami Santina's Guide how to setup a JOGL Eclipse project]

(The old (not quite up2date) JOGL Userguide is currently available [http://jogamp.org/jogl/doc/userguide/ here])

Jogl Tutorial

2010-10-10T12:21:42Z

Mbien: new section for "how to setup jogl" links

== Justin's getting started with JOGL 2 tutorials ==
* [https://sites.google.com/site/justinscsstuff/jogl-tutorials index]
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-1 JOGL Tutorial 1 - Environment Setup]
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-2 JOGL Tutorial 2 - Creating a Window]
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-3 JOGL Tutorial 3 - Creating a Render Loop]

== Tutorials on LeoLoL.com ==
* [http://leolol.com/tutorials/graphics_tutorials.html index]
* [http://leolol.com/tutorials/graphics/lesson01.html Lesson 1 - Setting up a JOGL Template]
* [http://leolol.com/tutorials/graphics/lesson02.html Lesson 2 - Drawing basic 2D shapes]
* [http://leolol.com/tutorials/graphics/lesson03.html Lesson 3 - Adding colour]
* [http://leolol.com/tutorials/graphics/lesson04.html Lesson 4 - 3D Shapes and Rotation]

== RCP tutorials ==
* [http://wadeawalker.wordpress.com/2010/10/09/tutorial-a-cross-platform-workbench-program-using-java-opengl-and-eclipse/ Wade Walker's Cross Platform Workbench Program using Eclipse and JOGL]

== Setting up JOGL ==
* [http://ramisantina.blogspot.com/2010/08/creating-jogl-eclipse-project.html Rami Santina's Guide to build JOGL with Eclipse]

(The old (not quite up2date) JOGL Userguide is currently available [http://jogamp.org/jogl/doc/userguide/ here])

Jogl Tutorial

2010-10-09T15:08:55Z

Mbien: eclipse RCP link

== Justin's getting started with JOGL 2 tutorials ==
* [https://sites.google.com/site/justinscsstuff/jogl-tutorials index]
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-1 JOGL Tutorial 1 - Environment Setup]
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-2 JOGL Tutorial 2 - Creating a Window]
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-3 JOGL Tutorial 3 - Creating a Render Loop]

== Tutorials on LeoLoL.com ==
* [http://leolol.com/tutorials/graphics_tutorials.html index]
* [http://leolol.com/tutorials/graphics/lesson01.html Lesson 1 - Setting up a JOGL Template]
* [http://leolol.com/tutorials/graphics/lesson02.html Lesson 2 - Drawing basic 2D shapes]
* [http://leolol.com/tutorials/graphics/lesson03.html Lesson 3 - Adding colour]
* [http://leolol.com/tutorials/graphics/lesson04.html Lesson 4 - 3D Shapes and Rotation]

== RCP tutorials ==
* [http://wadeawalker.wordpress.com/2010/10/09/tutorial-a-cross-platform-workbench-program-using-java-opengl-and-eclipse/ Eclipse RCP]

(The old (not quite up2date) JOGL Userguide is currently available [http://jogamp.org/jogl/doc/userguide/ here])

Chatroom

2010-09-26T23:42:14Z

Mbien: /* Jabber (XMPP) JogAmp Channel */

== Jabber (XMPP) JogAmp Channel ==
: url: conference.jabber.org
: room: jogamp

== New to XMPP? ==
* [http://xmpp.org/services/ public servers]
* [http://xmpp.org/xmpp-software/clients/ clients]

Jogl Tutorial

2010-09-11T18:35:12Z

Mbien: /* Tutorials on LeoLoL.com */

== Justin's getting started with JOGL 2 tutorials ==
* [https://sites.google.com/site/justinscsstuff/jogl-tutorials index]
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-1 JOGL Tutorial 1 - Environment Setup]
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-2 JOGL Tutorial 2 - Creating a Window]
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-3 JOGL Tutorial 3 - Creating a Render Loop]

== Tutorials on LeoLoL.com ==
* [http://leolol.com/tutorials/graphics_tutorials.html index]
* [http://leolol.com/tutorials/graphics/lesson01.html Lesson 1 - Setting up a JOGL Template]
* [http://leolol.com/tutorials/graphics/lesson02.html Lesson 2 - Drawing basic 2D shapes]
* [http://leolol.com/tutorials/graphics/lesson03.html Lesson 3 - Adding colour]
* [http://leolol.com/tutorials/graphics/lesson04.html Lesson 4 - 3D Shapes and Rotation]

(The old (not quite up2date) JOGL Userguide is currently available [http://jogamp.org/jogl/doc/userguide/ here])

Jogl Tutorial

2010-09-11T18:30:50Z

Mbien: /* Justin's getting started with JOGL 2 tutorials: */

Main Page

2010-08-30T13:05:22Z

Mbien: removed SW tracking link, added bugzilla

<b> Main page for all [http://jogamp.org JOGAMP] projects</b>

== Community ==
* [[How to Contribute]]
* [[chatroom|Jabber (XMPP) JogAmp Channel]]
* [http://jogamp.org/forum.html Forums && Mailinglists]

== Teamplayers ==
* JOGL
** [[Jogl Overview|Overview]]
** [[Jogl Tutorial|Tutorial]]
** [[Jogl FAQ|FAQ]]
** [http://jogamp.org/jogl/doc/deployment/JOGL-DEPLOYMENT.html JOGL Deployment]
** [http://jogamp.org/jogl/doc/HowToBuild.html How to Build JOGL]
** [http://jogamp.org/jogl/doc/userguide/ Simple Userguide] (not up2date)

* JOCL
** [[JOCL Overview|Overview]]
** [[JOCL Tutorial|Tutorial]]
** [[JOCL FAQ|FAQ]]
** [http://jogamp.org/jocl/doc/HowToBuild.html How to Build JOCL]

* [[GlueGen_Wiki|GlueGen]]

== SW Management ==
* [http://jogamp.org/chuck/ Build Server]
* [http://jogamp.org/bugzilla/ Bugzilla]

Jogl Tutorial

2010-08-30T13:01:09Z

Mbien: added links to Justin's tutorials

== Justin's getting started with JOGL 2 tutorials: ==
* [https://sites.google.com/site/justinscsstuff/jogl-tutorials index]
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-1 JOGL Tutorial 1 - Environment Setup]
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-2 JOGL Tutorial 2 - Creating a Window]
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-3 JOGL Tutorial 3 - Creating a Render Loop]

(The old (not quite up2date) JOGL Userguide is currently available [http://jogamp.org/jogl/doc/userguide/ here])

Chatroom

2010-08-07T14:01:43Z

Mbien: Created page with '== Jabber (XMPP) JogAmp Channel == : url: conference.jabber.org : room: jogamp'

== Jabber (XMPP) JogAmp Channel ==
: url: conference.jabber.org
: room: jogamp

Main Page

2010-08-07T13:57:26Z

Mbien: chatroom

<b> Main page for all [http://jogamp.org JOGAMP] projects</b>

== Community ==
* [[How to Contribute]]
* [[chatroom|Jabber (XMPP) JogAmp Channel]]
* [http://jogamp.org/forum.html Forums && Mailinglists]

== Teamplayers ==
* JOGL
** [[Jogl Overview|Overview]]
** [[Jogl Tutorial|Tutorial]]
** [[Jogl FAQ|FAQ]]
** [http://jogamp.org/jogl/doc/deployment/JOGL-DEPLOYMENT.html JOGL Deployment]
** [http://jogamp.org/jogl/doc/HowToBuild.html How to Build JOGL]
** [http://jogamp.org/jogl/doc/userguide/ Simple Userguide]

* JOCL
** [[JOCL Overview|Overview]]
** [[JOCL Tutorial|Tutorial]]
** [[JOCL FAQ|FAQ]]
** [http://jogamp.org/jocl/doc/HowToBuild.html How to Build JOCL]

* [[GlueGen_Wiki|GlueGen]]

== SW Management ==
* [[SW Tracking]] Main Page
* [http://jogamp.org/chuck/ Build Server]

Jogl FAQ

2010-07-12T15:39:37Z

Mbien: added Using OpenGL without a visible component

<b>JOGL FAQ</b>

__TOC__

== Common Runtime Problems ==

=== X11: OpenGL library is not picked up correctly, no OpenGL available ===

In case you are running a DRI machine, eg ATI's proprietary driver or
an open source one, you may need to ensure that the environment variable '''LIBGL_DRIVERS_PATH'''
is set properly.

I ran into this while testing the 32bit builds on a 64bit machine
as a different user. Since '''LIBGL_DRIVERS_PATH''' is only setup for the desktop user
on Ubuntu, some ''/etc/X11/Xsession.d/'' script, I couldn't get a GL context to work.

So I had to set mine to the value:
export LIBGL_DRIVERS_PATH=/usr/lib/fglrx/dri:/usr/lib32/fglrx/dri

See also:
[https://bugs.launchpad.net/ubuntu/+source/fglrx-installer/+bug/250944 Ubuntu fglrx bug entry]

== Get the Source Code ==

Create a local copy/branch of the git repository,
either anonymous:

* git clone git://github.com/sgothel/gluegen.git gluegen
* git clone git://github.com/sgothel/jogl.git jogl
* git clone git://github.com/sgothel/jogl-demos.git jogl-demos

or via SSH and your user credential, so you can easily push back your
changes to the github server:

* git clone git@github.com:username/gluegen.git gluegen
* git clone git@github.com:username/jogl.git jogl
* git clone git@github.com:username/jogl-demos.git jogl-demos

== [http://jogamp.org/jogl/doc/HowToBuild.html How to build] ==

== How to participate and use git ==

Yes, gluegen, jogl and all the stuff has been [http://blog.jausoft.com/2009/07/08/svn-to-git-migration-1/ migrated to git],
thanks to the great git toolchain.

In the past we were using a centralized repository only, ''SVN'',
and you really needed access to it as a developer.

Thanks to the distributed nature of git, this is no more a real issue.
The only thing left is to provide a media to offer your branch to one of us,
this can be via [http://www.kernel.org/pub/software/scm/git/docs/everyday.html#Individual%20Developer%20%28Participant%29 email], [http://weblog.masukomi.org/wp-content/uploads/2008/03/config_remote_repo.svg http], [http://kernel.org/pub/software/scm/git/docs/howto/use-git-daemon.txt git], ssh, whatever you wish - it's easy.
For bigger projects maintained in a branch or if you don't have your own public server
to offer yours, ''we are pleased to grant you write access'' to our repository!

However, '''don't just modify the master branch without our permission''',
or any other existing branch which is not assigned to you!
''We will just trust you here'', but if you misbehave, your privileges will be removed.
Instead, '''create a branch of your own and push it to the server''', then you will ask
one of us to pull your branch, which we will verify and merge, if it's fine. Thanks to git, this is so easy now.
And this is the current way [http://whygitisbetterthanx.com/#any-workflow how you collaborate] using a [http://whygitisbetterthanx.com/#distributed distributed SCM].

== How to develop Cross-Device Applications ==
First you have to pick your lowest common denominator of an OpenGL profile, ie OpenGL ES1 or ES2.
For either we offer an intersecting desktop GL profile, GL2ES1 or GL2ES2.
Use the latter while creating your GLCapabilities.
Build and run your application with the minimum GL profile JARS, e.g. on the desktop use:

~/jogl-demos> . ./setenv-jogl.sh JOGL_GL2ES12_MIN ../jogl/build

Here you are on a Unix platform (not Window) and your common build subdirectory is 'build'.
''jogl-demos/setenv-jogl.sh'' is provided within ''jogl-demos'', which itself utilizes ''jogl/etc/profile.jogl''.

This uses the GlueGen/JOGL JARS:
* gluegen-rt.jar
* nativewindow.core.jar
* jogl.core.jar
* jogl.util.jar
* jogl.gl2es12.x11.jar
* jogl.util.fixedfuncemu.jar
* newt.core.jar
* newt.ogl.jar

On a mobile device using CVM, you would use:
* gluegen-rt-cdc.jar
* nativewindow.core.cdc.jar
* jogl.core.cdc.jar
* jogl.util.cdc.jar
* jogl.egl.cdc.jar
* jogl.gles1.cdc.jar or jogl.gles2.cdc.jar
* jogl.util.fixedfuncemu.cdc.jar
* newt.core.cdc.jar
* newt.ogl.cdc.jar

Please check [http://jogamp.org/jogl/doc/deployment/JOGL-DEPLOYMENT.html JOGL Deployment] also.

Now, the same Java application shall run on all devices, desktop and mobile.
See ''demos.es1.RedSquare'' of the ''jogl-demos'' repository.

On the desktop you may run the ES1 demo:

~/jogl-demos> sh java-run-newt.sh demos.es1.RedSquare -GL2ES1

and the output is:
null RedSquare.run() 0
User screen size 0x0
Detected screen size 1920x1200
GLProfile[GL2ES1/GL2ES12] Entering initialization
GLProfile[GL2ES1/GL2ES12] GL Profile: GLProfile[GL2ES1/GL2ES12]
GLProfile[GL2ES1/GL2ES12] GL:com.sun.opengl.impl.gl2es12.GL2ES12Impl@b815859
GLProfile[GL2ES1/GL2ES12] GL_VERSION=3.0.0 NVIDIA 185.18.14
GLProfile[GL2ES1/GL2ES12] GL_EXTENSIONS: ..

== What are the Runtime OpenGL Version Requirements ? ==
The current JOGL2 spec is in WIP state, but mostly finished.
We do not require any extra features of GL versions > 1.1,
hence it shall just work.

E.g. if you want to
* support OpenGL platforms not supporting a version > 1.2
* use GL ≥ 1.3 features optionally
Just query their availability e.g.:
gl.isExtensionAvailable("GL_VERSION_1_3")

If you call a > 1.2 GL function where it is not available,
a GLException is thrown.

'''JOGL requires at least an OpenGL version 1.1''',
due to it's dynamical function binding starting with OpenGL 1.2.

== Bugreports & Testing ==
For all bug reports, please add the following information to your email:
* Test case
** Source code, or reference to it
** Invocation command-line
* Platform
** OS & version
** Architecture
** Java version (java -version)
* JOGL Source/build versions
** GIT revision incl. URL and/or
** Autobuild version (date, filename and URL)
** Exceptions, stdout/stderr log file

If possible, please add the following system properties to enable DEBUG logging:
''-Dnewt.debug=all -Dnativewindow.debug=all -Djogl.debug=all''

For example:

java -Djava.awt.headless=true -Dnewt.debug=all -Dnativewindow.debug=all \
-Djogl.debug=all demos.es2.RedSquare 2>&1 | tee RedSquare.report.log

To test applets use the jcontrol panel or edit ''~/.java/deployment.properties'' directly and

* Add JRE Arguments: <pre>-Djava.awt.headless=true -Dnewt.debug=all -Dnativewindow.debug=all -Djogl.debug=all</pre>
* Enable logging/trace
* Show the console window, or just use th latest log-file in <pre>~/.java/deployment/log/</pre>

== Test Autobuilds & Shell Scripts ==
I like to summarize how to manually test the JOGL autobuilds, starting with 2009-07-02.

The general nightly download sites are
* http://download.java.net/media/jogl/builds/nightly/

Let’s assume we are in the test directory ‘test’, from which we operate from this point.

* Get [http://download.java.net/media/jogl/builds/nightly/jogl-demos.zip jogl-demos.zip]. Extract the archive, i.e. <pre>unzip jogl-demos.zip</pre>

* Get [http://download.java.net/media/jogl/builds/nightly/ jogl-2.0-pre-20090702-linux-amd64.zip]. In case we have build a reference implementation (RI) the substring ‘pre-yyyymmdd-’ will be dropped. Replace the version 2.0 with the latest available and the OS/arch linux-amd64 with your test platform. Extract the archive, ie <pre>unzip jogl-2.0-pre-20090702-linux-amd64.zip</pre>. Create a symbolic link or rename the archive directory from ''jogl-2.0-pre-20090702-linux-amd64'' to ''jogl'', ie <pre>ln -s jogl-2.0-pre-20090702-linux-amd64 jogl</pre>.
* If you like to test the binding to NV’s Cg, [http://developer.nvidia.com/object/cg_download.html download and install]

We assume java is in your binary search path.

On X11/Unix and MaxOSX you can test the build as follows:

sh java-run-newt.sh demos.es2.RedSquare -GL2 -GL2 -GL2
sh java-run.sh demos.gears.Gears

and with debug output

sh java-dbg-newt.sh demos.es2.RedSquare -GL2 -GL2 -GL2
sh java-dbg.sh demos.gears.Gears

On Windows you shall be able to run:

java-win32.bat demos.es2.RedSquare -GL2 -GL2 -GL2
java-win32.bat demos.gears.Gears

and with debug output

java-win32-dbg.bat demos.es2.RedSquare -GL2 -GL2 -GL2
java-win32-dbg.bat demos.gears.Gears

The windows scripts are pretty simple and flat.

The magic unix scripts offer more features and can be used either in the autobuild environment or in your development one.
* <pre>setenv-jogl.sh <JOGL-PROFILE> [<jogl-build-dir>]</pre>
Looks up and invokes profile.jogl, finds gluegen, sets the environment variables (CLASSPATH, LD_LIBRARY_PATH & PATH).
* <pre>jogl/etc/profile.jogl <JOGL-PROFILE> [<jogl-build-dir>]</pre>
JOGL profiles are one of JOGL_ALL, JOGL_ES1_MIN, JOGL_ES1_MAX, JOGL_ES2_MIN, JOGL_ES2_MAX,
JOGL_GL2ES12_MIN, JOGL_GL2ES12_MAX, JOGL_GL2_MIN, JOGL_GL2_MAX.
Looks up the set of JAR files necessary to satisfy the chosen JOGL-PROFILE.

This allows you to test a specific environment, ie ES2 without GL2 and AWT, using JOGL_ES2_MIN.
For this case I would recommend the native ES2 implementation from imageon SDK_OGLES2_LINUX_PCEMULATION_2.02.22.0756.

== How to use JOGL in Applets (part 1) ==
A Java Applet using JOGL may utilize 2 methods
* [https://jdk6.dev.java.net/plugin2/jnlp/ New JNLP Applet]
* [https://applet-launcher.dev.java.net/ Applet-Launcher]

Standard JNLP Applets are supported starting with Java 6u14, however, if you run MacOSX or an older version of Java,
you may need to use the Applet-Launcher.

Below we utilize both, the standard JNLP mechanism of 6u14 as the default,
or falling back to our Applet-Launcher.

You will find the JNLP file applet-gears.jnlp further below, which is being used in case of a JNLP launch,
otherwise it is ignored and the archive tags are being used, hence the applet-launcher will be started.

The below demo is [http://download.java.net/media/jogl/demos/www/applettest-jnlp.html online here].

Note: It is important for the startup time to have the same JVM arguments in the applet tags,
as well as within the JNLP applet description, here see property sun.java2d.noddraw.
Only if JVM arguments of the JNLP applet description are satisfied by the applet tag’s JVM,
the plugin will not need to start a new JVM. OF course, the applet tag’s JVM spec may exceed the JNLP applet’s one.

Note: A bug on MacOSX is known, launching 2 JOGL applets in 2 tabs.

<pre>
<applet code="org.jdesktop.applet.util.JNLPAppletLauncher"
width=600
height=400
archive="http://download.java.net/media/applet-launcher/applet-launcher.jar,
http://download.java.net/media/jogl/jsr-231-2.x-webstart/nativewindow.all.jar,
http://download.java.net/media/jogl/jsr-231-2.x-webstart/jogl.all.jar,
http://download.java.net/media/gluegen/webstart-2.x/gluegen-rt.jar,
http://download.java.net/media/jogl/jsr-231-2.x-demos-webstart/jogl-demos.jar">
<param name="codebase_lookup" value="false">
<param name="subapplet.classname" value="demos.applets.GearsApplet">
<param name="subapplet.displayname" value="JOGL Gears Applet">
<param name="noddraw.check" value="true">
<param name="progressbar" value="true">
<param name="jnlpNumExtensions" value="1">
<param name="jnlpExtension1"
value="http://download.java.net/media/jogl/jsr-231-2.x-webstart/jogl-core.jnlp">
<param name="java_arguments" value="-Dsun.java2d.noddraw=true">
<param name="jnlp_href" value="applet-gears.jnlp">
</applet>
</pre>

Where the referenced JNLP file applet-gears.jnlp looks as follow:

<pre>
<?xml version="1.0" encoding="utf-8"?>
<jnlp href="applet-gears.jnlp">
<information>
<title>JOGL JNLP Applet Gears Demo</title>
<vendor>Sun Microsystems, Inc.</vendor>
<homepage href="http://jogl-demos.dev.java.net/"/>
<description>Gears Demo</description>
<description kind="short">Brian Paul's Gears demo ported to Java and JOGL.</description>
<offline-allowed/>
</information>

<resources>
<j2se href="http://java.sun.com/products/autodl/j2se" version="1.4+"/>
<property name="sun.java2d.noddraw" value="true"/>
<jar href="http://download.java.net/media/jogl/jsr-231-2.x-demos-webstart/jogl-demos.jar" main="true"/>
<jar href="http://download.java.net/media/jogl/jsr-231-2.x-demos-webstart/jogl-demos-util.jar"/>
<extension name="jogl-all-awt" href="http://download.java.net/media/jogl/jsr-231-2.x-webstart/jogl-all-awt.jnlp" />
</resources>

<applet-desc
name="Gears-Applet"
main-class="demos.applets.GearsApplet"
width="640"
height="480">
</applet-desc>
</jnlp>
</pre>

== What is ''Newt's'' Threading Model for native window events ? ==
As of today, Newt's default threading model to handle native events
is the event dispatch thread (EDT) model.

It's introduction was necessary to allow a 'peace of mind',
high performance and reactive solution of the dispatch event problem.
Some OS, especially MS-Windows, require one to create the native Window
and dispatch it's events from the same native thread.
As it was easy to handle these requirements from a simple test application,
as it is difficult to solve this from a framework operating with multiple temporary threads,
a web browser for example.

Newt's EDT impl. creates one EDT per Display and calling thread,
as the Display instance is unique per thread.

Using EDT is not mandatory, and you can turn it off in the NewtFactory,
and deal with the event dispatch manually.

== How to use ''Newt'' with multiple Windows & Threads ==
Newt is capable of handling multiple threads and windows.

For best performance, you may create one thread per window, if possible.

Below you see the invocation of the ES2 RedSquare jogl-demos utilizing multiple threads.

* Single thread (Unix, Win32) <pre>java -Djava.awt.headless=true demos.es2.RedSquare -GL2</pre>
* Single thread (MacOSX) <pre>java -XstartOnFirstThread -Djava.awt.headless=true demos.es2.RedSquare -GL2</pre>
* Multiple threads & windows (Unix, Win32) <pre>java -Djava.awt.headless=true demos.es2.RedSquare -GL2 -GL2 -GL2 -GL2</pre>
* Multiple threads & windows (MacOSX) <pre>java -XstartOnFirstThread -Djava.awt.headless=true com.sun.javafx.newt.util.MainThread demos.es2.RedSquare -GL2 -GL2 -GL2 -GL2</pre>

The serialization of the main Java class through ''com.sun.javafx.newt.util.MainThread''
may be used for all platforms, since it only takes effect on ''MacOSX''.
This allows you an almost platform independent invocation of your multithreaded Java applications.

On ''MacOSX'', ''com.sun.javafx.newt.util.MainThread'' will occupy the main thread and
serializes all native window related tasks through it.
This mechanism is thread safe utilizes reentrant locking.

== Why using AWT for high performance is not a good idea ? ==

AWT (on many implementations) holds the lock to the underlying native resources,
e.g. X11 display, screen and window surface, hence we have to obey these
locks for any GL action bound to such.

This is still pretty standard matter as long these locks only have to be applied to
the actual resource in use.

On AWT, it turns out that we have to use the global JAWT toolkit lock
for any native operation, ie OpenGL.
This might not be a problem for a single threaded GL application,
but if you start a multithreaded beast, you will recognize that it will
stumble around.

You can verify this behavior with the ES1 RedSquare demo:

* AWT - No VSync - One Thread
<pre>
java demos.es1.RedSquare -awt -swapi 0 -GL2
5s: 3379f, 675 fps, 1 ms/f; total: 5s, 675 fps, 1 ms/f
</pre>
Even here you may experience some stuttering ..

If you force disabling the toolkit lock:
<pre>
java -Dnativewindow.nolocking=true demos.es1.RedSquare -awt -swapi 0 -GL2
</pre>
The demo may freeze forever .. due to native locking.

* NEWT - No VSync - One Thread
<pre>
java -Djava.awt.headless=true demos.es1.RedSquare -swapi 0 -GL2
5s: 5958f, 1191 fps, 0 ms/f; total: 5s, 1191 fps, 0 ms/f
</pre>
Runs much smoother .. without the stuttering locking experience ..

This becomes much clearer with more threads:

* AWT - No VSync - Three Threads
<pre>
java demos.es1.RedSquare -awt -swapi 0 -GL2 -GL2 -GL2
5s: 772f, 151 fps, 6 ms/f; total: 5s, 151 fps, 6 ms/f
</pre>

* NEWT - No VSync - Three Threads
<pre>
java -Djava.awt.headless=true demos.es1.RedSquare -swapi 0 -GL2 -GL2 -GL2
5s: 1669f, 333 fps, 2 ms/f; total: 5s, 333 fps, 2 ms/f
</pre>

== Why using Swing for high performance is not a good idea ? ==
First, all this inherents all arguments from '''Why using AWT for high performance is not a good idea ?''

Second, it involves compositioning using different methods,
some may not be available on some platforms.

From fast to slow:

<h5> 1.) External Java2D's GLContext and FBO object. </h5>
* GL stuff HW accelerated.
* Available on some platforms: Linux/Windows Sun's Java2D impl.
* Setup with System property 'sun.java2d.opengl' to 'true'.
* Renders directly into Java2D's FBO object, if available.

<h5> 2.) Own PBuffer GLContext, which has to be composed. </h5>
* GL stuff HW accelerated.
* Available on most platforms: No dependency to Java2D implementation.
* Renders into an own offscreen drawable, and copies it over to AWT's BufferedImage.

<h5> 3.) Own Pixmap GLContext, which has to be composed. </h5>
* GL stuff unlikely hw accelerated.
* Available on most platforms: No dependency to Java2D impl.
* Renders into an own offscreen drawable, and copies it over to AWT's BufferedImage.

As you see, no straight forward HW rendering is involved,
assuming that even the windowing manager is using offscreen
surfaces - you would have 2 compositions here already.

At least (1) would be 'acceptable' here, if available,
but if only (2) is available - the performance would
not match the state of the art!

Sure, it might be enough for some UIs or static pictures .. or so,
otherwise, I would prefer the 'overlay' method, ie using a
GLCanvas within a Swing component, while no menu is being shown.

However you do it .. the generic AWT 'restrictions' apply here
as well.

== Using OpenGL without a visible component ==
Sometimes you might want to do OpenGL work without a visible GLDrawable or before making your drawable visible.
* http://jogamp.762907.n3.nabble.com/Binding-textures-without-showing-the-GLCanvas-tp960145p960234.html

How to Contribute

2010-06-27T17:34:30Z

Mbien:

'''Easiest way to contribute:'''
* fork a repository on github (e.g. from http://github.com/sgothel or http://github.com/mbien)
* do what ever you want with it (really)
* tell us about the earth shaking improvements you made via the [http://jogamp.org/forum.html mailinglists/forum]
* if everything works fine we will probably integrate it very soon

'''important:'''
''please make sure you commit with your '''full name''' and a '''valid email address'''. Once your changes are integrated, it is very difficult to fix those things afterwards. (see [http://help.github.com/git-email-settings/ howto])''

----

'''building the projects'''
* put all projects you are interested in into one folder (otherwise the dependencies won't be resolved automatically)
* jogl, jocl, joal depends on gluegen
* jocl depends on jogl
* foo-demos depends on foo
'''build HowTo links'''
* http://jogamp.org/jogl/doc/HowToBuild.html
* http://jogamp.org/jocl/doc/HowToBuild.html

----

'''if you are new to GIT take a look at those pages:'''
* http://help.github.com/git-installation-redirect
* http://help.github.com/git-email-settings/
'''or general git help index:'''
* http://help.github.com/

'''for SVN experts which want to learn git:'''
* http://git.or.cz/course/svn.html

How to Contribute

2010-06-27T17:28:54Z

Mbien: build quick how to

'''Easiest way to contribute:'''
* fork a repository on github (e.g. from http://github.com/sgothel or http://github.com/mbien)
* do what ever you want with it (really)
* tell us about the earth shaking improvements you made via the [http://jogamp.org/forum.html mailinglists/forum]
* if everything works fine we will probably integrate it very soon

'''important:'''
''please make sure you commit with your '''full name''' and a '''valid email address'''. Once your changes are integrated, it is very difficult to fix those things afterwards. (see [http://help.github.com/git-email-settings/ howto])''

----

'''building the projects'''
* put all projects you are interested in into one folder (otherwise the dependencies won't be resolved automatically)
* jogl, jocl, joal depends on gluegen
* jocl depends on jogl
'''build HowTo links'''
* http://jogamp.org/jogl/doc/HowToBuild.html
* http://jogamp.org/jocl/doc/HowToBuild.html

----

'''if you are new to GIT take a look at those pages:'''
* http://help.github.com/git-installation-redirect
* http://help.github.com/git-email-settings/
'''or general git help index:'''
* http://help.github.com/

'''for SVN experts which want to learn git:'''
* http://git.or.cz/course/svn.html

How to Contribute

2010-06-27T17:15:37Z

Mbien:

'''Easiest way to contribute:'''
* fork a repository on github (e.g. from http://github.com/sgothel or http://github.com/mbien)
* do what ever you want with it (really)
* tell us about the earth shaking improvements you made via the [http://jogamp.org/forum.html mailinglists/forum]
* if everything works fine we will probably integrate it very soon

'''important:'''
''please make sure you commit with your '''full name''' and a '''valid email address'''. Once your changes are integrated, it is very difficult to fix those things afterwards. (see [http://help.github.com/git-email-settings/ howto])''

----

'''if you are new to GIT take a look at those pages:'''
* http://help.github.com/git-installation-redirect
* http://help.github.com/git-email-settings/
'''or general git help index:'''
* http://help.github.com/

'''for SVN experts which want to learn git:'''
* http://git.or.cz/course/svn.html

How to Contribute

2010-06-27T17:14:28Z

Mbien: initial howto contribute

'''Easiest way to contribute:'''
* fork a repository on github (e.g. from http://github.com/sgothel or http://github.com/mbien)
* do what ever you want with it (really)
* tell us about the earth shaking improvements you made via the [http://jogamp.org/forum.html mailinglists/forum]
* if everything works fine we will probably integrate it very soon

'''important:'''
''please make sure you commit with your full name and a valid email address. Once your changes are integrated, it is very difficult to fix those things afterwards. (see [http://help.github.com/git-email-settings/ howto])''

----

'''if you are new to GIT take a look at those pages:'''
* http://help.github.com/git-installation-redirect
* http://help.github.com/git-email-settings/
'''or general git help index:'''
* http://help.github.com/

'''for SVN experts which want to learn git:'''
* http://git.or.cz/course/svn.html

Main Page

2010-06-27T16:48:41Z

Mbien:

<b> Main page for all [http://jogamp.org JOGAMP] projects</b>

== Contribute ==
[[How to Contribute]]

== Teamplayers ==
* JOGL
** [[Jogl Overview|Overview]]
** [[Jogl Tutorial|Tutorial]]
** [[Jogl FAQ|FAQ]]
** [http://jogamp.org/jogl/doc/deployment/JOGL-DEPLOYMENT.html JOGL Deployment]
** [http://jogamp.org/jogl/doc/HowToBuild.html How to Build JOGL]
** [http://jogamp.org/jogl/doc/userguide/ Simple Userguide]

* JOCL
** [[JOCL Overview|Overview]]
** [[JOCL Tutorial|Tutorial]]
** [[JOCL FAQ|FAQ]]
** [http://jogamp.org/jocl/doc/HowToBuild.html How to Build JOCL]

* [[GlueGen_Wiki|GlueGen]]

== SW Management ==
* [[SW Tracking]] Main Page
* [http://jogamp.org/chuck/ Build Server]

Main Page

2010-05-19T01:11:42Z

Mbien: jocl build howto

<b> Main page for all [http://jogamp.org JOGAMP] projects</b>

== Teamplayers ==
* JOGL
** [[Jogl Overview|Overview]]
** [[Jogl Tutorial|Tutorial]]
** [[Jogl FAQ|FAQ]]
** [http://jogamp.org/jogl/doc/deployment/JOGL-DEPLOYMENT.html JOGL Deployment]
** [http://jogamp.org/jogl/doc/HowToBuild.html How to Build JOGL]
** [http://jogamp.org/jogl/doc/userguide/ Simple Userguide]

* JOCL
** [[JOCL Overview|Overview]]
** [[JOCL Tutorial|Tutorial]]
** [[JOCL FAQ|FAQ]]
** [http://jogamp.org/jocl/doc/HowToBuild.html How to Build JOCL]

* [[GlueGen_Wiki|GlueGen]]

== SW Management ==
* [[SW Tracking]] Main Page
* [http://jogamp.org/chuck/ Build Server]