View source for JOCL FAQ

__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