Struct blaze_rs::buffer::rect::RectBuffer2D

pub struct RectBuffer2D<T, C: Context = Global> { /* private fields */ }

Buffer that conatins a 2D rectangle.

Implementations

impl<T> RectBuffer2D<T>

pub fn new( v: &[T], width: usize, access: MemAccess, alloc: bool ) -> Result<Self>where T: Copy,

Creates a new rectangular buffer from the specified values in row-major order.

pub fn from_rect( v: &RectBox2D<T>, access: MemAccess, alloc: bool ) -> Result<Self>where T: Copy,

pub fn new_uninit( width: usize, height: usize, access: MemAccess, alloc: bool ) -> Result<RectBuffer2D<MaybeUninit<T>>>

pub unsafe fn create( width: usize, height: usize, flags: MemFlags, host_ptr: Option<NonNull<T>> ) -> Result<Self>

impl<T, C: Context> RectBuffer2D<T, C>

pub fn new_in( ctx: C, v: &[T], width: usize, access: MemAccess, alloc: bool ) -> Result<Self>where T: Copy,

Creates a new rectangular buffer, in the specified context, from the specified values in row-major order.

pub fn from_rect_in( ctx: C, v: &Rect2D<T>, access: MemAccess, alloc: bool ) -> Result<Self>where T: Copy,

Creates new rectangular buffer

pub fn new_uninit_in( ctx: C, width: usize, height: usize, access: MemAccess, alloc: bool ) -> Result<RectBuffer2D<MaybeUninit<T>, C>>

pub unsafe fn create_in( ctx: C, width: usize, height: usize, flags: MemFlags, host_ptr: Option<NonNull<T>> ) -> Result<Self>

pub fn as_flat(&self) -> &Buffer<T, C>

pub fn as_mut_flat(&mut self) -> &mut Buffer<T, C>

pub fn flatten(self) -> Buffer<T, C>

pub unsafe fn transmute<U: Copy>(self) -> RectBuffer2D<U, C>

impl<T: Copy, C: Context> RectBuffer2D<MaybeUninit<T>, C>

pub unsafe fn assume_init(self) -> RectBuffer2D<T, C>

impl<T, C: Context> RectBuffer2D<T, C>

pub fn width(&self) -> usize

pub fn height(&self) -> Result<usize>

pub fn row_pitch(&self) -> usize

pub fn slice_pitch(&self) -> Result<usize>

pub fn row_and_slice_pitch(&self) -> Result<(usize, usize)>

impl<T: Copy, C: Context> RectBuffer2D<T, C>

pub fn read<'scope, 'env, R: IntoRange2D>( &'env self, scope: &'scope Scope<'scope, 'env, C>, range: R, wait: WaitList<'_> ) -> Result<ReadEvent<'scope, T, C>>

Available on crate feature cl1_1 only.

pub fn read_blocking<R: IntoRange2D>( &self, range: R, wait: WaitList<'_> ) -> Result<RectBox2D<T>>

Available on crate feature cl1_1 only.

pub fn write<'scope, 'env>( &'env mut self, scope: &'scope Scope<'scope, 'env, C>, offset_dst: impl Into<Option<[usize; 2]>>, src: (&'env [T], usize), offset_src: impl Into<Option<[usize; 2]>>, region: impl Into<Option<[usize; 2]>>, wait: WaitList<'_> ) -> Result<WriteEvent<'scope, T, C>>

Available on crate feature cl1_1 only.

pub fn write_blocking( &mut self, offset_dst: impl Into<Option<[usize; 2]>>, src: (&[T], usize), offset_src: impl Into<Option<[usize; 2]>>, region: impl Into<Option<[usize; 2]>>, wait: WaitList<'_> ) -> Result<()>

Available on crate feature cl1_1 only.

pub fn copy_from<'scope, 'env>( &'env mut self, scope: &'scope Scope<'scope, 'env, C>, offset_dst: impl Into<Option<[usize; 2]>>, src: &'env Self, offset_src: impl Into<Option<[usize; 2]>>, region: impl Into<Option<[usize; 2]>>, wait: WaitList<'_> ) -> Result<CopyEvent<'scope, T, C>>

Available on crate feature cl1_1 only.

pub fn copy_from_blocking( &mut self, offset_dst: impl Into<Option<[usize; 2]>>, src: &Self, offset_src: impl Into<Option<[usize; 2]>>, region: impl Into<Option<[usize; 2]>>, wait: WaitList<'_> ) -> Result<()>

Available on crate feature cl1_1 only.

pub fn copy_to<'scope, 'env>( &'env self, scope: &'scope Scope<'scope, 'env, C>, offset_src: impl Into<Option<[usize; 2]>>, dst: &'env mut Self, offset_dst: impl Into<Option<[usize; 2]>>, region: impl Into<Option<[usize; 2]>>, wait: WaitList<'_> ) -> Result<CopyEvent<'scope, T, C>>

Available on crate feature cl1_1 only.

pub fn copy_to_blocking( &self, offset_src: impl Into<Option<[usize; 2]>>, dst: &mut Self, offset_dst: impl Into<Option<[usize; 2]>>, region: impl Into<Option<[usize; 2]>>, wait: WaitList<'_> ) -> Result<()>

Available on crate feature cl1_1 only.

Methods from Deref<Target = Buffer<T, C>>

pub fn len(&self) -> Result<usize>

Number of elements inside the buffer

pub fn context(&self) -> &C

Returns a reference to the Buffer’s underlying Context.

pub fn slice<R: IntoRange>(&self, range: R) -> Result<Buf<'_, T, C>>where C: Clone,

Available on crate feature cl1_1 only.

Creates a shared slice of this buffer.

pub fn slice_mut<R: IntoRange>(&mut self, range: R) -> Result<BufMut<'_, T, C>>where C: Clone,

Available on crate feature cl1_1 only.

Creates a mutable slice of this buffer.

pub fn chunks_exact(&self, offset: usize, len: usize) -> ChunksExact<'_, T, C> where C: Clone,

Available on crate feature cl1_1 only.

Returns an iterator over chunks of size len of the buffer, starting at offset.

pub fn chunks_exact_mut( &mut self, offset: usize, len: usize ) -> ChunksExactMut<'_, T, C> where C: Clone,

Available on crate feature cl1_1 only.

Returns an iterator over mutable chunks of size len of the buffer, starting at offset.

This is usefull for situations where you want to write to the same buffer in parallel, in regions that don’t overlap.

pub fn as_uninit(&self) -> &Buffer<MaybeUninit<T>, C>

Converts &Buffer<T,C> to &Buffer<MaybeUninit<T>,C>

pub fn as_mut_uninit(&mut self) -> &mut Buffer<MaybeUninit<T>, C>

Converts &mut Buffer<T,C> to &mut Buffer<MaybeUninit<T>,C>

pub fn try_clone(&self, wait: WaitList<'_>) -> Result<Self>where T: Clone, C: Clone,

pub async fn try_clone_async<'a>(&self, wait: WaitList<'a>) -> Result<Self>where T: Clone, C: Clone,

Available on crate feature futures only.

pub fn eq_buffer(&self, other: &Buffer<T, C>) -> bool

Checks if the buffer pointer is the same in both buffers.

pub fn write_init<'scope, 'env, O: Into<Option<usize>>>( &'env mut self, scope: &'scope Scope<'scope, 'env, C>, offset: O, src: &'env [T], wait: WaitList<'_> ) -> Result<WriteEvent<'scope, MaybeUninit<T>, C>>

Convenience method for writing to an unitialized buffer. See write.

pub fn write_init_blocking( &mut self, offset: impl Into<Option<usize>>, src: &[T], wait: WaitList<'_> ) -> Result<()>

Convenience method for writing to an unitialized buffer. See write_blocking.

pub fn copy_from_init<'scope, 'env, Dst: Into<Option<usize>>, Src: Into<Option<usize>>, Size: Into<Option<usize>>>( &'env mut self, scope: &'scope Scope<'scope, 'env, C>, dst_offset: Dst, src: &'env Buffer<T, C>, src_offset: Src, size: Size, wait: WaitList<'_> ) -> Result<CopyEvent<'scope, MaybeUninit<T>, C>>

Convenience method for copying to an unitialized buffer. See copy_from.

pub fn copy_from_init_blocking( &mut self, dst_offset: impl Into<Option<usize>>, src: &Buffer<T, C>, src_offset: impl Into<Option<usize>>, size: impl Into<Option<usize>>, wait: WaitList<'_> ) -> Result<()>where T: Copy + Send + Sync,

Convenience method for copying to an unitialized buffer. See copy_from_blocking.

pub fn fill_init<'scope, 'env, R: IntoRange>( &'env mut self, scope: &'scope Scope<'scope, 'env, C>, v: T, range: R, wait: WaitList<'_> ) -> Result<FillEvent<'scope, MaybeUninit<T>, C>>

Available on crate feature cl1_2 only.

Convenience method for filling an unitialized buffer. See fill.

pub fn fill_init_blocking( &mut self, v: T, range: impl IntoRange, wait: WaitList<'_> ) -> Result<()>

Available on crate feature cl1_2 only.

Convenience method for filling an unitialized buffer. See fill_blocking.

pub fn get_blocking(&self, idx: usize, wait: WaitList<'_>) -> Result<T>

Reads the contents of the buffer at the specified index, blocking the current thread until the operation has completed.

pub fn get<'scope, 'env>( &'env self, scope: &'scope Scope<'scope, 'env, C>, idx: usize, wait: WaitList<'_> ) -> Result<GetEvent<'scope, T, C>>where T: 'static + Send,

Reads the contents of the buffer at the specified index, blocking the current thread until the operation has completed.

pub fn read<'scope, 'env, R: IntoRange>( &'env self, scope: &'scope Scope<'scope, 'env, C>, range: R, wait: WaitList<'_> ) -> Result<ReadEvent<'scope, T, C>>

Reads the contents of the buffer.

pub fn read_blocking<R: IntoRange>( &self, range: R, wait: WaitList<'_> ) -> Result<Vec<T>>

Reads the contents of the buffer, blocking the current thread until the operation has completed.

pub fn read_into<'scope, 'env, O: Into<Option<usize>>>( &'env self, s: &'scope Scope<'scope, 'env, C>, offset: O, dst: &'env mut [T], wait: WaitList<'_> ) -> Result<ReadIntoEvent<'scope, T, C>>

Reads the contents of the buffer into dst.

pub fn read_into_blocking( &self, offset: impl Into<Option<usize>>, dst: &mut [T], wait: WaitList<'_> ) -> Result<()>

Reads the contents of the buffer into dst, blocking the current thread until the operation has completed.

pub fn write<'scope, 'env, O: Into<Option<usize>>>( &'env mut self, scope: &'scope Scope<'scope, 'env, C>, offset: O, src: &'env [T], wait: WaitList<'_> ) -> Result<WriteEvent<'scope, T, C>>

Writes the contents of src into the buffer

pub fn write_blocking( &mut self, offset: impl Into<Option<usize>>, src: &[T], wait: WaitList<'_> ) -> Result<()>

Writes the contents of src into the buffer, blocking the current thread until the operation has completed.

pub fn copy_to<'scope, 'env, Src: Into<Option<usize>>, Dst: Into<Option<usize>>, Size: Into<Option<usize>>>( &'env self, scope: &'scope Scope<'scope, 'env, C>, src_offset: Src, dst: &'env mut Self, dst_offset: Dst, size: Size, wait: WaitList<'_> ) -> Result<CopyEvent<'scope, T, C>>

Copies the contents from self to dst

pub fn copy_to_blocking( &self, src_offset: impl Into<Option<usize>>, dst: &mut Self, dst_offset: impl Into<Option<usize>>, size: impl Into<Option<usize>>, wait: WaitList<'_> ) -> Result<()>

Copies the contents from self to dst, blocking the current thread until the operation has completed.

pub fn copy_from<'scope, 'env, Dst: Into<Option<usize>>, Src: Into<Option<usize>>, Size: Into<Option<usize>>>( &'env mut self, s: &'scope Scope<'scope, 'env, C>, dst_offset: Dst, src: &'env Self, src_offset: Src, size: Size, wait: WaitList<'_> ) -> Result<CopyEvent<'scope, T, C>>

Copies the contents from src to self

pub fn copy_from_blocking( &mut self, dst_offset: impl Into<Option<usize>>, src: &Self, src_offset: impl Into<Option<usize>>, size: impl Into<Option<usize>>, wait: WaitList<'_> ) -> Result<()>

Copies the contents from src to self, blocking the current thread until the operation has completed.

pub fn fill<'scope, 'env, R: IntoRange>( &'env mut self, scope: &'scope Scope<'scope, 'env, C>, v: T, range: R, wait: WaitList<'_> ) -> Result<FillEvent<'scope, T, C>>

Available on crate feature cl1_2 only.

Fills a region of the buffer with v

pub fn fill_blocking<R: IntoRange>( &mut self, v: T, range: R, wait: WaitList<'_> ) -> Result<()>

Available on crate feature cl1_2 only.

Fills a region of the buffer with v, blocking the current thread until the operation has completed.

pub fn map<'scope, 'env, R: IntoRange>( &'env self, s: &'scope Scope<'scope, 'env, C>, range: R, wait: WaitList<'_> ) -> Result<BufferMapEvent<'scope, 'env, T, C>>

pub fn map_blocking<'a, R: IntoRange>( &'a self, range: R, wait: WaitList<'_> ) -> Result<MapGuard<'a, T, C>>

pub fn map_mut<'scope, 'env, R: IntoRange>( &'env mut self, s: &'scope Scope<'scope, 'env, C>, range: R, wait: WaitList<'_> ) -> Result<BufferMapMutEvent<'scope, 'env, T, C>>

pub fn map_mut_blocking<'a, R: IntoRange>( &'a mut self, range: R, wait: WaitList<'_> ) -> Result<MapMutGuard<'a, T, C>>

Methods from Deref<Target = RawBuffer>

pub unsafe fn create_sub_buffer( &self, flags: MemAccess, region: BufferRange ) -> Result<RawBuffer>

Available on crate feature cl1_1 only.

Creates a new buffer object (referred to as a sub-buffer object) from an existing buffer object.

pub unsafe fn read_to_ptr( &self, range: BufferRange, dst: *mut c_void, wait: WaitList<'_> ) -> Result<RawEvent>

pub unsafe fn read_rect_to_ptr( &self, buffer_origin: [usize; 3], host_origin: [usize; 3], region: [usize; 3], buffer_row_pitch: Option<usize>, buffer_slice_pitch: Option<usize>, host_row_pitch: Option<usize>, host_slice_pitch: Option<usize>, dst: *mut c_void, wait: WaitList<'_> ) -> Result<RawEvent>

Available on crate feature cl1_1 only.

pub unsafe fn write_from_ptr( &mut self, range: BufferRange, src: *const c_void, wait: WaitList<'_> ) -> Result<RawEvent>

pub unsafe fn write_rect_from_ptr( &mut self, buffer_origin: [usize; 3], host_origin: [usize; 3], region: [usize; 3], buffer_row_pitch: Option<usize>, buffer_slice_pitch: Option<usize>, host_row_pitch: Option<usize>, host_slice_pitch: Option<usize>, src: *const c_void, wait: WaitList<'_> ) -> Result<RawEvent>

Available on crate feature cl1_1 only.

pub unsafe fn copy_from( &mut self, dst_offset: usize, src: &RawBuffer, src_offset: usize, size: usize, wait: WaitList<'_> ) -> Result<RawEvent>

pub unsafe fn fill_raw<T: Copy>( &mut self, v: T, range: BufferRange, wait: WaitList<'_> ) -> Result<RawEvent>

Available on crate feature cl1_2 only.

pub unsafe fn map_read( &self, range: BufferRange, wait: WaitList<'_> ) -> Result<(*const c_void, RawEvent)>

pub unsafe fn map_write( &self, range: BufferRange, wait: WaitList<'_> ) -> Result<(*mut c_void, RawEvent)>

pub unsafe fn map_read_write( &self, range: BufferRange, wait: WaitList<'_> ) -> Result<(*mut c_void, RawEvent)>

pub unsafe fn read_to_ptr_in( &self, range: BufferRange, dst: *mut c_void, queue: &RawCommandQueue, wait: WaitList<'_> ) -> Result<RawEvent>

Reads the contents of this

pub unsafe fn read_rect_to_ptr_in( &self, buffer_origin: [usize; 3], host_origin: [usize; 3], region: [usize; 3], buffer_row_pitch: Option<usize>, buffer_slice_pitch: Option<usize>, host_row_pitch: Option<usize>, host_slice_pitch: Option<usize>, dst: *mut c_void, queue: &RawCommandQueue, wait: WaitList<'_> ) -> Result<RawEvent>

Available on crate feature cl1_1 only.

pub unsafe fn write_from_ptr_in( &mut self, range: BufferRange, src: *const c_void, queue: &RawCommandQueue, wait: WaitList<'_> ) -> Result<RawEvent>

pub unsafe fn write_rect_from_ptr_in( &mut self, buffer_origin: [usize; 3], host_origin: [usize; 3], region: [usize; 3], buffer_row_pitch: Option<usize>, buffer_slice_pitch: Option<usize>, host_row_pitch: Option<usize>, host_slice_pitch: Option<usize>, src: *const c_void, queue: &RawCommandQueue, wait: WaitList<'_> ) -> Result<RawEvent>

Available on crate feature cl1_1 only.

pub unsafe fn copy_from_in( &mut self, dst_offset: usize, src: &RawBuffer, src_offset: usize, size: usize, queue: &RawCommandQueue, wait: WaitList<'_> ) -> Result<RawEvent>

pub unsafe fn copy_from_rect_raw_in( &mut self, dst_origin: [usize; 3], src_origin: [usize; 3], region: [usize; 3], dst_row_pitch: Option<usize>, dst_slice_pitch: Option<usize>, src_row_pitch: Option<usize>, src_slice_pitch: Option<usize>, src: &RawBuffer, queue: &RawCommandQueue, wait: WaitList<'_> ) -> Result<RawEvent>

Available on crate feature cl1_1 only.

pub unsafe fn fill_raw_in<T>( &mut self, v: T, range: BufferRange, queue: &RawCommandQueue, wait: WaitList<'_> ) -> Result<RawEvent>

Available on crate feature cl1_2 only.

pub unsafe fn map_read_in( &self, range: BufferRange, queue: &RawCommandQueue, wait: WaitList<'_> ) -> Result<(*const c_void, RawEvent)>

pub unsafe fn map_write_in( &self, range: BufferRange, queue: &RawCommandQueue, wait: WaitList<'_> ) -> Result<(*mut c_void, RawEvent)>

pub unsafe fn map_read_write_in( &self, range: BufferRange, queue: &RawCommandQueue, wait: WaitList<'_> ) -> Result<(*mut c_void, RawEvent)>

Methods from Deref<Target = RawMemObject>

pub unsafe fn retain(&self) -> Result<()>

pub fn id(&self) -> cl_mem

pub fn id_ref(&self) -> &cl_mem

pub fn id_ref_mut(&mut self) -> &mut cl_mem

pub fn ty(&self) -> Result<MemObjectType>

Returns the memory obejct’s type

pub fn associated_memobject(&self) -> Result<Option<RawMemObject>>

Available on crate feature cl1_1 only.

Return memory object from which memobj is created.

pub fn flags(&self) -> Result<MemFlags>

Return the flags argument value specified when memobj is created.

pub fn size(&self) -> Result<usize>

Return actual size of the data store associated with memobj in bytes.

pub fn host_ptr(&self) -> Result<Option<NonNull<c_void>>>

If memobj is created with a host_ptr specified, return the host_ptr argument value specified when memobj is created.

pub fn map_count(&self) -> Result<u32>

Map count. The map count returned should be considered immediately stale. It is unsuitable for general use in applications. This feature is provided for debugging.

pub fn reference_count(&self) -> Result<u32>

Return memobj reference count. The reference count returned should be considered immediately stale. It is unsuitable for general use in applications. This feature is provided for identifying memory leaks.

pub fn context(&self) -> Result<RawContext>

Return context specified when memory object is created.

pub fn offset(&self) -> Result<usize>

Available on crate feature cl1_1 only.

Return offset if memobj is a sub-buffer object created using create_sub_buffer. Returns 0 if memobj is not a subbuffer object.

pub fn uses_svm_pointer(&self) -> Result<bool>

Available on crate feature cl2 only.

Return true if memobj is a buffer object that was created with CL_MEM_USE_HOST_PTR or is a sub-buffer object of a buffer object that was created with CL_MEM_USE_HOST_PTR and the host_ptr specified when the buffer object was created is a SVM pointer; otherwise returns false.

pub fn on_destruct(&self, f: impl 'static + FnOnce() + Send) -> Result<()>

Available on crate feature cl1_1 only.

Adds a callback to be executed when the memory object is destructed by OpenCL.

pub fn on_destruct_boxed(&self, f: Box<dyn FnOnce() + Send>) -> Result<()>

Available on crate feature cl1_1 only.

pub unsafe fn on_destruct_raw( &self, f: unsafe extern "C" fn(memobj: cl_mem, user_data: *mut c_void), user_data: *mut c_void ) -> Result<()>

Available on crate feature cl1_1 only.

Trait Implementations

impl<T: Debug, C: Context> Debug for RectBuffer2D<T, C>

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

Formats the value using the given formatter.

impl<T, C: Context> Deref for RectBuffer2D<T, C>

type Target = Buffer<T, C>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<T, C: Context> DerefMut for RectBuffer2D<T, C>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<T: Copy + Sync, C: Context> KernelPointer<T> for RectBuffer2D<T, C>

unsafe fn set_arg( &self, kernel: &mut RawKernel, _wait: &mut Vec<RawEvent>, idx: u32 ) -> Result<()>

fn complete(&self, _event: &RawEvent) -> Result<()>

impl<T: PartialEq, C: Context> PartialEq<RectBuffer2D<T, C>> for RectBuffer2D<T, C>

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T: Eq, C: Context> Eq for RectBuffer2D<T, C>