org.lwjgl.opengl

Class ARBTextureStorageMultisample

java.lang.Object

org.lwjgl.opengl.ARBTextureStorageMultisample

public class ARBTextureStorageMultisample
extends java.lang.Object

Native bindings to the ARB_texture_storage_multisample extension.

The ARB_texture_storage extension and OpenGL 4.2 introduced the concept of immutable texture objects. With these objects, once their data store has been sized and allocated, it could not be resized for the lifetime of the objects (although its content could be updated). OpenGL implementations may be able to take advantage of the knowledge that the underlying data store of certain objects cannot be deleted or otherwise reallocated without destruction of the whole object (normally, a much heavier weight and less frequent operation). Immutable storage for all types of textures besides multisample and buffer textures was introduced by ARB_texture_storage. For completeness, this extension introduces immutable storage for multisampled textures.

Requires OpenGL 4.2 or ARB_texture_storage. Promoted to core in OpenGL 4.3.

Method Summary

Modifier and Type	Method and Description
static void	glTexStorage2DMultisample(int target, int samples, int internalformat, int width, int height, boolean fixedsamplelocations) Specifies storage for a two-dimensional multisample texture.
static void	glTexStorage3DMultisample(int target, int samples, int internalformat, int width, int height, int depth, boolean fixedsamplelocations) Specifies storage for a two-dimensional multisample array texture.
static void	glTextureStorage2DMultisampleEXT(int texture, int target, int samples, int internalformat, int width, int height, boolean fixedsamplelocations) DSA version of TexStorage2DMultisample.
static void	glTextureStorage3DMultisampleEXT(int texture, int target, int samples, int internalformat, int width, int height, int depth, boolean fixedsamplelocations) DSA version of TexStorage3DMultisample.

Methods inherited from class java.lang.Object

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

Method Detail

glTexStorage2DMultisample

public static void glTexStorage2DMultisample(int target,
                                             int samples,
                                             int internalformat,
                                             int width,
                                             int height,
                                             boolean fixedsamplelocations)

Specifies storage for a two-dimensional multisample texture.

Parameters:

target - the target of the operation. One of:

TEXTURE_2D_MULTISAMPLE

PROXY_TEXTURE_2D_MULTISAMPLE

samples - the number of samples in the texture

internalformat - the sized internal format to be used to store texture image data

width - the width of the texture, in texels

height - the height of the texture, in texels

fixedsamplelocations - whether the image will use identical sample locations and the same number of samples for all texels in the image, and the sample locations will not depend on the internal format or size of the image

glTexStorage3DMultisample

public static void glTexStorage3DMultisample(int target,
                                             int samples,
                                             int internalformat,
                                             int width,
                                             int height,
                                             int depth,
                                             boolean fixedsamplelocations)

Specifies storage for a two-dimensional multisample array texture.

Parameters:

target - the target of the operation. One of:

TEXTURE_2D_MULTISAMPLE_ARRAY

PROXY_TEXTURE_2D_MULTISAMPLE

samples - the number of samples in the texture

internalformat - the sized internal format to be used to store texture image data

width - the width of the texture, in texels

height - the height of the texture, in texels

depth - the depth of the texture, in texels

fixedsamplelocations - whether the image will use identical sample locations and the same number of samples for all texels in the image, and the sample locations will not depend on the internal format or size of the image

glTextureStorage2DMultisampleEXT

public static void glTextureStorage2DMultisampleEXT(int texture,
                                                    int target,
                                                    int samples,
                                                    int internalformat,
                                                    int width,
                                                    int height,
                                                    boolean fixedsamplelocations)

DSA version of TexStorage2DMultisample.

Parameters:

texture - the texture object

target - the target of the operation. One of:

TEXTURE_2D_MULTISAMPLE

PROXY_TEXTURE_2D_MULTISAMPLE

samples - the number of samples in the texture

internalformat - the sized internal format to be used to store texture image data

width - the width of the texture, in texels

height - the height of the texture, in texels

fixedsamplelocations - whether the image will use identical sample locations and the same number of samples for all texels in the image, and the sample locations will not depend on the internal format or size of the image

glTextureStorage3DMultisampleEXT

public static void glTextureStorage3DMultisampleEXT(int texture,
                                                    int target,
                                                    int samples,
                                                    int internalformat,
                                                    int width,
                                                    int height,
                                                    int depth,
                                                    boolean fixedsamplelocations)

DSA version of TexStorage3DMultisample.

Parameters:

texture - the texture object

target - the target of the operation. One of:

TEXTURE_2D_MULTISAMPLE_ARRAY

PROXY_TEXTURE_2D_MULTISAMPLE

samples - the number of samples in the texture

internalformat - the sized internal format to be used to store texture image data

width - the width of the texture, in texels

height - the height of the texture, in texels

depth - the depth of the texture, in texels

fixedsamplelocations - whether the image will use identical sample locations and the same number of samples for all texels in the image, and the sample locations will not depend on the internal format or size of the image