Struct ProQue

pub struct ProQue { /* private fields */ }

An all-in-one chimera of the Program, Queue, Context and (optionally) SpatialDims types.

Handy when you only need a single context, program, and queue for your project or when using a unique context and program on each device.

All ProQue functionality is also provided separately by the Context, Queue, Program, and SpatialDims types.

Creation

There are two ways to create a ProQue:

1. [Recommended] Use ProQue::builder or ProQueBuilder::new().
2. Call ::new and pass pre-created components.

Destruction

Now handled automatically. Freely use, store, clone, discard, share among threads… put some on your toast… whatever.

Implementations

impl ProQue

pub fn builder<'b>() -> ProQueBuilder<'b>

Returns a new ProQueBuilder.

This is the recommended way to create a new ProQue.

Calling ProQueBuilder::build() will return a new ProQue.

pub fn new<D: Into<SpatialDims>>( context: Context, queue: Queue, program: Program, dims: Option<D>, ) -> ProQue

Creates a new ProQue from individual parts.

Use ::builder instead unless you know what you’re doing. Creating from components associated with different devices or contexts will cause errors later on.

pub fn kernel_builder<S>(&self, name: S) -> KernelBuilder<'_>

where S: Into<String>,

Returns a new KernelBuilder with the name, program, default queue, and global work size pre-configured.

Use ::arg to specify arguments and ::build to build the kernel.

Example

let kernel = pro_que.kernel_builder("add")
   .arg(&buffer)
   .arg(&10.0f32)
   .build()?;

See KernelBuilder documentation for more

pub fn create_buffer<T: OclPrm>(&self) -> OclResult<Buffer<T>>

Returns a new buffer.

The default dimensions and queue from this ProQue will be used.

The buffer will be filled with zeros upon creation, blocking the current thread until completion.

Use Buffer::builder() (or BufferBuilder::new()) for access to the full range of buffer creation options.

Errors

This ProQue must have been pre-configured with default dimensions. If not, set them with ::set_dims, or just create a buffer using Buffer::builder() instead.

pub fn buffer_builder<T: OclPrm>(&self) -> BufferBuilder<'_, T>

Returns a new BufferBuilder with the default queue and length pre-configured.

Use .fill_val(Default::default()) to fill buffer with zeros.

Use .build() to create the buffer.

Panics

This ProQue must have been pre-configured with default dimensions. If not, set them with ::set_dims, or just create a buffer using Buffer::builder() instead.

pub fn set_dims<S: Into<SpatialDims>>(&mut self, dims: S)

Sets the default dimensions used when creating buffers and kernels.

pub fn max_wg_size(&self) -> OclResult<usize>

Returns the maximum workgroup size supported by the device associated with this ProQue.

[UNSTABLE]: Evaluate usefulness.

pub fn queue(&self) -> &Queue

Returns a reference to the queue associated with this ProQue.

pub fn context(&self) -> &Context

Returns the contained context.

pub fn program(&self) -> &Program

Returns the current program build.

pub fn dims(&self) -> &SpatialDims

Returns the current dims or panics.

[UNSTABLE]: Evaluate which ‘dims’ method to keep. Leaning towards this version at the moment.

pub fn dims_result(&self) -> OclResult<&SpatialDims>

Returns the current dims or an error.

[UNSTABLE]: Evaluate which ‘dims’ method to keep. Leaning towards the above, panicking version at the moment.

Methods from Deref<Target = Queue>

pub fn flush(&self) -> OclResult<()>

Issues all previously queued OpenCL commands to the device.

pub fn finish(&self) -> OclResult<()>

Blocks until all commands in this queue have completed before returning.

pub fn enqueue_marker<Ewl>(&self, ewait: Option<Ewl>) -> OclResult<Event>

where Ewl: ClWaitListPtr,

Enqueues a marker command which waits for either a list of events to complete, or all previously enqueued commands to complete.

pub fn as_core(&self) -> &CommandQueueCore

Returns a reference to the core pointer wrapper, usable by functions in the core module.

pub fn context(&self) -> Context

Returns a copy of the Context associated with this queue.

pub fn device(&self) -> Device

Returns the OpenCL device associated with this queue.

pub fn device_version(&self) -> OpenclVersion

Returns the cached device version.

pub fn info( &self, info_kind: CommandQueueInfo, ) -> OclCoreResult<CommandQueueInfoResult>

Returns info about this queue.

Methods from Deref<Target = CommandQueueCore>

pub fn as_ptr(&self) -> *mut c_void

Returns a pointer, do not store it.

pub fn device(&self) -> Result<DeviceId, Error>

Returns the DeviceId associated with this command queue.

pub fn context(&self) -> Result<Context, Error>

Returns the Context associated with this command queue.

pub fn context_ptr(&self) -> Result<*mut c_void, Error>

Returns the cl_context associated with this command queue.

Trait Implementations

impl Clone for ProQue

fn clone(&self) -> ProQue

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ProQue

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Deref for ProQue

type Target = Queue

The resulting type after dereferencing.

fn deref(&self) -> &Queue

Dereferences the value.

impl MemLen for ProQue

fn to_len(&self) -> usize

Returns the exact number of elements of a volume of memory (equivalent to Vec::len()).

fn to_len_padded(&self, incr: usize) -> usize

Returns the length of a volume of memory padded to the next multiple of incr.

fn to_lens(&self) -> [usize; 3]

Returns the exact lengths of each dimension of a volume of memory.

impl WorkDims for ProQue

fn dim_count(&self) -> u32

Returns the number of dimensions defined.

fn to_work_size(&self) -> Option<[usize; 3]>

Returns an array representing the amount of work to be done by a kernel.

fn to_work_offset(&self) -> Option<[usize; 3]>

Returns an array representing the offset of a work item or memory location.