Package org.lwjgl.opengl

Class ARBSparseBuffer

java.lang.Object

org.lwjgl.opengl.ARBSparseBuffer

public class ARBSparseBuffer
extends java.lang.Object

Native bindings to the ARB_sparse_buffer extension.

This extension adds to GL a mechanism to decouple the virtual and physical storage requirements of textures and allows an application to create partially populated textures that would over-subscribe available graphics memory if made fully resident. This extension provides like functionality for buffer objects, allowing applications to manage buffer object storage in a similar manner.

Requires OpenGL 1.5 or ARB_vertex_buffer_object.

Field Summary

Fields

Modifier and Type	Field and Description
static int	GL_SPARSE_BUFFER_PAGE_SIZE_ARB Accepted by the pname parameter of GetBooleanv, GetDoublev, GetFloatv, GetIntegerv, and GetInteger64v.
static int	GL_SPARSE_STORAGE_BIT_ARB Accepted as part of the flags parameter to BufferStorage.

Method Summary

Modifier and Type	Method and Description
static void	glBufferPageCommitmentARB(int target, long offset, long size, boolean commit) Commit and de-commits regions of sparse buffer storage.
static void	glNamedBufferPageCommitmentARB(int buffer, long offset, long size, boolean commit) Direct-state-access version of BufferPageCommitmentARB.
static void	glNamedBufferPageCommitmentEXT(int buffer, long offset, long size, boolean commit) Direct-state-access version of BufferPageCommitmentARB.

Methods inherited from class java.lang.Object

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

Field Detail

GL_SPARSE_STORAGE_BIT_ARB

Accepted as part of the flags parameter to BufferStorage.

GL_SPARSE_BUFFER_PAGE_SIZE_ARB

Accepted by the pname parameter of GetBooleanv, GetDoublev, GetFloatv, GetIntegerv, and GetInteger64v.

Method Detail

glBufferPageCommitmentARB

public static void glBufferPageCommitmentARB(int target,
                                             long offset,
                                             long size,
                                             boolean commit)

Commit and de-commits regions of sparse buffer storage.

Parameters:

target - buffer object target. One of:

ARRAY_BUFFER	ELEMENT_ARRAY_BUFFER	PIXEL_PACK_BUFFER	PIXEL_UNPACK_BUFFER
TRANSFORM_FEEDBACK_BUFFER	UNIFORM_BUFFER	TEXTURE_BUFFER	COPY_READ_BUFFER
COPY_WRITE_BUFFER	DRAW_INDIRECT_BUFFER	ATOMIC_COUNTER_BUFFER	DISPATCH_INDIRECT_BUFFER
SHADER_STORAGE_BUFFER	PARAMETER_BUFFER_ARB

offset - the region offset. Must be an integer multiple of the implementation dependent constant SPARSE_BUFFER_PAGE_SIZE_ARB.

size - the data size. must either be a multiple of SPARSE_BUFFER_PAGE_SIZE_ARB, or extend to the end of the buffer's data store.

commit - If true, then pages contained in the specified range become committed and become physically backed. If false, then physical storage associated with the data store in the specified region may be freed and those pages become uncommitted. Newly committed pages have undefined content. However, redundantly committing pages does not alter their content.

glNamedBufferPageCommitmentEXT, glNamedBufferPageCommitmentARB

public static void glNamedBufferPageCommitmentEXT(int buffer,
                                                  long offset,
                                                  long size,
                                                  boolean commit)

public static void glNamedBufferPageCommitmentARB(int buffer,
                                                  long offset,
                                                  long size,
                                                  boolean commit)

Direct-state-access version of BufferPageCommitmentARB.

Parameters:

buffer - the buffer object

offset - the region offset. Must be an integer multiple of the implementation dependent constant SPARSE_BUFFER_PAGE_SIZE_ARB.

size - the data size. must either be a multiple of SPARSE_BUFFER_PAGE_SIZE_ARB, or extend to the end of the buffer's data store.

commit - the commit state