public class ARBMultiBind
extends java.lang.Object
This extension provides a new set of commands allowing applications to bind or unbind a set of objects in a single call, instead of requiring a separate call for each bind or unbind operation. Using a single command allows OpenGL implementations to amortize function call, name space lookup, and potential locking overhead over multiple bind or unbind operations. The rendering loops of graphics applications frequently switch between different states, binding different sets of resources, including texture objects, sampler objects, textures for image loads and stores, uniform buffers, and vertex buffers; this extension provides "multi-bind" entry points for all of these object types.
Each command in this extension includes a <first> and <count> parameter, specifying a continguous range of binding points to update, as well
as an array of <count> object names specifying the objects to bind. Unlike single bind commands, multi-bind commands can be used only to bind or
unbind existing objects. Passing a previously unused object name (generated or not) results in an error and does not create a new object. For binding
points with associated data (e.g., ranges of a buffer), separate arrays are used to pass the associated data for each binding point. Passing zero values
in the array of object names removes the object bound to the current bounding point. Additionally, if NULL is passed as the array of objects, objects
bound to the entire range of binding points are unbound, as though the caller passed an array of zeroes.
Requires OpenGL 3.0. Promoted to core in OpenGL 4.4.
| Modifier and Type | Method and Description |
|---|---|
static void |
glBindBuffersBase(int target,
int first,
int[] buffers)
Array version of:
BindBuffersBase |
static void |
glBindBuffersBase(int target,
int first,
java.nio.IntBuffer buffers)
Binds
count existing buffer objects to bindings numbered first through first+count-1 in the array of buffer binding points
corresponding to target. |
static void |
glBindBuffersRange(int target,
int first,
int[] buffers,
org.lwjgl.PointerBuffer offsets,
org.lwjgl.PointerBuffer sizes)
Array version of:
BindBuffersRange |
static void |
glBindBuffersRange(int target,
int first,
java.nio.IntBuffer buffers,
org.lwjgl.PointerBuffer offsets,
org.lwjgl.PointerBuffer sizes)
Binds
count existing buffer objects to bindings numbered first through first+count-1 in the array of buffer binding points
corresponding to target. |
static void |
glBindImageTextures(int first,
int[] textures)
Array version of:
BindImageTextures |
static void |
glBindImageTextures(int first,
java.nio.IntBuffer textures)
Binds
count existing texture objects to image units numbered first through first+count-1. |
static void |
glBindSamplers(int first,
int[] samplers)
Array version of:
BindSamplers |
static void |
glBindSamplers(int first,
java.nio.IntBuffer samplers)
Binds
count existing sampler objects to texture image units numbered first through first+count-1. |
static void |
glBindTextures(int first,
int[] textures)
Array version of:
BindTextures |
static void |
glBindTextures(int first,
java.nio.IntBuffer textures)
Binds
count existing texture objects to texture image units numbered first through first+count-1. |
static void |
glBindVertexBuffers(int first,
int[] buffers,
org.lwjgl.PointerBuffer offsets,
int[] strides)
Array version of:
BindVertexBuffers |
static void |
glBindVertexBuffers(int first,
java.nio.IntBuffer buffers,
org.lwjgl.PointerBuffer offsets,
java.nio.IntBuffer strides)
Binds
count existing buffer objects to vertex buffer binding points numbered first through first+count-1. |
static void |
nglBindBuffersBase(int target,
int first,
int count,
long buffers)
Unsafe version of:
BindBuffersBase |
static void |
nglBindBuffersRange(int target,
int first,
int count,
long buffers,
long offsets,
long sizes)
Unsafe version of:
BindBuffersRange |
static void |
nglBindImageTextures(int first,
int count,
long textures)
Unsafe version of:
BindImageTextures |
static void |
nglBindSamplers(int first,
int count,
long samplers)
Unsafe version of:
BindSamplers |
static void |
nglBindTextures(int first,
int count,
long textures)
Unsafe version of:
BindTextures |
static void |
nglBindVertexBuffers(int first,
int count,
long buffers,
long offsets,
long strides)
Unsafe version of:
BindVertexBuffers |
public static void nglBindBuffersBase(int target,
int first,
int count,
long buffers)
BindBuffersBasecount - the number of bindingspublic static void glBindBuffersBase(int target,
int first,
@Nullable
java.nio.IntBuffer buffers)
count existing buffer objects to bindings numbered first through first+count-1 in the array of buffer binding points
corresponding to target. If buffers is not NULL, it specifies an array of count values, each of which must be zero or the name
of an existing buffer object. It is equivalent to:
for ( i = 0; i < count; i++ ) {
if ( buffers == NULL ) {
glBindBufferBase(target, first + i, 0);
} else {
glBindBufferBase(target, first + i, buffers[i]);
}
}except that the single general buffer binding corresponding to target is unmodified, and that buffers will not be created if they do not exist.
target - the buffer object target. One of:first - the first bindingbuffers - an array of zeros or names of existing buffers objectspublic static void nglBindBuffersRange(int target,
int first,
int count,
long buffers,
long offsets,
long sizes)
BindBuffersRangecount - the number of bindingspublic static void glBindBuffersRange(int target,
int first,
@Nullable
java.nio.IntBuffer buffers,
@Nullable
org.lwjgl.PointerBuffer offsets,
@Nullable
org.lwjgl.PointerBuffer sizes)
count existing buffer objects to bindings numbered first through first+count-1 in the array of buffer binding points
corresponding to target. offsets and sizes specify arrays of count values indicating the range of each buffer to bind.
If buffers is NULL, all bindings from first through first+count-1 are reset to their unbound (zero) state. In this
case, the offsets and sizes associated with the binding points are set to default values, ignoring offsets and sizes. It is equivalent
to:
for ( i = 0; i < count; i++ ) {
if ( buffers == NULL ) {
glBindBufferRange(target, first + i, 0, 0, 0);
} else {
glBindBufferRange(target, first + i, buffers[i], offsets[i], sizes[i]);
}
}except that the single general buffer binding corresponding to target is unmodified, and that buffers will not be created if they do not exist.
The values specified in buffers, offsets, and sizes will be checked separately for each binding point. When values for a
specific binding point are invalid, the state for that binding point will be unchanged and an error will be generated. However, state for other binding
points will still be changed if their corresponding values are valid.
target - the buffer object target. One of:first - the first bindingbuffers - an array of names of existing buffers objectsoffsets - an array of offsetssizes - an array of sizespublic static void nglBindTextures(int first,
int count,
long textures)
BindTexturescount - the number of texture objectspublic static void glBindTextures(int first,
@Nullable
java.nio.IntBuffer textures)
count existing texture objects to texture image units numbered first through first+count-1. If textures is not
NULL, it specifies an array of count values, each of which must be zero or the name of an existing texture object. When an entry in
textures is the name of an existing texture object, that object is bound to corresponding texture unit for the target specified when the texture
object was created. When an entry in textures is zero, each of the targets enumerated at the beginning of this section is reset to its default
texture for the corresponding texture image unit. If textures is NULL, each target of each affected texture image unit from first
through first+count-1 is reset to its default texture.
BindTextures is equivalent to:
for ( i = 0; i < count; i++ ) {
uint texture;
if ( textures == NULL ) {
texture = 0;
} else {
texture = textures[i];
}
ActiveTexture(TEXTURE0 + first + i);
if ( texture != 0 ) {
enum target; // target of texture object textures[i]
BindTexture(target, textures[i]);
} else {
for ( target in all supported targets ) {
BindTexture(target, 0);
}
}
}except that the active texture selector retains its original value upon completion of the command, and that textures will not be created if they do not exist.
The values specified in textures will be checked separately for each texture image unit. When a value for a specific texture image unit is
invalid, the state for that texture image unit will be unchanged and an error will be generated. However, state for other texture image units will still
be changed if their corresponding values are valid.
first - the first texture objectstextures - an array of zeros or names of existing texture objectspublic static void nglBindSamplers(int first,
int count,
long samplers)
BindSamplerscount - the number of sampler objectspublic static void glBindSamplers(int first,
@Nullable
java.nio.IntBuffer samplers)
count existing sampler objects to texture image units numbered first through first+count-1. If samplers is not
NULL, it specifies an array of count values, each of which must be zero or the name of an existing sampler object. If samplers is NULL,
each affected texture image unit from first through first+count-1 will be reset to have no bound sampler object.
BindSamplers is equivalent to:
for ( i = 0; i < count; i++ ) {
if ( samplers == NULL ) {
glBindSampler(first + i, 0);
} else {
glBindSampler(first + i, samplers[i]);
}
}The values specified in samplers will be checked separately for each texture image unit. When a value for a specific texture image unit is
invalid, the state for that texture image unit will be unchanged and an error will be generated. However, state for other texture image units will still
be changed if their corresponding values are valid.
first - the first sampler objectsamplers - an array of zeros or names of existing sampler objectspublic static void nglBindImageTextures(int first,
int count,
long textures)
BindImageTexturescount - the number of image unitspublic static void glBindImageTextures(int first,
@Nullable
java.nio.IntBuffer textures)
count existing texture objects to image units numbered first through first+count-1. If textures is not NULL, it
specifies an array of count values, each of which must be zero or the name of an existing texture object. If textures is NULL, each
affected image unit from first through first+count-1 will be reset to have no bound texture object.
When binding a non-zero texture object to an image unit, the image unit level, layered, layer, and access parameters are
set to zero, TRUE, zero, and READ_WRITE, respectively. The image unit format parameter is taken from the internal
format of the texture image at level zero of the texture object identified by textures. For cube map textures, the internal format of the
TEXTURE_CUBE_MAP_POSITIVE_X image of level zero is used. For multisample, multisample array, buffer, and rectangle textures, the internal
format of the single texture level is used.
When unbinding a texture object from an image unit, the image unit parameters level, layered, layer, and format will be
reset to their default values of zero, FALSE, 0, and R8, respectively.
BindImageTextures is equivalent to:
for ( i = 0; i < count; i++ ) {
if ( textures == NULL || textures[i] = 0 ) {
glBindImageTexture(first + i, 0, 0, FALSE, 0, READ_ONLY, R8);
} else {
glBindImageTexture(first + i, textures[i], 0, TRUE, 0, READ_WRITE, lookupInternalFormat(textures[i]));
}
}where lookupInternalFormat returns the internal format of the specified texture object.
The values specified in textures will be checked separately for each image unit. When a value for a specific image unit is invalid, the state
for that image unit will be unchanged and an error will be generated. However, state for other image units will still be changed if their corresponding
values are valid.
first - the first image unittextures - an array of zeros or names of existing texture objectspublic static void nglBindVertexBuffers(int first,
int count,
long buffers,
long offsets,
long strides)
BindVertexBufferscount - the number of vertex buffer binding pointspublic static void glBindVertexBuffers(int first,
@Nullable
java.nio.IntBuffer buffers,
@Nullable
org.lwjgl.PointerBuffer offsets,
@Nullable
java.nio.IntBuffer strides)
count existing buffer objects to vertex buffer binding points numbered first through first+count-1. If buffers is
not NULL, it specifies an array of count values, each of which must be zero or the name of an existing buffer object. offsets and
strides specify arrays of count values indicating the offset of the first element and stride between elements in each buffer,
respectively. If buffers is NULL, each affected vertex buffer binding point from first through first+count-1 will be reset to
have no bound buffer object. In this case, the offsets and strides associated with the binding points are set to default values, ignoring
offsets and strides.
BindVertexBuffers is equivalent to:
for ( i = 0; i < count; i++ ) {
if ( buffers == NULL ) {
glBindVertexBuffer(first + i, 0, 0, 16);
} else {
glBindVertexBuffer(first + i, buffers[i], offsets[i], strides[i]);
}
}except that buffers will not be created if they do not exist.
The values specified in buffers, offsets, and strides will be checked separately for each vertex buffer binding point. When a
value for a specific binding point is invalid, the state for that binding point will be unchanged and an error will be generated. However, state for
other binding points will still be changed if their corresponding values are valid.
first - the first vertex buffer binding pointbuffers - an array of zeros or names of existing buffers objectsoffsets - an array of offsesstrides - an array of stride valuespublic static void glBindBuffersBase(int target,
int first,
@Nullable
int[] buffers)
BindBuffersBasepublic static void glBindBuffersRange(int target,
int first,
@Nullable
int[] buffers,
@Nullable
org.lwjgl.PointerBuffer offsets,
@Nullable
org.lwjgl.PointerBuffer sizes)
BindBuffersRangepublic static void glBindTextures(int first,
@Nullable
int[] textures)
BindTexturespublic static void glBindSamplers(int first,
@Nullable
int[] samplers)
BindSamplerspublic static void glBindImageTextures(int first,
@Nullable
int[] textures)
BindImageTexturespublic static void glBindVertexBuffers(int first,
@Nullable
int[] buffers,
@Nullable
org.lwjgl.PointerBuffer offsets,
@Nullable
int[] strides)
BindVertexBuffersCopyright LWJGL. All Rights Reserved. License terms.