Package org.lwjgl.opengl

Class ARBMultisample

java.lang.Object

org.lwjgl.opengl.ARBMultisample

public class ARBMultisample
extends java.lang.Object

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

Fields

Modifier and Type	Field and Description
static 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.
static int	GL_MULTISAMPLE_BIT_ARB Accepted by the mask parameter of PushAttrib.
static int	GL_SAMPLE_ALPHA_TO_COVERAGE_ARB 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.
static int	GL_SAMPLE_BUFFERS_ARB Accepted by the pname parameter of GetBooleanv, GetDoublev, GetIntegerv, and GetFloatv.
static 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.
static int	GL_SAMPLE_COVERAGE_INVERT_ARB GL_SAMPLE_COVERAGE_VALUE_ARB GL_SAMPLES_ARB Accepted by the pname parameter of GetBooleanv, GetDoublev, GetIntegerv, and GetFloatv.

Method Summary

Modifier and Type	Method and Description
static void	glSampleCoverageARB(float value, boolean invert) Specifies simultaneously the values of SAMPLE_COVERAGE_VALUE_ARB and SAMPLE_COVERAGE_INVERT_ARB.

Methods inherited from class java.lang.Object

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

Field Detail

GL_MULTISAMPLE_ARB, GL_SAMPLE_ALPHA_TO_COVERAGE_ARB, GL_SAMPLE_ALPHA_TO_ONE_ARB, 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_MULTISAMPLE_BIT_ARB

Accepted by the mask parameter of PushAttrib.

GL_SAMPLE_BUFFERS_ARB, GL_SAMPLES_ARB, GL_SAMPLE_COVERAGE_VALUE_ARB, GL_SAMPLE_COVERAGE_INVERT_ARB

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

Method Detail

glSampleCoverageARB

public static 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 - the desired coverage value

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

TRUE

FALSE