org.lwjgl.opengles

Class NVInternalformatSampleQuery

java.lang.Object

org.lwjgl.opengles.NVInternalformatSampleQuery

public class NVInternalformatSampleQuery
extends java.lang.Object

Native bindings to the NV_internalformat_sample_query extension.

Some OpenGL implementations support modes of multisampling which have properties which are non-obvious to applications and/or which may not be standards conformant. The idea of non-conformant AA modes is not new, and is exposed in both GLX and EGL with config caveats and the GLX_NON_CONFORMANT_CONFIG for GLX and EGL_NON_CONFORMANT_CONFIG for EGL, or by querying the EGL_CONFORMANT attribute in newer versions of EGL.

Both of these mechanisms operate on a per-config basis, which works as intended for window-based configs. However, with the advent of application-created FBOs, it is now possible to do all the multisample operations in an application-created FBO and never use a multisample window.

This extension further extends the internalformat query mechanism (first introduced by ARB_internalformat_query and extended in ARB_internalformat_query2) and introduces a mechanism for a implementation to report properties of formats that may also be dependent on the number of samples. This includes information such as whether the combination of format and samples should be considered conformant. This enables an implementation to report caveats which might apply to both window and FBO-based rendering configurations.

Some NVIDIA drivers support multisample modes which are internally implemented as a combination of multisampling and automatic supersampling in order to obtain a higher level of anti-aliasing than can be directly supported by hardware. This extension allows those properties to be queried by an application with the MULTISAMPLES_NV, SUPERSAMPLE_SCALE_X_NV and SUPERSAMPLE_SCALE_Y_NV properties. For example, a 16xAA mode might be implemented by using 4 samples and up-scaling by a factor of 2 in each of the x- and y-dimensions. In this example, the driver might report MULTSAMPLES_NV of 4, SUPERSAMPLE_SCALE_X_NV of 2, SUPERSAMPLE_SCALE_Y_NV of 2 and CONFORMANT_NV of FALSE.

Requires GLES 3.0.

Field Summary

Fields

Modifier and Type	Field and Description
static int	GL_CONFORMANT_NV Accepted by the pname parameter of GetInternalformatSampleivNV.
static int	GL_MULTISAMPLES_NV Accepted by the pname parameter of GetInternalformatSampleivNV.
static int	GL_SUPERSAMPLE_SCALE_X_NV Accepted by the pname parameter of GetInternalformatSampleivNV.
static int	GL_SUPERSAMPLE_SCALE_Y_NV Accepted by the pname parameter of GetInternalformatSampleivNV.

Method Summary

Modifier and Type	Method and Description
static void	glGetInternalformatSampleivNV(int target, int internalformat, int samples, int pname, int[] params) Array version of: GetInternalformatSampleivNV
static void	glGetInternalformatSampleivNV(int target, int internalformat, int samples, int pname, java.nio.IntBuffer params)
static void	nglGetInternalformatSampleivNV(int target, int internalformat, int samples, int pname, int bufSize, long params)

Methods inherited from class java.lang.Object

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

Field Detail

GL_MULTISAMPLES_NV

public static final int GL_MULTISAMPLES_NV

Accepted by the pname parameter of GetInternalformatSampleivNV.

See Also:

Constant Field Values

GL_SUPERSAMPLE_SCALE_X_NV

public static final int GL_SUPERSAMPLE_SCALE_X_NV

Accepted by the pname parameter of GetInternalformatSampleivNV.

See Also:

Constant Field Values

GL_SUPERSAMPLE_SCALE_Y_NV

public static final int GL_SUPERSAMPLE_SCALE_Y_NV

Accepted by the pname parameter of GetInternalformatSampleivNV.

See Also:

Constant Field Values

GL_CONFORMANT_NV

public static final int GL_CONFORMANT_NV

Accepted by the pname parameter of GetInternalformatSampleivNV.

See Also:

Constant Field Values

Method Detail

nglGetInternalformatSampleivNV

public static void nglGetInternalformatSampleivNV(int target,
                                                  int internalformat,
                                                  int samples,
                                                  int pname,
                                                  int bufSize,
                                                  long params)

glGetInternalformatSampleivNV

public static void glGetInternalformatSampleivNV(int target,
                                                 int internalformat,
                                                 int samples,
                                                 int pname,
                                                 java.nio.IntBuffer params)

glGetInternalformatSampleivNV

public static void glGetInternalformatSampleivNV(int target,
                                                 int internalformat,
                                                 int samples,
                                                 int pname,
                                                 int[] params)

Array version of: GetInternalformatSampleivNV