Class NVShadingRateImage
- java.lang.Object
-
- org.lwjgl.opengl.NVShadingRateImage
-
public class NVShadingRateImage extends java.lang.Object
Native bindings to the NV_shading_rate_image extension.By default, OpenGL runs a fragment shader once for each pixel covered by a primitive being rasterized. When using multisampling, the outputs of that fragment shader are broadcast to each covered sample of the fragment's pixel. When using multisampling, applications can also request that the fragment shader be run once per color sample (when using the
"sample"
qualifier on one or more active fragment shader inputs), or run a fixed number of times per pixel usingSAMPLE_SHADING
enable and theMinSampleShading
frequency value. In all of these approaches, the number of fragment shader invocations per pixel is fixed, based on API state.This extension allows applications to bind and enable a shading rate image that can be used to vary the number of fragment shader invocations across the framebuffer. This can be useful for applications like eye tracking for virtual reality, where the portion of the framebuffer that the user is looking at directly can be processed at high frequency, while distant corners of the image can be processed at lower frequency. The shading rate image is an immutable-format two-dimensional or two-dimensional array texture that uses a format of
R8UI
. Each texel represents a fixed-size rectangle in the framebuffer, covering 16x16 pixels in the initial implementation of this extension. When rasterizing a primitive covering one of these rectangles, the OpenGL implementation reads the texel in the bound shading rate image and looks up the fetched value in a palette of shading rates. The shading rate used can vary from (finest) 16 fragment shader invocations per pixel to (coarsest) one fragment shader invocation for each 4x4 block of pixels.When this extension is advertised by an OpenGL implementation, the implementation must also support the GLSL extension
"GL_NV_shading_rate_image"
(documented separately), which provides new built-in variables that allow fragment shaders to determine the effective shading rate used for each fragment. Additionally, the GLSL extension also provides new layout qualifiers allowing the interlock functionality provided by ARB_fragment_shader_interlock to guarantee mutual exclusion across an entire fragment when the shading rate specifies multiple pixels per fragment shader invocation.Note that this extension requires the use of a framebuffer object; the shading rate image and related state are ignored when rendering to the default framebuffer.
Requires
OpenGL 4.5
andNV_framebuffer_mixed_samples
.
-
-
Field Summary
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static void
glBindShadingRateImageNV(int texture)
static void
glGetShadingRateImagePaletteNV(int viewport, int entry, int[] rate)
Array version of:GetShadingRateImagePaletteNV
static void
glGetShadingRateImagePaletteNV(int viewport, int entry, java.nio.IntBuffer rate)
static void
glGetShadingRateSampleLocationivNV(int rate, int samples, int index, int[] location)
Array version of:GetShadingRateSampleLocationivNV
static void
glGetShadingRateSampleLocationivNV(int rate, int samples, int index, java.nio.IntBuffer location)
static void
glShadingRateImageBarrierNV(boolean synchronize)
static void
glShadingRateImagePaletteNV(int viewport, int first, int[] rates)
Array version of:ShadingRateImagePaletteNV
static void
glShadingRateImagePaletteNV(int viewport, int first, java.nio.IntBuffer rates)
static void
glShadingRateSampleOrderCustomNV(int rate, int samples, int[] locations)
Array version of:ShadingRateSampleOrderCustomNV
static void
glShadingRateSampleOrderCustomNV(int rate, int samples, java.nio.IntBuffer locations)
static void
glShadingRateSampleOrderNV(int order)
static void
nglGetShadingRateImagePaletteNV(int viewport, int entry, long rate)
static void
nglGetShadingRateSampleLocationivNV(int rate, int samples, int index, long location)
static void
nglShadingRateImagePaletteNV(int viewport, int first, int count, long rates)
static void
nglShadingRateSampleOrderCustomNV(int rate, int samples, long locations)
-
-
-
Field Detail
-
GL_SHADING_RATE_IMAGE_NV
Accepted by thecap
parameter ofEnable
,Disable
, andIsEnabled
, by thetarget
parameter ofEnablei
,Disablei
,IsEnabledi
,EnableIndexedEXT
,DisableIndexedEXT
, andIsEnabledIndexedEXT
, and by thepname
parameter ofGetBooleanv
,GetIntegerv
,GetInteger64v
,GetFloatv
,GetDoublev
,GetDoubleIndexedvEXT
,GetBooleani_v
,GetIntegeri_v
,GetInteger64i_v
,GetFloati_v
,GetDoublei_v
,GetBooleanIndexedvEXT
,GetIntegerIndexedvEXT
, andGetFloatIndexedvEXT
.
-
GL_SHADING_RATE_NO_INVOCATIONS_NV, GL_SHADING_RATE_1_INVOCATION_PER_PIXEL_NV, GL_SHADING_RATE_1_INVOCATION_PER_1X2_PIXELS_NV, GL_SHADING_RATE_1_INVOCATION_PER_2X1_PIXELS_NV, GL_SHADING_RATE_1_INVOCATION_PER_2X2_PIXELS_NV, GL_SHADING_RATE_1_INVOCATION_PER_2X4_PIXELS_NV, GL_SHADING_RATE_1_INVOCATION_PER_4X2_PIXELS_NV, GL_SHADING_RATE_1_INVOCATION_PER_4X4_PIXELS_NV, GL_SHADING_RATE_2_INVOCATIONS_PER_PIXEL_NV, GL_SHADING_RATE_4_INVOCATIONS_PER_PIXEL_NV, GL_SHADING_RATE_8_INVOCATIONS_PER_PIXEL_NV, GL_SHADING_RATE_16_INVOCATIONS_PER_PIXEL_NV
Accepted in therates
parameter ofShadingRateImagePaletteNV
and therate
parameter ofShadingRateSampleOrderCustomNV
andGetShadingRateSampleLocationivNV
; returned in therate
parameter ofGetShadingRateImagePaletteNV
.
-
GL_SHADING_RATE_IMAGE_BINDING_NV, GL_SHADING_RATE_IMAGE_TEXEL_WIDTH_NV, GL_SHADING_RATE_IMAGE_TEXEL_HEIGHT_NV, GL_SHADING_RATE_IMAGE_PALETTE_SIZE_NV, GL_MAX_COARSE_FRAGMENT_SAMPLES_NV
-
GL_SHADING_RATE_SAMPLE_ORDER_DEFAULT_NV, GL_SHADING_RATE_SAMPLE_ORDER_PIXEL_MAJOR_NV, GL_SHADING_RATE_SAMPLE_ORDER_SAMPLE_MAJOR_NV
Accepted by theorder
parameter ofShadingRateSampleOrderNV
.
-
-
Method Detail
-
glBindShadingRateImageNV
public static void glBindShadingRateImageNV(int texture)
-
nglShadingRateImagePaletteNV
public static void nglShadingRateImagePaletteNV(int viewport, int first, int count, long rates)
-
glShadingRateImagePaletteNV
public static void glShadingRateImagePaletteNV(int viewport, int first, java.nio.IntBuffer rates)
-
nglGetShadingRateImagePaletteNV
public static void nglGetShadingRateImagePaletteNV(int viewport, int entry, long rate)
-
glGetShadingRateImagePaletteNV
public static void glGetShadingRateImagePaletteNV(int viewport, int entry, java.nio.IntBuffer rate)
-
glShadingRateImageBarrierNV
public static void glShadingRateImageBarrierNV(boolean synchronize)
-
glShadingRateSampleOrderNV
public static void glShadingRateSampleOrderNV(int order)
-
nglShadingRateSampleOrderCustomNV
public static void nglShadingRateSampleOrderCustomNV(int rate, int samples, long locations)
-
glShadingRateSampleOrderCustomNV
public static void glShadingRateSampleOrderCustomNV(int rate, int samples, java.nio.IntBuffer locations)
-
nglGetShadingRateSampleLocationivNV
public static void nglGetShadingRateSampleLocationivNV(int rate, int samples, int index, long location)
-
glGetShadingRateSampleLocationivNV
public static void glGetShadingRateSampleLocationivNV(int rate, int samples, int index, java.nio.IntBuffer location)
-
glShadingRateImagePaletteNV
public static void glShadingRateImagePaletteNV(int viewport, int first, int[] rates)
Array version of:ShadingRateImagePaletteNV
-
glGetShadingRateImagePaletteNV
public static void glGetShadingRateImagePaletteNV(int viewport, int entry, int[] rate)
Array version of:GetShadingRateImagePaletteNV
-
glShadingRateSampleOrderCustomNV
public static void glShadingRateSampleOrderCustomNV(int rate, int samples, int[] locations)
Array version of:ShadingRateSampleOrderCustomNV
-
glGetShadingRateSampleLocationivNV
public static void glGetShadingRateSampleLocationivNV(int rate, int samples, int index, int[] location)
Array version of:GetShadingRateSampleLocationivNV
-
-