Class ARBShaderStorageBufferObject
This extension provides the ability for OpenGL shaders to perform random access reads, writes, and atomic memory operations on variables stored in a buffer object. Application shader code can declare sets of variables (referred to as "buffer variables") arranged into interface blocks in a manner similar to that done with uniform blocks in OpenGL 3.1. In both cases, the values of the variables declared in a given interface block are taken from a buffer object bound to a binding point associated with the block. Buffer objects used in this extension are referred to as "shader storage buffers".
While the capability provided by this extension is similar to that provided by OpenGL 3.1 and ARB_uniform_buffer_object
, there are several
significant differences. Most importantly, shader code is allowed to write to shader storage buffers, while uniform buffers are always read-only. Shader
storage buffers have a separate set of binding points, with different counts and size limits. The maximum usable size for shader storage buffers is
implementation-dependent, but its minimum value is substantially larger than the minimum for uniform buffers.
The ability to write to buffer objects creates the potential for multiple independent shader invocations to read and write the same underlying memory.
The same issue exists with the ARB_shader_image_load_store
extension provided in OpenGL 4.2, which can write to texture objects and buffers. In
both cases, the specification makes few guarantees related to the relative order of memory reads and writes performed by the shader invocations. For
ARB_shader_image_load_store, the OpenGL API and shading language do provide some control over memory transactions; those mechanisms also affect reads
and writes of shader storage buffers. In the OpenGL API, the MemoryBarrier
call can be used to ensure that certain memory operations related to
commands issued prior the barrier complete before other operations related to commands issued after the barrier. Additionally, the shading language
provides the memoryBarrier()
function to control the relative order of memory accesses within individual shader invocations and provides
various memory qualifiers controlling how the memory corresponding to individual variables is accessed.
Requires OpenGL 4.0
and OpenGL 4.3
or ARB_program_interface_query
. Promoted to core in OpenGL 4.3
.
-
Field Summary
Modifier and TypeFieldDescriptionstatic final int
Also, add a new alias for the existing token MAX_COMBINED_IMAGE_UNITS_AND_FRAGMENT_OUTPUTS.static final int
Accepted by thepname
parameter of GetIntegerv, GetBooleanv, GetInteger64v, GetFloatv, and GetDoublev.static final int
Accepted by thepname
parameter of GetIntegerv, GetBooleanv, GetInteger64v, GetFloatv, and GetDoublev.static final int
Accepted by thepname
parameter of GetIntegerv, GetBooleanv, GetInteger64v, GetFloatv, and GetDoublev.static final int
Accepted by thepname
parameter of GetIntegerv, GetBooleanv, GetInteger64v, GetFloatv, and GetDoublev.static final int
Accepted by thepname
parameter of GetIntegerv, GetBooleanv, GetInteger64v, GetFloatv, and GetDoublev.static final int
Accepted by thepname
parameter of GetIntegerv, GetBooleanv, GetInteger64v, GetFloatv, and GetDoublev.static final int
Accepted by thepname
parameter of GetIntegerv, GetBooleanv, GetInteger64v, GetFloatv, and GetDoublev.static final int
Accepted by thepname
parameter of GetIntegerv, GetBooleanv, GetInteger64v, GetFloatv, and GetDoublev.static final int
Accepted by thepname
parameter of GetIntegerv, GetBooleanv, GetInteger64v, GetFloatv, and GetDoublev.static final int
Accepted in thebarriers
bitfield in glMemoryBarrier.static final int
Accepted by thetarget
parameters of BindBuffer, BufferData, BufferSubData, MapBuffer, UnmapBuffer, GetBufferSubData, and GetBufferPointerv.static final int
Accepted by thepname
parameter of GetIntegerv, GetIntegeri_v, GetBooleanv, GetInteger64v, GetFloatv, GetDoublev, GetBooleani_v, GetIntegeri_v, GetFloati_v, GetDoublei_v, and GetInteger64i_v.static final int
Accepted by thepname
parameter of GetIntegerv, GetBooleanv, GetInteger64v, GetFloatv, and GetDoublev.static final int
Accepted by thepname
parameter of GetIntegeri_v, GetBooleani_v, GetIntegeri_v, GetFloati_v, GetDoublei_v, and GetInteger64i_v.static final int
Accepted by thepname
parameter of GetIntegeri_v, GetBooleani_v, GetIntegeri_v, GetFloati_v, GetDoublei_v, and GetInteger64i_v. -
Method Summary
Modifier and TypeMethodDescriptionstatic void
glShaderStorageBlockBinding
(int program, int storageBlockIndex, int storageBlockBinding) Changes an active shader storage block binding.
-
Field Details
-
GL_SHADER_STORAGE_BUFFER
public static final int GL_SHADER_STORAGE_BUFFERAccepted by thetarget
parameters of BindBuffer, BufferData, BufferSubData, MapBuffer, UnmapBuffer, GetBufferSubData, and GetBufferPointerv.- See Also:
-
GL_SHADER_STORAGE_BUFFER_BINDING
public static final int GL_SHADER_STORAGE_BUFFER_BINDINGAccepted by thepname
parameter of GetIntegerv, GetIntegeri_v, GetBooleanv, GetInteger64v, GetFloatv, GetDoublev, GetBooleani_v, GetIntegeri_v, GetFloati_v, GetDoublei_v, and GetInteger64i_v.- See Also:
-
GL_SHADER_STORAGE_BUFFER_START
public static final int GL_SHADER_STORAGE_BUFFER_STARTAccepted by thepname
parameter of GetIntegeri_v, GetBooleani_v, GetIntegeri_v, GetFloati_v, GetDoublei_v, and GetInteger64i_v.- See Also:
-
GL_SHADER_STORAGE_BUFFER_SIZE
public static final int GL_SHADER_STORAGE_BUFFER_SIZEAccepted by thepname
parameter of GetIntegeri_v, GetBooleani_v, GetIntegeri_v, GetFloati_v, GetDoublei_v, and GetInteger64i_v.- See Also:
-
GL_MAX_VERTEX_SHADER_STORAGE_BLOCKS
public static final int GL_MAX_VERTEX_SHADER_STORAGE_BLOCKSAccepted by thepname
parameter of GetIntegerv, GetBooleanv, GetInteger64v, GetFloatv, and GetDoublev.- See Also:
-
GL_MAX_GEOMETRY_SHADER_STORAGE_BLOCKS
public static final int GL_MAX_GEOMETRY_SHADER_STORAGE_BLOCKSAccepted by thepname
parameter of GetIntegerv, GetBooleanv, GetInteger64v, GetFloatv, and GetDoublev.- See Also:
-
GL_MAX_TESS_CONTROL_SHADER_STORAGE_BLOCKS
public static final int GL_MAX_TESS_CONTROL_SHADER_STORAGE_BLOCKSAccepted by thepname
parameter of GetIntegerv, GetBooleanv, GetInteger64v, GetFloatv, and GetDoublev.- See Also:
-
GL_MAX_TESS_EVALUATION_SHADER_STORAGE_BLOCKS
public static final int GL_MAX_TESS_EVALUATION_SHADER_STORAGE_BLOCKSAccepted by thepname
parameter of GetIntegerv, GetBooleanv, GetInteger64v, GetFloatv, and GetDoublev.- See Also:
-
GL_MAX_FRAGMENT_SHADER_STORAGE_BLOCKS
public static final int GL_MAX_FRAGMENT_SHADER_STORAGE_BLOCKSAccepted by thepname
parameter of GetIntegerv, GetBooleanv, GetInteger64v, GetFloatv, and GetDoublev.- See Also:
-
GL_MAX_COMPUTE_SHADER_STORAGE_BLOCKS
public static final int GL_MAX_COMPUTE_SHADER_STORAGE_BLOCKSAccepted by thepname
parameter of GetIntegerv, GetBooleanv, GetInteger64v, GetFloatv, and GetDoublev.- See Also:
-
GL_MAX_COMBINED_SHADER_STORAGE_BLOCKS
public static final int GL_MAX_COMBINED_SHADER_STORAGE_BLOCKSAccepted by thepname
parameter of GetIntegerv, GetBooleanv, GetInteger64v, GetFloatv, and GetDoublev.- See Also:
-
GL_MAX_SHADER_STORAGE_BUFFER_BINDINGS
public static final int GL_MAX_SHADER_STORAGE_BUFFER_BINDINGSAccepted by thepname
parameter of GetIntegerv, GetBooleanv, GetInteger64v, GetFloatv, and GetDoublev.- See Also:
-
GL_MAX_SHADER_STORAGE_BLOCK_SIZE
public static final int GL_MAX_SHADER_STORAGE_BLOCK_SIZEAccepted by thepname
parameter of GetIntegerv, GetBooleanv, GetInteger64v, GetFloatv, and GetDoublev.- See Also:
-
GL_SHADER_STORAGE_BUFFER_OFFSET_ALIGNMENT
public static final int GL_SHADER_STORAGE_BUFFER_OFFSET_ALIGNMENTAccepted by thepname
parameter of GetIntegerv, GetBooleanv, GetInteger64v, GetFloatv, and GetDoublev.- See Also:
-
GL_SHADER_STORAGE_BARRIER_BIT
public static final int GL_SHADER_STORAGE_BARRIER_BITAccepted in thebarriers
bitfield in glMemoryBarrier.- See Also:
-
GL_MAX_COMBINED_SHADER_OUTPUT_RESOURCES
public static final int GL_MAX_COMBINED_SHADER_OUTPUT_RESOURCESAlso, add a new alias for the existing token MAX_COMBINED_IMAGE_UNITS_AND_FRAGMENT_OUTPUTS.- See Also:
-
-
Method Details
-
glShaderStorageBlockBinding
public static void glShaderStorageBlockBinding(int program, int storageBlockIndex, int storageBlockBinding) Changes an active shader storage block binding.- Parameters:
program
- the name of the program containing the block whose binding to changestorageBlockIndex
- the index storage block within the programstorageBlockBinding
- the index storage block binding to associate with the specified storage block
-