'''Debug Output''' is an OpenGL feature that makes [https://www.opengl.org/wiki/Error_Checking Error Checking] from functions easier.

In order to get more information about Debug Output, you can read the main opengl [https://www.opengl.org/wiki/Debug_Output wiki page]. You should read that first before continuing.

The difference with plain OpenGL is that in Jogl, if you want to enable Debug Output, you have to do it at the begin, before the context gets created.

There are two tests in jogl-demos, that show how you can achieve this:
* [https://github.com/sgothel/jogl/blob/b3ecc88efca2a2f969e1e5a375086148821ee3c5/src/test/com/jogamp/opengl/test/junit/jogl/acore/TestGLDebug00NEWT.java#L103 TestGLDebug00NEWT]
* [https://github.com/sgothel/jogl/blob/b3ecc88efca2a2f969e1e5a375086148821ee3c5/src/test/com/jogamp/opengl/test/junit/jogl/acore/TestGLDebug01NEWT.java#L71 TestGLDebug01NEWT]

There is also a sample, [https://github.com/elect86/jogl-samples/blob/master/jogl-samples/src/tests/gl_420/Gl_420_debug_output.java gl-420-debug-output] from the jogl-samples that it is interesting to take a look at. Indeed, once enabled from the startup, there are different way you can turn it on/off.
First of all, you should be aware that there are now two ways of affecting the debut, one is acting directly on jogl, the other is setting directly OpenGL through opengl calls.
You can now enable/disable Debug Output using either:
glWindow.getContext().enableGLDebugMessage(true/false);

gl4.glEnable/Disable(GL_DEBUG_OUTPUT);
Same for setting the synchronous option:
glWindow.getContext().setGLDebugSynchronous(true/false);

gl4.glEnable/Disable(GL_DEBUG_OUTPUT_SYNCHRONOUS);
Control the messages:
glWindow.getContext().glDebugMessageControl(GL_DONT_CARE, GL_DONT_CARE, GL_DONT_CARE, 0, null, 0, true);

gl4.glDebugMessageControl(GL_DONT_CARE, GL_DONT_CARE, GL_DONT_CARE, 0, null, 0, true);
Or insert them:
glWindow.getContext().glDebugMessageInsert(
GL_DEBUG_SOURCE_APPLICATION,
GL_DEBUG_TYPE_OTHER, 1,
GL_DEBUG_SEVERITY_MEDIUM,
"Message");

gl4.glDebugMessageInsert(
GL_DEBUG_SOURCE_APPLICATION,
GL_DEBUG_TYPE_OTHER, 1,
GL_DEBUG_SEVERITY_MEDIUM,
message1.length(), message1);

Anyway it is also important to mention that, of course, OpenGL settings have the priority over the Jogl's one. You should always be coherent with the way you took.

2016-01-28T11:40:07Z

Gbarbieri:

Why Instance Design

2016-01-28T11:03:49Z

Gbarbieri:

Why Instance Design

2016-01-28T10:52:09Z

Gbarbieri:

Why Instance Design

2016-01-28T10:51:58Z

Gbarbieri:

2015-07-26T10:43:04Z

Gbarbieri:

Jogl API Overview

2015-07-26T10:42:16Z

Gbarbieri:

Before starting, you should know that the JOGL API is not a young API, this means that there are some things that are (very) old, so you should always evaluate what you are looking at.

We will reference all the links to the main [http://jogamp.org/git/?p=jogl.git;a=tree;hb=HEAD jogamp server], but you can click also on the GitHub version ([https://github.com/sgothel/jogl GH]) for a better layout, font and support for highlighting or on the API docs ([http://jogamp.org/deployment/jogamp-next/javadoc/jogl/javadoc/ AD]).

__TOC__

<h5> Preface </h5>

The JOGL API offers a lots of deep and detailed utilities for almost all the possible needs regarding OpenGL but most of them aren't used simply because people ignore about their existence. This small overview aims to alleviate this problem.

You can find the most interesting part under [http://jogamp.org/git/?p=jogl.git;a=tree;f=src/jogl/classes/com/jogamp/opengl;h=1b5d1802174cbd371560c9c786039870dcb106fa;hb=HEAD com.jogamp.opengl] ([https://github.com/sgothel/jogl/tree/master/src/jogl/classes/com/jogamp/opengl GH]).

<h3> Shaders </h3>

[http://jogamp.org/git/?p=jogl.git;a=tree;f=src/jogl/classes/com/jogamp/opengl/util/glsl;h=8e0f6ddfb2817836db16f26ecc8967553d8b6bd7;hb=HEAD com.jogamp.opengl.util.glsl] ([https://github.com/sgothel/jogl/tree/master/src/jogl/classes/com/jogamp/opengl/util/glsl GH]).

You can create your own GLSL program in JOGL by simply calling:
<code>
private int initProgram(GL4 gl4) {
ShaderCode vertexShader = ShaderCode.create(gl4, GL4.GL_VERTEX_SHADER, this.getClass(), "src/data", null, "simple", "vert", null, true);
ShaderCode fragmentShader = ShaderCode.create(gl4, GL4.GL_FRAGMENT_SHADER, this.getClass(), "src/data", null, "simple", "frag", null, true);
ShaderProgram program = new ShaderProgram();
program.add(vertexShader);
program.add(fragmentShader);
program.link(gl4, System.out);
return program.program();
}
</code>

You can init vertex, fragment, geometry, tesselation control and tesselation evaluation shaders (compute will be implemented soon) using [http://jogamp.org/git/?p=jogl.git;a=blob;f=src/jogl/classes/com/jogamp/opengl/util/glsl/ShaderCode.java;h=e1db3f7a3467c57ebddbafcda52eddc154c4866b;hb=HEAD ShaderCode.create] ([https://github.com/sgothel/jogl/blob/master/src/jogl/classes/com/jogamp/opengl/util/glsl/ShaderCode.java#L683-L689 GH] [http://jogamp.org/deployment/jogamp-next/javadoc/jogl/javadoc/com/jogamp/opengl/util/glsl/ShaderCode.html AD]).
For the vertex shader, note that <code>"simple"</code> is the name and "vert" is the custom suffix. You need to specify that if your shaders suffices differ from [https://github.com/sgothel/jogl/blob/master/src/jogl/classes/com/jogamp/opengl/util/glsl/ShaderCode.java#L77-L117 these].

The two <code>null</code> refer to the path for the binary shaders and the name. If the shaders are located in the same package of the <code>class.initProgram(gl4)</code> you can pass <code>null</code> also on the src path.

Then you can create the class ShaderProgram, but please note that this has nothing to do with OpenGL, it is just Java side.

Finally we can add the created shaders into our Program and link it. This last call is important because it is here that our program will be [https://github.com/sgothel/jogl/blob/master/src/jogl/classes/com/jogamp/opengl/util/glsl/ShaderProgram.java#L242 initialized] on OpenGL and [https://github.com/sgothel/jogl/blob/master/src/jogl/classes/com/jogamp/opengl/util/glsl/ShaderProgram.java#L259 linked].

The function will also check at the end if everything [https://github.com/sgothel/jogl/blob/master/src/jogl/classes/com/jogamp/opengl/util/glsl/ShaderProgram.java#L261 went fine] or not.

Please note that the program id/name [https://github.com/sgothel/jogl/blob/master/src/jogl/classes/com/jogamp/opengl/util/glsl/ShaderProgram.java#L321 <code>shaderProgram</code>] is obtained through the [https://github.com/sgothel/jogl/blob/master/src/jogl/classes/com/jogamp/opengl/util/glsl/ShaderProgram.java#L54 program() method], the [https://github.com/sgothel/jogl/blob/master/src/jogl/classes/com/jogamp/opengl/util/glsl/ShaderProgram.java#L59 <code>id()</code> method] has nothing to do with it.

<h3> Textures </h3>

Jogl API Overview

2015-07-26T10:40:35Z

Gbarbieri:

Before starting, you should know that the JOGL API is not a young API, this means that there are some things that are (very) old, so you should always evaluate what you are looking at.

We will reference all the links to the main [http://jogamp.org/git/?p=jogl.git;a=tree;hb=HEAD jogamp server], but you can click also on the GitHub version ([https://github.com/sgothel/jogl GH]) for a better layout, font and support for highlighting or on the API docs ([http://jogamp.org/deployment/jogamp-next/javadoc/jogl/javadoc/ AD]).

__TOC__

<h5> Preface </h5>

The JOGL API offers a lots of deep and detailed utilities for almost all the possible needs regarding OpenGL but most of them aren't used simply because people ignore about their existence. This small overview aims to alleviate this problem.

You can find the most interesting part under [http://jogamp.org/git/?p=jogl.git;a=tree;f=src/jogl/classes/com/jogamp/opengl;h=1b5d1802174cbd371560c9c786039870dcb106fa;hb=HEAD com.jogamp.opengl] ([https://github.com/sgothel/jogl/tree/master/src/jogl/classes/com/jogamp/opengl GH]).

<h4> Shaders </h4>

[http://jogamp.org/git/?p=jogl.git;a=tree;f=src/jogl/classes/com/jogamp/opengl/util/glsl;h=8e0f6ddfb2817836db16f26ecc8967553d8b6bd7;hb=HEAD com.jogamp.opengl.util.glsl] ([https://github.com/sgothel/jogl/tree/master/src/jogl/classes/com/jogamp/opengl/util/glsl GH]).

You can create your own GLSL program in JOGL by simply calling:
<code>
private int initProgram(GL4 gl4) {
ShaderCode vertexShader = ShaderCode.create(gl4, GL4.GL_VERTEX_SHADER, this.getClass(), "src/data", null, "simple", "vert", null, true);
ShaderCode fragmentShader = ShaderCode.create(gl4, GL4.GL_FRAGMENT_SHADER, this.getClass(), "src/data", null, "simple", "frag", null, true);
ShaderProgram program = new ShaderProgram();
program.add(vertexShader);
program.add(fragmentShader);
program.link(gl4, System.out);
return program.program();
}
</code>

You can init vertex, fragment, geometry, tesselation control and tesselation evaluation shaders (compute will be implemented soon) using [http://jogamp.org/git/?p=jogl.git;a=blob;f=src/jogl/classes/com/jogamp/opengl/util/glsl/ShaderCode.java;h=e1db3f7a3467c57ebddbafcda52eddc154c4866b;hb=HEAD ShaderCode.create] ([https://github.com/sgothel/jogl/blob/master/src/jogl/classes/com/jogamp/opengl/util/glsl/ShaderCode.java#L683-L689 GH] [http://jogamp.org/deployment/jogamp-next/javadoc/jogl/javadoc/com/jogamp/opengl/util/glsl/ShaderCode.html AD]).
For the vertex shader, note that <code>"simple"</code> is the name and "vert" is the custom suffix. You need to specify that if your shaders suffices differ from [https://github.com/sgothel/jogl/blob/master/src/jogl/classes/com/jogamp/opengl/util/glsl/ShaderCode.java#L77-L117 these].

The two <code>null</code> refer to the path for the binary shaders and the name. If the shaders are located in the same package of the <code>class.initProgram(gl4)</code> you can pass <code>null</code> also on the src path.

Then you can create the class ShaderProgram, but please note that this has nothing to do with OpenGL, it is just Java side.

Finally we can add the created shaders into our Program and link it. This last call is important because it is here that our program will be [https://github.com/sgothel/jogl/blob/master/src/jogl/classes/com/jogamp/opengl/util/glsl/ShaderProgram.java#L242 initialized] on OpenGL and [https://github.com/sgothel/jogl/blob/master/src/jogl/classes/com/jogamp/opengl/util/glsl/ShaderProgram.java#L259 linked].

The function will also check at the end if everything [https://github.com/sgothel/jogl/blob/master/src/jogl/classes/com/jogamp/opengl/util/glsl/ShaderProgram.java#L261 went fine] or not.

Please note that the program id/name [https://github.com/sgothel/jogl/blob/master/src/jogl/classes/com/jogamp/opengl/util/glsl/ShaderProgram.java#L321 <code>shaderProgram</code>] is obtained through the [https://github.com/sgothel/jogl/blob/master/src/jogl/classes/com/jogamp/opengl/util/glsl/ShaderProgram.java#L54 program() method], the [https://github.com/sgothel/jogl/blob/master/src/jogl/classes/com/jogamp/opengl/util/glsl/ShaderProgram.java#L59 <code>id()</code> method] has nothing to do with it.

Jogl API Overview

2015-07-26T10:39:32Z

2015-07-26T10:12:57Z

Gbarbieri: