Package org.lwjgl.opengl

Class ARBCLEvent

java.lang.Object

org.lwjgl.opengl.ARBCLEvent

public class ARBCLEvent
extends java.lang.Object

Native bindings to the ARB_cl_event extension.

This extension allows creating OpenGL sync objects linked to OpenCL event objects, potentially improving efficiency of sharing images and buffers between the two APIs. The companion cl_khr_gl_event OpenCL extension provides the complementary functionality of creating an OpenCL event object from an OpenGL fence sync object.

Requires OpenGL 3.2 or ARB_sync. Requires an OpenCL implementation supporting sharing event objects with OpenGL.

Field Summary

Fields

Modifier and Type	Field	Description
static int	GL_SYNC_CL_EVENT_ARB	Returned in values for GetSynciv pname OBJECT_TYPE.
static int	GL_SYNC_CL_EVENT_COMPLETE_ARB	Returned in values for GetSynciv pname SYNC_CONDITION.

Method Summary

Modifier and Type	Method	Description
static long	glCreateSyncFromCLeventARB(long context, long event, int flags)	Creates a linked sync object.
static long	nglCreateSyncFromCLeventARB(long context, long event, int flags)	Unsafe version of: CreateSyncFromCLeventARB

Methods inherited from class java.lang.Object

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

Field Detail

GL_SYNC_CL_EVENT_ARB

public static final int GL_SYNC_CL_EVENT_ARB

Returned in values for GetSynciv pname OBJECT_TYPE.

See Also:

Constant Field Values

GL_SYNC_CL_EVENT_COMPLETE_ARB

public static final int GL_SYNC_CL_EVENT_COMPLETE_ARB

Returned in values for GetSynciv pname SYNC_CONDITION.

See Also:

Constant Field Values

Method Detail

nglCreateSyncFromCLeventARB

public static long nglCreateSyncFromCLeventARB(long context,
                                               long event,
                                               int flags)

Unsafe version of: CreateSyncFromCLeventARB

glCreateSyncFromCLeventARB

public static long glCreateSyncFromCLeventARB(long context,
                                              long event,
                                              int flags)

Creates a linked sync object. context and event must be handles to a valid OpenCL context and a valid event in that context, respectively. context must support sharing with GL, and must have been created with respect to the current GL context, or to a share group including the current GL context.

The status of such a sync object depends on event. When the status of event is CL_QUEUED, CL_SUBMITTED, or CL_RUNNING, the status of the linked sync object will be UNSIGNALED. When the status of event changes to CL_COMPLETE, the status of the linked sync object will become SIGNALED.

Creating a linked sync object places a reference on the linked OpenCL event object. When the sync object is deleted, the reference will be removed from the event object.

Parameters:

context - a valid OpenCL context

event - a valid OpenCL event

flags - must be 0 (placeholder for anticipated future extensions of sync object capabilities)