Package org.lwjgl.opengl
Class ARBTextureMultisample
- java.lang.Object
-
- org.lwjgl.opengl.ARBTextureMultisample
-
public class ARBTextureMultisample extends java.lang.Object
Native bindings to the ARB_texture_multisample extension.This extension provides support for two new types of "multisample textures" - two-dimensional and two-dimensional array - as well as mechanisms to fetch a specific sample from such a texture in a shader, and to attach such textures to FBOs for rendering.
This extension also includes the following functionality, first described in NV_explicit_multisample:
- A query in the API to query the location of samples within the pixel
- An explicit control for the multisample sample mask to augment the control provided by SampleCoverage
Promoted to core in
OpenGL 3.2
.
-
-
Field Summary
Fields Modifier and Type Field and Description static int
GL_INT_SAMPLER_2D_MULTISAMPLE
GL_INT_SAMPLER_2D_MULTISAMPLE_ARRAYReturned by thetype
parameter of GetActiveUniform.static int
GL_MAX_COLOR_TEXTURE_SAMPLES
GL_MAX_DEPTH_TEXTURE_SAMPLES
GL_MAX_INTEGER_SAMPLES
GL_MAX_SAMPLE_MASK_WORDSAccepted by thepname
parameter of GetBooleanv, GetDoublev, GetIntegerv, and GetFloatv.static int
GL_PROXY_TEXTURE_2D_MULTISAMPLE
Accepted by thetarget
parameter of TexImage2DMultisample.static int
GL_PROXY_TEXTURE_2D_MULTISAMPLE_ARRAY
Accepted by thetarget
parameter of TexImage3DMultisample.static int
GL_SAMPLE_MASK
Accepted by thecap
parameter of Enable, Disable, and IsEnabled, and by thepname
parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev.static int
GL_SAMPLE_MASK_VALUE
Accepted by thetarget
parameter of GetBooleani_v and GetIntegeri_v.static int
GL_SAMPLE_POSITION
Accepted by thepname
parameter of GetMultisamplefv.static int
GL_SAMPLER_2D_MULTISAMPLE
GL_SAMPLER_2D_MULTISAMPLE_ARRAYReturned by thetype
parameter of GetActiveUniform.static int
GL_TEXTURE_2D_MULTISAMPLE
Accepted by thetarget
parameter of BindTexture and TexImage2DMultisample.static int
GL_TEXTURE_2D_MULTISAMPLE_ARRAY
Accepted by thetarget
parameter of BindTexture and TexImage3DMultisample.static int
GL_TEXTURE_BINDING_2D_MULTISAMPLE
GL_TEXTURE_BINDING_2D_MULTISAMPLE_ARRAYAccepted by thepname
parameter of GetBooleanv, GetDoublev, GetIntegerv, and GetFloatv.static int
GL_TEXTURE_FIXED_SAMPLE_LOCATIONS
GL_TEXTURE_SAMPLESAccepted by thepname
parameter of GetTexLevelParameter.static int
GL_UNSIGNED_INT_SAMPLER_2D_MULTISAMPLE
GL_UNSIGNED_INT_SAMPLER_2D_MULTISAMPLE_ARRAYReturned by thetype
parameter of GetActiveUniform.
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method and Description static float
glGetMultisamplef(int pname, int index)
Retrieves the location of a sample.static void
glGetMultisamplefv(int pname, int index, float[] val)
Array version of:GetMultisamplefv
static void
glGetMultisamplefv(int pname, int index, java.nio.FloatBuffer val)
Retrieves the location of a sample.static void
glSampleMaski(int index, int mask)
Sets the value of a sub-word of the sample mask.static void
glTexImage2DMultisample(int target, int samples, int internalformat, int width, int height, boolean fixedsamplelocations)
Establishes the data storage, format, dimensions, and number of samples of a 2D multisample texture's image.static void
glTexImage3DMultisample(int target, int samples, int internalformat, int width, int height, int depth, boolean fixedsamplelocations)
Establishes the data storage, format, dimensions, and number of samples of a 3D multisample texture's image.
-
-
-
Field Detail
-
GL_SAMPLE_POSITION
Accepted by thepname
parameter of GetMultisamplefv.
-
GL_SAMPLE_MASK
Accepted by thecap
parameter of Enable, Disable, and IsEnabled, and by thepname
parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev.
-
GL_SAMPLE_MASK_VALUE
Accepted by thetarget
parameter of GetBooleani_v and GetIntegeri_v.
-
GL_TEXTURE_2D_MULTISAMPLE
Accepted by thetarget
parameter of BindTexture and TexImage2DMultisample.
-
GL_PROXY_TEXTURE_2D_MULTISAMPLE
Accepted by thetarget
parameter of TexImage2DMultisample.
-
GL_TEXTURE_2D_MULTISAMPLE_ARRAY
Accepted by thetarget
parameter of BindTexture and TexImage3DMultisample.
-
GL_PROXY_TEXTURE_2D_MULTISAMPLE_ARRAY
Accepted by thetarget
parameter of TexImage3DMultisample.
-
GL_MAX_SAMPLE_MASK_WORDS, GL_MAX_COLOR_TEXTURE_SAMPLES, GL_MAX_DEPTH_TEXTURE_SAMPLES, GL_MAX_INTEGER_SAMPLES, GL_TEXTURE_BINDING_2D_MULTISAMPLE, GL_TEXTURE_BINDING_2D_MULTISAMPLE_ARRAY
Accepted by thepname
parameter of GetBooleanv, GetDoublev, GetIntegerv, and GetFloatv.
-
GL_TEXTURE_SAMPLES, GL_TEXTURE_FIXED_SAMPLE_LOCATIONS
Accepted by thepname
parameter of GetTexLevelParameter.
-
GL_SAMPLER_2D_MULTISAMPLE, GL_INT_SAMPLER_2D_MULTISAMPLE, GL_UNSIGNED_INT_SAMPLER_2D_MULTISAMPLE, GL_SAMPLER_2D_MULTISAMPLE_ARRAY, GL_INT_SAMPLER_2D_MULTISAMPLE_ARRAY, GL_UNSIGNED_INT_SAMPLER_2D_MULTISAMPLE_ARRAY
Returned by thetype
parameter of GetActiveUniform.
-
-
Method Detail
-
glTexImage2DMultisample
public static void glTexImage2DMultisample(int target, int samples, int internalformat, int width, int height, boolean fixedsamplelocations)
Establishes the data storage, format, dimensions, and number of samples of a 2D multisample texture's image.- Parameters:
target
- the target of the operation. One of:TEXTURE_2D_MULTISAMPLE
PROXY_TEXTURE_2D_MULTISAMPLE
samples
- the number of samples in the multisample texture's imageinternalformat
- the internal format to be used to store the multisample texture's image.internalformat
must specify a color-renderable, depth-renderable, or stencil-renderable format.width
- the width of the multisample texture's image, in texelsheight
- the height of the multisample texture's image, in texelsfixedsamplelocations
- 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
-
glTexImage3DMultisample
public static void glTexImage3DMultisample(int target, int samples, int internalformat, int width, int height, int depth, boolean fixedsamplelocations)
Establishes the data storage, format, dimensions, and number of samples of a 3D multisample texture's image.- Parameters:
target
- the target of the operation. One of:TEXTURE_2D_MULTISAMPLE_ARRAY
PROXY_TEXTURE_2D_MULTISAMPLE_ARRAY
samples
- the number of samples in the multisample texture's imageinternalformat
- the internal format to be used to store the multisample texture's image.internalformat
must specify a color-renderable, depth-renderable, or stencil-renderable format.width
- the width of the multisample texture's image, in texelsheight
- the height of the multisample texture's image, in texelsdepth
- the depth of the multisample texture's image, in texelsfixedsamplelocations
- 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
-
glGetMultisamplefv
public static void glGetMultisamplefv(int pname, int index, java.nio.FloatBuffer val)
Retrieves the location of a sample.- Parameters:
pname
- the sample parameter name. Must be:SAMPLE_POSITION
index
- the index of the sample whose position to queryval
- an array to receive the position of the sample
-
glGetMultisamplef
public static float glGetMultisamplef(int pname, int index)
Retrieves the location of a sample.- Parameters:
pname
- the sample parameter name. Must be:SAMPLE_POSITION
index
- the index of the sample whose position to query
-
glSampleMaski
public static void glSampleMaski(int index, int mask)
Sets the value of a sub-word of the sample mask.- Parameters:
index
- which 32-bit sub-word of the sample mask to updatemask
- the new value of the mask sub-word
-
glGetMultisamplefv
public static void glGetMultisamplefv(int pname, int index, float[] val)
Array version of:GetMultisamplefv
-
-