Top Description Fields Constructors Methods
org.lwjgl.opengl

public Class ARBMultisample

extends Object
Class Inheritance
Imports
org.lwjgl.system.*

Native bindings to the ARB_multisample extension.

This extension provides a mechanism to antialias all GL primitives: points, lines, polygons, bitmaps, and images. The technique is to sample all primitives multiple times at each pixel. The color sample values are resolved to a single, displayable color each time a pixel is updated, so the antialiasing appears to be automatic at the application level. Because each sample includes depth and stencil information, the depth and stencil functions perform equivalently to the single-sample mode.

An additional buffer, called the multisample buffer, is added to the framebuffer. Pixel sample values, including color, depth, and stencil values, are stored in this buffer. When the framebuffer includes a multisample buffer, it does not also include separate depth or stencil buffers, even if the multisample buffer does not store depth or stencil values. Color buffers (left/right, front/back, and aux) do coexist with the multisample buffer, however.

Multisample antialiasing is most valuable for rendering polygons, because it requires no sorting for hidden surface elimination, and it correctly handles adjacent polygons, object silhouettes, and even intersecting polygons. If only points or lines are being rendered, the "smooth" antialiasing mechanism provided by the base GL may result in a higher quality image. This extension is designed to allow multisample and smooth antialiasing techniques to be alternated during the rendering of a single scene.

Field Summary

Modifier and TypeField and Description
public static final int
GL_MULTISAMPLE_ARB

Accepted by the cap parameter of Enable, Disable, and IsEnabled, and by the pname parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev.

public static final int
GL_MULTISAMPLE_BIT_ARB

Accepted by the mask parameter of PushAttrib.

public static final int
GL_SAMPLE_ALPHA_TO_COVERAGE_ARB

Accepted by the cap parameter of Enable, Disable, and IsEnabled, and by the pname parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev.

public static final int
GL_SAMPLE_ALPHA_TO_ONE_ARB

Accepted by the cap parameter of Enable, Disable, and IsEnabled, and by the pname parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev.

public static final int
GL_SAMPLE_BUFFERS_ARB

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

public static final int
GL_SAMPLE_COVERAGE_ARB

Accepted by the cap parameter of Enable, Disable, and IsEnabled, and by the pname parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev.

public static final int
GL_SAMPLE_COVERAGE_INVERT_ARB

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

public static final int
GL_SAMPLE_COVERAGE_VALUE_ARB

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

public static final int
GL_SAMPLES_ARB

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

Constructor Summary

AccessConstructor and Description
protected

Method Summary

Modifier and TypeMethod and Description
public static native void
glSampleCoverageARB(float
the desired coverage value
value
,
boolean
if true, the temporary coverage is inverted. One of:
TRUEFALSE
invert
)

Specifies simultaneously the values of SAMPLE_COVERAGE_VALUE_ARB and SAMPLE_COVERAGE_INVERT_ARB.

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

GL_MULTISAMPLE_ARBback to summary
public static final int GL_MULTISAMPLE_ARB

Accepted by the cap parameter of Enable, Disable, and IsEnabled, and by the pname parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev.

GL_MULTISAMPLE_BIT_ARBback to summary
public static final int GL_MULTISAMPLE_BIT_ARB

Accepted by the mask parameter of PushAttrib.

GL_SAMPLE_ALPHA_TO_COVERAGE_ARBback to summary
public static final int GL_SAMPLE_ALPHA_TO_COVERAGE_ARB

Accepted by the cap parameter of Enable, Disable, and IsEnabled, and by the pname parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev.

GL_SAMPLE_ALPHA_TO_ONE_ARBback to summary
public static final int GL_SAMPLE_ALPHA_TO_ONE_ARB

Accepted by the cap parameter of Enable, Disable, and IsEnabled, and by the pname parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev.

GL_SAMPLE_BUFFERS_ARBback to summary
public static final int GL_SAMPLE_BUFFERS_ARB

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

GL_SAMPLE_COVERAGE_ARBback to summary
public static final int GL_SAMPLE_COVERAGE_ARB

Accepted by the cap parameter of Enable, Disable, and IsEnabled, and by the pname parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev.

GL_SAMPLE_COVERAGE_INVERT_ARBback to summary
public static final int GL_SAMPLE_COVERAGE_INVERT_ARB

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

GL_SAMPLE_COVERAGE_VALUE_ARBback to summary
public static final int GL_SAMPLE_COVERAGE_VALUE_ARB

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

GL_SAMPLES_ARBback to summary
public static final int GL_SAMPLES_ARB

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

Constructor Detail

ARBMultisampleback to summary
protected ARBMultisample()

Method Detail

glSampleCoverageARBback to summary
public static native void glSampleCoverageARB(float value, boolean invert)

Specifies simultaneously the values of SAMPLE_COVERAGE_VALUE_ARB and SAMPLE_COVERAGE_INVERT_ARB.

If SAMPLE_COVERAGE_ARB is enabled, the fragment coverage is ANDed with another temporary coverage. This temporary coverage is a function of the value of SAMPLE_COVERAGE_VALUE_ARB. If SAMPLE_COVERAGE_INVERT_ARB is TRUE, the temporary coverage is inverted (all bit values are inverted) before it is ANDed with the fragment coverage.

Parameters
value:float

the desired coverage value

invert:boolean

if true, the temporary coverage is inverted. One of:

TRUEFALSE