Package org.lwjgl.opencl

Class CL21


  • public class CL21
extends java.lang.Object
    The core OpenCL 2.1 functionality.

    • Field Detail

      • CL_PLATFORM_HOST_TIMER_RESOLUTION

        public static final int CL_PLATFORM_HOST_TIMER_RESOLUTION
        cl_platform_info
        See Also:
        Constant Field Values

      • CL_DEVICE_IL_VERSION

        public static final int CL_DEVICE_IL_VERSION
        cl_device_info
        See Also:
        Constant Field Values

      • CL_DEVICE_MAX_NUM_SUB_GROUPS

        public static final int CL_DEVICE_MAX_NUM_SUB_GROUPS
        cl_device_info
        See Also:
        Constant Field Values

      • CL_DEVICE_SUB_GROUP_INDEPENDENT_FORWARD_PROGRESS

        public static final int CL_DEVICE_SUB_GROUP_INDEPENDENT_FORWARD_PROGRESS
        cl_device_info
        See Also:
        Constant Field Values

      • CL_QUEUE_DEVICE_DEFAULT

        public static final int CL_QUEUE_DEVICE_DEFAULT
        cl_command_queue_info
        See Also:
        Constant Field Values

      • CL_UNORM_INT_101010_2

        public static final int CL_UNORM_INT_101010_2
        cl_channel_type
        See Also:
        Constant Field Values

      • CL_KERNEL_MAX_NUM_SUB_GROUPS

        public static final int CL_KERNEL_MAX_NUM_SUB_GROUPS
        cl_kernel_info
        See Also:
        Constant Field Values

      • CL_KERNEL_COMPILE_NUM_SUB_GROUPS

        public static final int CL_KERNEL_COMPILE_NUM_SUB_GROUPS
        cl_kernel_info
        See Also:
        Constant Field Values

      • CL_KERNEL_MAX_SUB_GROUP_SIZE_FOR_NDRANGE

        public static final int CL_KERNEL_MAX_SUB_GROUP_SIZE_FOR_NDRANGE
        cl_kernel_sub_group_info
        See Also:
        Constant Field Values

      • CL_KERNEL_SUB_GROUP_COUNT_FOR_NDRANGE

        public static final int CL_KERNEL_SUB_GROUP_COUNT_FOR_NDRANGE
        cl_kernel_sub_group_info
        See Also:
        Constant Field Values

      • CL_KERNEL_LOCAL_SIZE_FOR_SUB_GROUP_COUNT

        public static final int CL_KERNEL_LOCAL_SIZE_FOR_SUB_GROUP_COUNT
        cl_kernel_sub_group_info
        See Also:
        Constant Field Values

    • Method Detail

      • clSetDefaultDeviceCommandQueue

        public static int clSetDefaultDeviceCommandQueue(long context,
                                                 long device,
                                                 long command_queue)
        Replaces a default device command queue created with CreateCommandQueueWithProperties and the QUEUE_ON_DEVICE_DEFAULT flag.
        Parameters:
        context - a valid OpenCL context
        device - a OpenCL device associated with context
        command_queue - a valid command-queue for device
        Returns:
        SUCCESS if the function is executed successfully. Otherwise, it returns one of the following errors:
        • INVALID_CONTEXT if context is not a valid context.
        • INVALID_DEVICE if device is not a valid device or is not associated with context.
        • INVALID_COMMAND_QUEUE if command_queue is not a valid command-queue.
        • OUT_OF_RESOURCES if there is a failure to allocate resources required by the OpenCL implementation on the device.
        • OUT_OF_HOST_MEMORY if there is a failure to allocate resources required by the OpenCL implementation on the host.

      • clGetDeviceAndHostTimer

        public static int clGetDeviceAndHostTimer(long device,
                                          java.nio.LongBuffer device_timestamp,
                                          java.nio.LongBuffer host_timestamp)
        Returns a reasonably synchronized pair of timestamps from the device timer and the host timer as seen by device. Implementations may need to execute this query with a high latency in order to provide reasonable synchronization of the timestamps. The host timestamp and device timestamp returned by this function and GetHostTimer each have an implementation defined timebase. The timestamps will always be in their respective timebases regardless of which query function is used. The timestamp returned from GetEventProfilingInfo for an event on a device and a device timestamp queried from the same device will always be in the same timebase.
        Parameters:
        device - a device returned by GetDeviceIDs
        device_timestamp - will be updated with the value of the device timer in nanoseconds. The resolution of the timer is the same as the device profiling timer returned by GetDeviceInfo and the DEVICE_PROFILING_TIMER_RESOLUTION query.
        host_timestamp - will be updated with the value of the host timer in nanoseconds at the closest possible point in time to that at which device_timestamp was returned. The resolution of the timer may be queried via GetPlatformInfo and the flag PLATFORM_HOST_TIMER_RESOLUTION.
        Returns:
        SUCCESS with a time value in host_timestamp if provided. Otherwise, it returns one of the following errors:
        • INVALID_DEVICE if device is not a valid OpenCL device.
        • INVALID_VALUE if host_timestamp or device_timestamp is NULL.
        • OUT_OF_RESOURCES if there is a failure to allocate resources required by the OpenCL implementation on the device.
        • OUT_OF_HOST_MEMORY if there is a failure to allocate resources required by the OpenCL implementation on the host.

      • clGetHostTimer

        public static int clGetHostTimer(long device,
                                 java.nio.LongBuffer host_timestamp)
        Returns the current value of the host clock as seen by device. This value is in the same timebase as the host_timestamp returned from GetDeviceAndHostTimer. The implementation will return with as low a latency as possible to allow a correlation with a subsequent application sampled time. The host timestamp and device timestamp returned by this function and GetDeviceAndHostTimer each have an implementation defined timebase. The timestamps will always be in their respective timebases regardless of which query function is used. The timestamp returned from GetEventProfilingInfo for an event on a device and a device timestamp queried from the same device will always be in the same timebase.
        Parameters:
        device - a device returned by GetDeviceIDs
        host_timestamp - will be updated with the value of the current timer in nanoseconds. The resolution of the timer may be queried via GetPlatformInfo and the flag PLATFORM_HOST_TIMER_RESOLUTION.
        Returns:
        SUCCESS with a time value in host_timestamp if provided. Otherwise, it returns one of the following errors:
        • INVALID_DEVICE if device is not a valid OpenCL device.
        • INVALID_VALUE if host_timestamp is NULL.
        • OUT_OF_RESOURCES if there is a failure to allocate resources required by the OpenCL implementation on the device.
        • OUT_OF_HOST_MEMORY if there is a failure to allocate resources required by the OpenCL implementation on the host.

      • clCreateProgramWithIL

        public static long clCreateProgramWithIL(long context,
                                         java.nio.ByteBuffer il,
                                         java.nio.IntBuffer errcode_ret)
        Creates a program object for a context, and loads the IL pointed to by il and with length in bytes length into the program object.
        Parameters:
        context - a valid OpenCL context
        il - a pointer to a length-byte block of memory containing SPIR-V or an implementation-defined intermediate language
        errcode_ret - will return an appropriate error code. If errcode_ret is NULL, no error code is returned.
        Returns:
        a valid non-zero program object and errcode_ret is set to SUCCESS if the program object is created successfully. Otherwise, it returns a NULL value with one of the following error values returned in errcode_ret:
        • INVALID_CONTEXT if context is not a valid context.
        • INVALID_VALUE if il is NULL or if length is zero.
        • INVALID_VALUE if the length-byte memory pointed to by il does not contain well-formed intermediate language input that can be consumed by the OpenCL runtime.
        • OUT_OF_RESOURCES if there is a failure to allocate resources required by the OpenCL implementation on the device.
        • OUT_OF_HOST_MEMORY if there is a failure to allocate resources required by the OpenCL implementation on the host.

      • clCloneKernel

        public static long clCloneKernel(long source_kernel,
                                 java.nio.IntBuffer errcode_ret)
        Makes a shallow copy of the kernel object, its arguments and any information passed to the kernel object using SetKernelExecInfo. If the kernel object was ready to be enqueued before copying it, the clone of the kernel object is ready to enqueue.

        The returned kernel object is an exact copy of source_kernel, with one caveat: the reference count on the returned kernel object is set as if it had been returned by CreateKernel. The reference count of source_kernel will not be changed.

        The resulting kernel will be in the same state as if CreateKernel is called to create the resultant kernel with the same arguments as those used to create source_kernel, the latest call to SetKernelArg or SetKernelArgSVMPointer for each argument index applied to kernel and the last call to SetKernelExecInfo for each value of the param name parameter are applied to the new kernel object.

        All arguments of the new kernel object must be intact and it may be correctly used in the same situations as kernel except those that assume a pre-existing reference count. Setting arguments on the new kernel object will not affect source_kernel except insofar as the argument points to a shared underlying entity and in that situation behavior is as if two kernel objects had been created and the same argument applied to each. Only the data stored in the kernel object is copied; data referenced by the kernel's arguments are not copied. For example, if a buffer or pointer argument is set on a kernel object, the pointer is copied but the underlying memory allocation is not.

        Parameters:
        source_kernel - a valid cl_kernel object that will be copied. source_kernel will not be modified in any way by this function.
        errcode_ret - will return an appropriate error code. If errcode_ret is NULL, no error code is returned.
        Returns:
        a valid non-zero kernel object and errcode_ret is set to SUCCESS if the kernel is successfully copied. Otherwise it returns a NULL value with one of the following error values returned in errcode_ret:
        • INVALID_KERNEL if source_kernel is not a valid kernel object.
        • OUT_OF_RESOURCES if there is a failure to allocate resources required by the OpenCL implementation on the device.
        • OUT_OF_HOST_MEMORY if there is a failure to allocate resources required by the OpenCL implementation on the host.

      • clGetKernelSubGroupInfo

        public static int clGetKernelSubGroupInfo(long kernel,
                                          long device,
                                          int param_name,
                                          java.nio.ByteBuffer input_value,
                                          java.nio.ByteBuffer param_value,
                                          PointerBuffer param_value_size_ret)
        Returns information about the kernel object.
        Parameters:
        kernel - the kernel object being queried
        device - a specific device in the list of devices associated with kernel. The list of devices is the list of devices in the OpenCL context that is associated with kernel. If the list of devices associated with kernel is a single device, device can be a NULL value.
        param_name - the information to query. One of:
        KERNEL_MAX_NUM_SUB_GROUPSKERNEL_COMPILE_NUM_SUB_GROUPS
        KERNEL_MAX_SUB_GROUP_SIZE_FOR_NDRANGEKERNEL_SUB_GROUP_COUNT_FOR_NDRANGE
        KERNEL_LOCAL_SIZE_FOR_SUB_GROUP_COUNT
        input_value - a pointer to memory where the appropriate parameterization of the query is passed from. If input_value is NULL, it is ignored.
        param_value - a pointer to memory where the appropriate result being queried is returned. If param_value is NULL, it is ignored.
        param_value_size_ret - the actual size in bytes of data being queried by param_value. If NULL, it is ignored.
        Returns:
        SUCCESS if the function is executed successfully. Otherwise, it returns one of the following errors:
        • INVALID_DEVICE if device is not in the list of devices associated with kernel or if device is NULL but there is more than one device associated with kernel.
        • INVALID_VALUE if param_name is not valid, or if size in bytes specified by param_value is < size of return type and param_value is not NULL.
        • INVALID_VALUE if param_name is KERNEL_SUB_GROUP_SIZE_FOR_NDRANGE and the size in bytes specified by input_value_size is not valid or if input_value is NULL.
        • INVALID_KERNEL if kernel is not a valid kernel object.
        • OUT_OF_RESOURCES if there is a failure to allocate resources required by the OpenCL implementation on the device.
        • OUT_OF_HOST_MEMORY if there is a failure to allocate resources required by the OpenCL implementation on the host.

      • clGetKernelSubGroupInfo

        public static int clGetKernelSubGroupInfo(long kernel,
                                          long device,
                                          int param_name,
                                          java.nio.ByteBuffer input_value,
                                          PointerBuffer param_value,
                                          PointerBuffer param_value_size_ret)
        PointerBuffer version of: GetKernelSubGroupInfo

      • clEnqueueSVMMigrateMem

        public static int clEnqueueSVMMigrateMem(long command_queue,
                                         PointerBuffer svm_pointers,
                                         PointerBuffer sizes,
                                         long flags,
                                         PointerBuffer event_wait_list,
                                         PointerBuffer event)
        Enqueues a command to indicate which device a set of ranges of SVM allocations should be associated with. Once the event returned by clEnqueueSVMMigrateMem has become COMPLETE, the ranges specified by svm pointers and sizes have been successfully migrated to the device associated with command queue.

        The user is responsible for managing the event dependencies associated with this command in order to avoid overlapping access to SVM allocations. Improperly specified event dependencies passed to clEnqueueSVMMigrateMem could result in undefined results.

        Parameters:
        command_queue - a valid host command queue. The specified set of allocation ranges will be migrated to the OpenCL device associated with command_queue.
        svm_pointers - a pointer to an array of pointers. Each pointer in this array must be within an allocation produced by a call to SVMAlloc.
        sizes - an array of sizes. The pair svm_pointers[i] and sizes[i] together define the starting address and number of bytes in a range to be migrated. sizes may be NULL indicating that every allocation containing any svm_pointer[i] is to be migrated. Also, if sizes[i] is zero, then the entire allocation containing svm_pointer[i] is migrated.
        flags - a bit-field that is used to specify migration options
        event_wait_list - a list of events that need to complete before this particular command can be executed. If event_wait_list is NULL, then this particular command does not wait on any event to complete. The events specified in event_wait_list act as synchronization points. The context associated with events in event_wait_list and command_queue must be the same.
        event - Returns an event object that identifies this particular command and can be used to query or queue a wait for this particular command to complete. event can be NULL in which case it will not be possible for the application to query the status of this command or queue a wait for this command to complete. If the event_wait_list and the event arguments are not NULL, the event argument should not refer to an element of the event_wait_list array.
        Returns:
        SUCCESS if the function is executed successfully. Otherwise, it returns one of the following errors:
        • INVALID_COMMAND_QUEUE if command_queue is not a valid command-queue.
        • INVALID_CONTEXT if the context associated with command_queue and events in event_wait_list are not the same
        • INVALID_VALUE if num_svm_pointers is zero or svm_pointers is NULL.
        • INVALID_VALUE if sizes[i] is non-zero range [svm_pointers[i], svm_pointers[i]+sizes[i]) is not contained within an existing SVMAlloc allocation.
        • INVALID_EVENT_WAIT_LIST if event_wait_list is NULL and num_events_in_wait_list > 0, or event_wait_list is not NULL and num_events_in_wait_list is 0, or if event objects in event_wait_list are not valid events.
        • OUT_OF_RESOURCES if there is a failure to allocate resources required by the OpenCL implementation on the device.
        • OUT_OF_HOST_MEMORY if there is a failure to allocate resources required by the OpenCL implementation on the host.

      • clGetDeviceAndHostTimer

        public static int clGetDeviceAndHostTimer(long device,
                                          long[] device_timestamp,
                                          long[] host_timestamp)
        Array version of: GetDeviceAndHostTimer

      • clGetHostTimer

        public static int clGetHostTimer(long device,
                                 long[] host_timestamp)
        Array version of: GetHostTimer

      • clCreateProgramWithIL

        public static long clCreateProgramWithIL(long context,
                                         java.nio.ByteBuffer il,
                                         int[] errcode_ret)
        Array version of: CreateProgramWithIL

      • clCloneKernel

        public static long clCloneKernel(long source_kernel,
                                 int[] errcode_ret)
        Array version of: CloneKernel