Class NVFence
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
Modifier and TypeFieldDescriptionstatic final int
Accepted by thecondition
parameter of SetFenceNV.static final int
Accepted by thepname
parameter of GetFenceivNV.static final int
Accepted by thepname
parameter of GetFenceivNV. -
Method Summary
Modifier and TypeMethodDescriptionstatic void
glDeleteFencesNV
(int fence) static void
glDeleteFencesNV
(int[] fences) Array version of:DeleteFencesNV
static void
glDeleteFencesNV
(IntBuffer fences) static void
glFinishFenceNV
(int fence) static int
static void
glGenFencesNV
(int[] fences) Array version of:GenFencesNV
static void
glGenFencesNV
(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, IntBuffer params) static boolean
glIsFenceNV
(int fence) static void
glSetFenceNV
(int fence, int condition) static boolean
glTestFenceNV
(int fence) static void
nglDeleteFencesNV
(int n, long fences) static void
nglGenFencesNV
(int n, long fences) static void
nglGetFenceivNV
(int fence, int pname, long params)
-
Field Details
-
GL_ALL_COMPLETED_NV
public static final int GL_ALL_COMPLETED_NVAccepted by thecondition
parameter of SetFenceNV.- See Also:
-
GL_FENCE_STATUS_NV
public static final int GL_FENCE_STATUS_NVAccepted by thepname
parameter of GetFenceivNV.- See Also:
-
GL_FENCE_CONDITION_NV
public static final int GL_FENCE_CONDITION_NVAccepted by thepname
parameter of GetFenceivNV.- See Also:
-
-
Method Details
-
nglDeleteFencesNV
public static void nglDeleteFencesNV(int n, long fences) -
glDeleteFencesNV
-
glDeleteFencesNV
public static void glDeleteFencesNV(int fence) -
nglGenFencesNV
public static void nglGenFencesNV(int n, long fences) -
glGenFencesNV
-
glGenFencesNV
public static int glGenFencesNV() -
glIsFenceNV
public static boolean glIsFenceNV(int fence) -
glTestFenceNV
public static boolean glTestFenceNV(int fence) -
nglGetFenceivNV
public static void nglGetFenceivNV(int fence, int pname, long params) -
glGetFenceivNV
-
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
-