Package org.lwjgl.opengl

Class NVFence

java.lang.Object

org.lwjgl.opengl.NVFence

public class NVFence
extends java.lang.Object

Native bindings to the NV_fence extension.

The goal of this extension is provide a finer granularity of synchronizing GL command completion than offered by standard OpenGL, which offers only two mechanisms for synchronization: Flush and Finish. Since Flush merely assures the user that the commands complete in a finite (though undetermined) amount of time, it is, thus, of only modest utility. Finish, on the other hand, stalls CPU execution until all pending GL commands have completed. This extension offers a middle ground - the ability to "finish" a subset of the command stream, and the ability to determine whether a given command has completed or not.

This extension introduces the concept of a "fence" to the OpenGL command stream. Once the fence is inserted into the command stream, it can be queried for a given condition - typically, its completion. Moreover, the application may also request a partial Finish -- that is, all commands prior to the fence will be forced to complete until control is returned to the calling process. These new mechanisms allow for synchronization between the host CPU and the GPU, which may be accessing the same resources (typically memory).

This extension is useful in conjunction with NV_vertex_array_range to determine when vertex information has been pulled from the vertex array range. Once a fence has been tested TRUE or finished, all vertex indices issued before the fence must have been pulled. This ensures that the vertex data memory corresponding to the issued vertex indices can be safely modified (assuming no other outstanding vertex indices are issued subsequent to the fence).

Field Summary

Fields

Modifier and Type	Field and Description
static int	GL_ALL_COMPLETED_NV Accepted by the condition parameter of SetFenceNV.
static int	GL_FENCE_CONDITION_NV GL_FENCE_STATUS_NV Accepted by the pname parameter of GetFenceivNV.

Method Summary

Modifier and Type	Method and Description
static void	glDeleteFencesNV(int fence)
static void	glDeleteFencesNV(int[] fences) Array version of: DeleteFencesNV
static void	glDeleteFencesNV(java.nio.IntBuffer fences)
static void	glFinishFenceNV(int fence)
static int	glGenFencesNV()
static void	glGenFencesNV(int[] fences) Array version of: GenFencesNV
static void	glGenFencesNV(java.nio.IntBuffer fences)
static int	glGetFenceiNV(int fence, int pname)
static void	glGetFenceivNV(int fence, int pname, int[] params) Array version of: GetFenceivNV
static void	glGetFenceivNV(int fence, int pname, java.nio.IntBuffer params)
static boolean	glIsFenceNV(int fence)
static void	glSetFenceNV(int fence, int condition)
static boolean	glTestFenceNV(int fence)

Methods inherited from class java.lang.Object

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

Field Detail

GL_ALL_COMPLETED_NV

Accepted by the condition parameter of SetFenceNV.

GL_FENCE_STATUS_NV, GL_FENCE_CONDITION_NV

Accepted by the pname parameter of GetFenceivNV.

Method Detail

glDeleteFencesNV

public static void glDeleteFencesNV(java.nio.IntBuffer fences)

glDeleteFencesNV

public static void glDeleteFencesNV(int fence)

glGenFencesNV

public static void glGenFencesNV(java.nio.IntBuffer fences)

glGenFencesNV

public static int glGenFencesNV()

glIsFenceNV

public static boolean glIsFenceNV(int fence)

glTestFenceNV

public static boolean glTestFenceNV(int fence)

glGetFenceivNV

public static void glGetFenceivNV(int fence,
                                  int pname,
                                  java.nio.IntBuffer params)

glGetFenceiNV

public static int glGetFenceiNV(int fence,
                                int pname)

glFinishFenceNV

public static void glFinishFenceNV(int fence)

glSetFenceNV

public static void glSetFenceNV(int fence,
                                int condition)

glDeleteFencesNV

public static void glDeleteFencesNV(int[] fences)

Array version of: DeleteFencesNV

glGenFencesNV

public static void glGenFencesNV(int[] fences)

Array version of: GenFencesNV

glGetFenceivNV

public static void glGetFenceivNV(int fence,
                                  int pname,
                                  int[] params)

Array version of: GetFenceivNV