Package org.lwjgl.opengl

Class NVConditionalRender

java.lang.Object

org.lwjgl.opengl.NVConditionalRender

public class NVConditionalRender
extends java.lang.Object

Native bindings to the NV_conditional_render extension.

This extension provides support for conditional rendering based on the results of an occlusion query. This mechanism allows an application to potentially reduce the latency between the completion of an occlusion query and the rendering commands depending on its result. It additionally allows the decision of whether to render to be made without application intervention.

This extension defines two new functions, BeginConditionalRenderNV and EndConditionalRenderNV, between which rendering commands may be discarded based on the results of an occlusion query. If the specified occlusion query returns a non-zero value, rendering commands between these calls are executed. If the occlusion query returns a value of zero, all rendering commands between the calls are discarded.

If the occlusion query results are not available when BeginConditionalRenderNV is executed, the mode parameter specifies whether the GL should wait for the query to complete or should simply render the subsequent geometry unconditionally.

Additionally, the extension provides a set of "by region" modes, allowing for implementations that divide rendering work by screen regions to perform the conditional query test on a region-by-region basis without checking the query results from other regions. Such a mode is useful for cases like split-frame SLI, where a frame is divided between multiple GPUs, each of which has its own occlusion query hardware.

Field Summary

Fields

Modifier and Type	Field and Description
static int	GL_QUERY_BY_REGION_NO_WAIT_NV GL_QUERY_BY_REGION_WAIT_NV GL_QUERY_NO_WAIT_NV GL_QUERY_WAIT_NV Accepted by the mode parameter of BeginConditionalRenderNV.

Method Summary

Modifier and Type	Method and Description
static void	glBeginConditionalRenderNV(int id, int mode)
static void	glEndConditionalRenderNV()

Methods inherited from class java.lang.Object

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

Field Detail

GL_QUERY_WAIT_NV, GL_QUERY_NO_WAIT_NV, GL_QUERY_BY_REGION_WAIT_NV, GL_QUERY_BY_REGION_NO_WAIT_NV

Accepted by the mode parameter of BeginConditionalRenderNV.

Method Detail

glBeginConditionalRenderNV

public static void glBeginConditionalRenderNV(int id,
                                              int mode)

glEndConditionalRenderNV

public static void glEndConditionalRenderNV()