Package org.lwjgl.opengl
Class ARBTextureMultisample
java.lang.Object
org.lwjgl.opengl.ARBTextureMultisample
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
Modifier and TypeFieldDescriptionstatic final int
Returned by thetype
parameter of GetActiveUniform.static final int
Returned by thetype
parameter of GetActiveUniform.static final int
Accepted by thepname
parameter of GetBooleanv, GetDoublev, GetIntegerv, and GetFloatv.static final int
Accepted by thepname
parameter of GetBooleanv, GetDoublev, GetIntegerv, and GetFloatv.static final int
Accepted by thepname
parameter of GetBooleanv, GetDoublev, GetIntegerv, and GetFloatv.static final int
Accepted by thepname
parameter of GetBooleanv, GetDoublev, GetIntegerv, and GetFloatv.static final int
Accepted by thetarget
parameter of TexImage2DMultisample.static final int
Accepted by thetarget
parameter of TexImage3DMultisample.static final int
Accepted by thecap
parameter of Enable, Disable, and IsEnabled, and by thepname
parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev.static final int
Accepted by thetarget
parameter of GetBooleani_v and GetIntegeri_v.static final int
Accepted by thepname
parameter of GetMultisamplefv.static final int
Returned by thetype
parameter of GetActiveUniform.static final int
Returned by thetype
parameter of GetActiveUniform.static final int
Accepted by thetarget
parameter of BindTexture and TexImage2DMultisample.static final int
Accepted by thetarget
parameter of BindTexture and TexImage3DMultisample.static final int
Accepted by thepname
parameter of GetBooleanv, GetDoublev, GetIntegerv, and GetFloatv.static final int
Accepted by thepname
parameter of GetBooleanv, GetDoublev, GetIntegerv, and GetFloatv.static final int
Accepted by thepname
parameter of GetTexLevelParameter.static final int
Accepted by thepname
parameter of GetTexLevelParameter.static final int
Returned by thetype
parameter of GetActiveUniform.static final int
Returned by thetype
parameter of GetActiveUniform. -
Method Summary
Modifier and TypeMethodDescriptionstatic 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, 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.static void
nglGetMultisamplefv
(int pname, int index, long val) Unsafe version of:GetMultisamplefv
-
Field Details
-
GL_SAMPLE_POSITION
public static final int GL_SAMPLE_POSITIONAccepted by thepname
parameter of GetMultisamplefv.- See Also:
-
GL_SAMPLE_MASK
public static final int GL_SAMPLE_MASKAccepted by thecap
parameter of Enable, Disable, and IsEnabled, and by thepname
parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev.- See Also:
-
GL_SAMPLE_MASK_VALUE
public static final int GL_SAMPLE_MASK_VALUEAccepted by thetarget
parameter of GetBooleani_v and GetIntegeri_v.- See Also:
-
GL_TEXTURE_2D_MULTISAMPLE
public static final int GL_TEXTURE_2D_MULTISAMPLEAccepted by thetarget
parameter of BindTexture and TexImage2DMultisample.- See Also:
-
GL_PROXY_TEXTURE_2D_MULTISAMPLE
public static final int GL_PROXY_TEXTURE_2D_MULTISAMPLEAccepted by thetarget
parameter of TexImage2DMultisample.- See Also:
-
GL_TEXTURE_2D_MULTISAMPLE_ARRAY
public static final int GL_TEXTURE_2D_MULTISAMPLE_ARRAYAccepted by thetarget
parameter of BindTexture and TexImage3DMultisample.- See Also:
-
GL_PROXY_TEXTURE_2D_MULTISAMPLE_ARRAY
public static final int GL_PROXY_TEXTURE_2D_MULTISAMPLE_ARRAYAccepted by thetarget
parameter of TexImage3DMultisample.- See Also:
-
GL_MAX_SAMPLE_MASK_WORDS
public static final int GL_MAX_SAMPLE_MASK_WORDSAccepted by thepname
parameter of GetBooleanv, GetDoublev, GetIntegerv, and GetFloatv.- See Also:
-
GL_MAX_COLOR_TEXTURE_SAMPLES
public static final int GL_MAX_COLOR_TEXTURE_SAMPLESAccepted by thepname
parameter of GetBooleanv, GetDoublev, GetIntegerv, and GetFloatv.- See Also:
-
GL_MAX_DEPTH_TEXTURE_SAMPLES
public static final int GL_MAX_DEPTH_TEXTURE_SAMPLESAccepted by thepname
parameter of GetBooleanv, GetDoublev, GetIntegerv, and GetFloatv.- See Also:
-
GL_MAX_INTEGER_SAMPLES
public static final int GL_MAX_INTEGER_SAMPLESAccepted by thepname
parameter of GetBooleanv, GetDoublev, GetIntegerv, and GetFloatv.- See Also:
-
GL_TEXTURE_BINDING_2D_MULTISAMPLE
public static final int GL_TEXTURE_BINDING_2D_MULTISAMPLEAccepted by thepname
parameter of GetBooleanv, GetDoublev, GetIntegerv, and GetFloatv.- See Also:
-
GL_TEXTURE_BINDING_2D_MULTISAMPLE_ARRAY
public static final int GL_TEXTURE_BINDING_2D_MULTISAMPLE_ARRAYAccepted by thepname
parameter of GetBooleanv, GetDoublev, GetIntegerv, and GetFloatv.- See Also:
-
GL_TEXTURE_SAMPLES
public static final int GL_TEXTURE_SAMPLESAccepted by thepname
parameter of GetTexLevelParameter.- See Also:
-
GL_TEXTURE_FIXED_SAMPLE_LOCATIONS
public static final int GL_TEXTURE_FIXED_SAMPLE_LOCATIONSAccepted by thepname
parameter of GetTexLevelParameter.- See Also:
-
GL_SAMPLER_2D_MULTISAMPLE
public static final int GL_SAMPLER_2D_MULTISAMPLEReturned by thetype
parameter of GetActiveUniform.- See Also:
-
GL_INT_SAMPLER_2D_MULTISAMPLE
public static final int GL_INT_SAMPLER_2D_MULTISAMPLEReturned by thetype
parameter of GetActiveUniform.- See Also:
-
GL_UNSIGNED_INT_SAMPLER_2D_MULTISAMPLE
public static final int GL_UNSIGNED_INT_SAMPLER_2D_MULTISAMPLEReturned by thetype
parameter of GetActiveUniform.- See Also:
-
GL_SAMPLER_2D_MULTISAMPLE_ARRAY
public static final int GL_SAMPLER_2D_MULTISAMPLE_ARRAYReturned by thetype
parameter of GetActiveUniform.- See Also:
-
GL_INT_SAMPLER_2D_MULTISAMPLE_ARRAY
public static final int GL_INT_SAMPLER_2D_MULTISAMPLE_ARRAYReturned by thetype
parameter of GetActiveUniform.- See Also:
-
GL_UNSIGNED_INT_SAMPLER_2D_MULTISAMPLE_ARRAY
public static final int GL_UNSIGNED_INT_SAMPLER_2D_MULTISAMPLE_ARRAYReturned by thetype
parameter of GetActiveUniform.- See Also:
-
-
Method Details
-
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
-
nglGetMultisamplefv
public static void nglGetMultisamplefv(int pname, int index, long val) Unsafe version of:GetMultisamplefv
-
glGetMultisamplefv
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
-