Package com.aparapi.device

Class OpenCLDevice

java.lang.Object

com.aparapi.device.Device

com.aparapi.device.OpenCLDevice

All Implemented Interfaces:

Comparable<Device>

public class OpenCLDevice
extends Device
implements Comparable<Device>

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	OpenCLDevice.DeviceComparitor
static interface	OpenCLDevice.DeviceSelector
static class	OpenCLDevice.OpenCLInvocationHandler<T extends OpenCL<T>>

Nested classes/interfaces inherited from class com.aparapi.device.Device

Device.TYPE

Constructor Summary

Constructors

Constructor	Description
OpenCLDevice(OpenCLPlatform _platform, long _deviceId, Device.TYPE _type)	Minimal constructor

Method Summary

Modifier and Type	Method	Description
<T extends OpenCL<T>> T	bind(Class<T> _interface)
<T extends OpenCL<T>> T	bind(Class<T> _interface, InputStream _inputStream)
<T extends OpenCL<T>> T	bind(Class<T> _interface, String _source)
void	configure()	Called by the underlying Aparapi OpenCL platform, upon device detection.
List<OpenCLArgDescriptor>	getArgs(Method m)
long	getDeviceId()
long	getGlobalMemSize()
long	getLocalMemSize()
int	getMaxComputeUnits()
long	getMaxMemAllocSize()
String	getName()
OpenCLPlatform	getOpenCLPlatform()
String	getShortDescription()
boolean	isSharedMemory()	Retrieves the shared memory flag
static List<OpenCLDevice>	listDevices(Device.TYPE type)	List OpenCLDevices of a given TYPE, or all OpenCLDevices if type == null.
static OpenCLDevice	select(OpenCLDevice.DeviceComparitor _deviceComparitor)
static OpenCLDevice	select(OpenCLDevice.DeviceComparitor _deviceComparitor, Device.TYPE _type)
static OpenCLDevice	select(OpenCLDevice.DeviceSelector _deviceSelector)
static void	setConfigurator(IOpenCLDeviceConfigurator _configurator)	Statically assigns a new configurator for all OpenCL devices detected after the assignment.
void	setGlobalMemSize(long _globalMemSize)
void	setLocalMemSize(long _localMemSize)
void	setMaxComputeUnits(int _maxComputeUnits)
void	setMaxMemAllocSize(long _maxMemAllocSize)
void	setMaxWorkItemSize(int _dim, int _value)
void	setName(String name)
void	setSharedMemory(boolean _sharedMemory)	Configure if device has the memory shared with the host memory.
String	toString()

Methods inherited from class com.aparapi.device.Device

best, bestACC, bestGPU, compareTo, createRange, createRange, createRange2D, createRange2D, createRange3D, createRange3D, equals, first, firstCPU, firstGPU, getMaxWorkGroupSize, getMaxWorkItemDimensions, getMaxWorkItemSize, getType, hashCode, setMaxWorkGroupSize, setMaxWorkItemDimensions, setMaxWorkItemSize, setType

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.Comparable

compareTo

Constructor Details

OpenCLDevice

public OpenCLDevice(OpenCLPlatform _platform,
 long _deviceId,
 Device.TYPE _type)

Minimal constructor

Parameters:

_platform -

_deviceId -

_type -

Method Details

setConfigurator

public static void setConfigurator(IOpenCLDeviceConfigurator _configurator)

Statically assigns a new configurator for all OpenCL devices detected after the assignment.

Parameters:

_configurator - the configurator instance

getOpenCLPlatform

public OpenCLPlatform getOpenCLPlatform()

getMaxComputeUnits

public int getMaxComputeUnits()

setMaxComputeUnits

public void setMaxComputeUnits(int _maxComputeUnits)

getLocalMemSize

public long getLocalMemSize()

setLocalMemSize

public void setLocalMemSize(long _localMemSize)

getMaxMemAllocSize

public long getMaxMemAllocSize()

setMaxMemAllocSize

public void setMaxMemAllocSize(long _maxMemAllocSize)

getGlobalMemSize

public long getGlobalMemSize()

setGlobalMemSize

public void setGlobalMemSize(long _globalMemSize)

setMaxWorkItemSize

public void setMaxWorkItemSize(int _dim,
 int _value)

getName

public String getName()

setName

public void setName(String name)

configure

public void configure()

Called by the underlying Aparapi OpenCL platform, upon device detection.

getDeviceId

public long getDeviceId()

Specified by:

getDeviceId in class Device

setSharedMemory

public void setSharedMemory(boolean _sharedMemory)

Configure if device has the memory shared with the host memory.
Note1: For discrete GPU devices having dedicated memory, thus not shared with host, this should be set to false. This can result in significant kernel execution speed-ups for such HW configurations. Aparapi is unable to detect this property automatically for all devices, unless the client application provides a configurator (

invalid reference

#IOpenCLDeviceConfigurator

).
Note2: By default devices are initialized has having shared memory - to maintain backwards compatibility - unless Aparapi can unequivocally identify the device.

Parameters:

_sharedMemory -

• true, if OpenCL device has the memory shared with the host memory
• false, if OpenCL device is a discrete unit, having dedicated memory, thus not shared with host

isSharedMemory

public boolean isSharedMemory()

Retrieves the shared memory flag

Returns:

• true, if OpenCL device has the memory shared with the host memory
• false, if OpenCL device is a discrete unit, having dedicated memory, thus not shared with host

getShortDescription

public String getShortDescription()

Specified by:

getShortDescription in class Device

getArgs

public List<OpenCLArgDescriptor> getArgs(Method m)

bind

public <T extends OpenCL<T>> T bind(Class<T> _interface,
 InputStream _inputStream)

bind

public <T extends OpenCL<T>> T bind(Class<T> _interface)

bind

public <T extends OpenCL<T>> T bind(Class<T> _interface,
 String _source)

listDevices

public static List<OpenCLDevice> listDevices(Device.TYPE type)

List OpenCLDevices of a given TYPE, or all OpenCLDevices if type == null.

select

public static OpenCLDevice select(OpenCLDevice.DeviceSelector _deviceSelector)

select

public static OpenCLDevice select(OpenCLDevice.DeviceComparitor _deviceComparitor)

select

public static OpenCLDevice select(OpenCLDevice.DeviceComparitor _deviceComparitor,
 Device.TYPE _type)

toString

public String toString()

Overrides:

toString in class Object