Top Description Fields Constructors Methods
org.lwjgl.opengles

public Class NVInternalformatSampleQuery

extends Object
Class Inheritance
Imports
java.nio.*, org.lwjgl.system.*

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

Modifier and TypeField and Description
public static final int
GL_CONFORMANT_NV

Accepted by the pname parameter of GetInternalformatSampleivNV.

public static final int
GL_MULTISAMPLES_NV

Accepted by the pname parameter of GetInternalformatSampleivNV.

public static final int
GL_SUPERSAMPLE_SCALE_X_NV

Accepted by the pname parameter of GetInternalformatSampleivNV.

public static final int
GL_SUPERSAMPLE_SCALE_Y_NV

Accepted by the pname parameter of GetInternalformatSampleivNV.

Constructor Summary

AccessConstructor and Description
protected

Method Summary

Modifier and TypeMethod and Description
public static void
glGetInternalformatSampleivNV(int target, int internalformat, int samples, int pname, IntBuffer params)

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

Array version of: GetInternalformatSampleivNV

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

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

GL_CONFORMANT_NVback to summary
public static final int GL_CONFORMANT_NV

Accepted by the pname parameter of GetInternalformatSampleivNV.

GL_MULTISAMPLES_NVback to summary
public static final int GL_MULTISAMPLES_NV

Accepted by the pname parameter of GetInternalformatSampleivNV.

GL_SUPERSAMPLE_SCALE_X_NVback to summary
public static final int GL_SUPERSAMPLE_SCALE_X_NV

Accepted by the pname parameter of GetInternalformatSampleivNV.

GL_SUPERSAMPLE_SCALE_Y_NVback to summary
public static final int GL_SUPERSAMPLE_SCALE_Y_NV

Accepted by the pname parameter of GetInternalformatSampleivNV.

Constructor Detail

NVInternalformatSampleQueryback to summary
protected NVInternalformatSampleQuery()

Method Detail

glGetInternalformatSampleivNVback to summary
public static void glGetInternalformatSampleivNV(int target, int internalformat, int samples, int pname, IntBuffer params)
glGetInternalformatSampleivNVback to summary
public static void glGetInternalformatSampleivNV(int target, int internalformat, int samples, int pname, int[] params)

Array version of: GetInternalformatSampleivNV

nglGetInternalformatSampleivNVback to summary
public static native void nglGetInternalformatSampleivNV(int target, int internalformat, int samples, int pname, int bufSize, long params)