Package org.lwjgl.opengl

Class ARBES31Compatibility

java.lang.Object

org.lwjgl.opengl.ARBES31Compatibility

public class ARBES31Compatibility
extends Object

Native bindings to the ARB_ES3_1_compatibility extension.

This extension adds support for features of OpenGL ES 3.1 that are missing from OpenGL 4.4. Enabling these features will ease the process of porting applications from OpenGL ES 3.1 to OpenGL. Enabling these features will ease the process of porting applications from OpenGL ES 3.1 to OpenGL.

In particular this adds the following features:

• a new MemoryBarrierByRegion API which is potentially more efficient for specific localized memory access patterns.
• increases the minimum required size of SSBOs to 2^27 (128 MB).
• support for GLSL ES version 310.
• a new GLSL built-in function, imageAtomicExchange, which performs atomic exchanges on r32f floating point images.
• a new GLSL built-in fragment shader input, gl_HelperInvocation, that identifies whether the current fragment shader input is a helper invocation. Fragment shader code can use this variable to skip performing operations that are useless or potentially dangerous for helper invocations.
• a new GLSL built-in constant for the maximum supported samples: gl_MaxSamples.
• a number of new GLSL built-in constants mirroring the API limits for image uniforms: gl_Max * ImageUniforms, gl_MaxCombinedShaderOutputResources.
• new GLSL built-in functions which extend mix() to select between int, uint, and bool components.
• add the "coherent" qualifier to all memory variables taken by the GLSL built-in atomic* and imageAtomic* functions.

Requires OpenGL 4.4, ARB_ES2_compatibility, ARB_ES3_compatibility. Promoted to core in OpenGL 4.5.

Method Summary

Modifier and Type	Method	Description
static void	glMemoryBarrierByRegion(int barriers)	Behaves like MemoryBarrier, with two differences:

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

glMemoryBarrierByRegion

public static void glMemoryBarrierByRegion(int barriers)

Behaves like MemoryBarrier, with two differences:

First, it narrows the region under consideration so that only reads/writes of prior fragment shaders that are invoked for a smaller region of the framebuffer will be completed/reflected prior to subsequent reads/write of following fragment shaders. The size of the region is implementation dependent and may be as small as one framebuffer pixel.

Second, it only applies to memory transactions that may be read by or written by a fragment shader.

When barriers is ALL_BARRIER_BITS, shader memory accesses will be synchronized relative to all these barrier bits, but not to other barrier bits specific to MemoryBarrier. This implies that reads/writes for scatter/gather-like algorithms may or may not be completed/reflected after a MemoryBarrierByRegion command. However, for uses such as deferred shading, where a linked list of visible surfaces with the head at a framebuffer address may be constructed, and the entirety of the list is only dependent on previous executions at that framebuffer address, MemoryBarrierByRegion may be significantly more efficient than MemoryBarrier.

Parameters:

barriers - the barriers to insert. One or more of:

ATOMIC_COUNTER_BARRIER_BIT	FRAMEBUFFER_BARRIER_BIT	SHADER_IMAGE_ACCESS_BARRIER_BIT
SHADER_STORAGE_BARRIER_BIT	TEXTURE_FETCH_BARRIER_BIT	UNIFORM_BARRIER_BIT