Struct vulkano::buffer::BufferSlice

pub struct BufferSlice<T: ?Sized, B> { /* private fields */ }

A subpart of a buffer.

This object doesn’t correspond to any Vulkan object. It exists for API convenience.

Example

Creating a slice:

use vulkano::buffer::BufferSlice;
let _slice = BufferSlice::from(&buffer);

Selecting a slice of a buffer that contains [T]:

use vulkano::buffer::BufferSlice;
let _slice = BufferSlice::from(&buffer).slice(12 .. 14).unwrap();

Implementations

impl<T: ?Sized, B> BufferSlice<T, B>

pub fn from_typed_buffer_access(r: Arc<B>) -> Arc<BufferSlice<T, B>> where
    B: TypedBufferAccess<Content = T>, 

pub fn buffer(&self) -> &Arc<B>

Returns the buffer that this slice belongs to.

pub fn offset(&self) -> DeviceSize

Returns the offset of that slice within the buffer.

pub fn size(&self) -> DeviceSize

Returns the size of that slice in bytes.

pub unsafe fn slice_custom<F, R: ?Sized>(&self, f: F) -> Arc<BufferSlice<R, B>> where
    F: for<'r> FnOnce(&'r T) -> &'r R, 

Builds a slice that contains an element from inside the buffer.

This method builds an object that represents a slice of the buffer. No actual operation is performed.

Example

TODO

Safety

The object whose reference is passed to the closure is uninitialized. Therefore you must not access the content of the object.

You must return a reference to an element from the parameter. The closure must not panic.

pub unsafe fn reinterpret<R: ?Sized>(&self) -> Arc<BufferSlice<R, B>>

Changes the T generic parameter of the BufferSlice to the desired type. This can be useful when you have a buffer with various types of data and want to create a typed slice of a region that contains a single type of data.

Example

let blob_slice: Arc<BufferSlice<[u8], Arc<ImmutableBuffer<[u8]>>>> = return;
let vertex_slice: Arc<BufferSlice<[VertexImpl], Arc<ImmutableBuffer<[u8]>>>> = unsafe {
    blob_slice.reinterpret::<[VertexImpl]>()
};

Safety

Correct offset and size must be ensured before using this BufferSlice on the device. See BufferSlice::slice for adjusting these properties.

impl<T, B> BufferSlice<[T], B>

pub fn len(&self) -> DeviceSize

Returns the number of elements in this slice.

pub fn index(&self, index: DeviceSize) -> Option<Arc<BufferSlice<T, B>>>

Reduces the slice to just one element of the array.

Returns None if out of range.

pub fn slice(
    &self,
    range: Range<DeviceSize>
) -> Option<Arc<BufferSlice<[T], B>>>

Reduces the slice to just a range of the array.

Returns None if out of range.

Trait Implementations

impl<T, B> BufferAccess for BufferSlice<T, B> where
    B: BufferAccess,
    T: Send + Sync + ?Sized, 

fn inner(&self) -> BufferInner<'_>

Returns the inner information about this buffer.

fn size(&self) -> DeviceSize

Returns the size of the buffer in bytes.

fn conflict_key(&self) -> (u64, u64)

Returns a key that uniquely identifies the buffer. Two buffers or images that potentially overlap in memory must return the same key.

fn try_gpu_lock(
    &self,
    exclusive_access: bool,
    queue: &Queue
) -> Result<(), AccessError>

Locks the resource for usage on the GPU. Returns an error if the lock can’t be acquired.

unsafe fn increase_gpu_lock(&self)

Locks the resource for usage on the GPU. Supposes that the resource is already locked, and simply increases the lock by one.

unsafe fn unlock(&self)

Unlocks the resource previously acquired with try_gpu_lock or increase_gpu_lock.

fn into_buffer_slice(self: &Arc<Self>) -> Arc<BufferSlice<Self::Content, Self>> where
    Self: Sized + TypedBufferAccess, 

Returns a BufferSlice covering the whole buffer.

fn slice<T>(
    self: &Arc<Self>,
    range: Range<DeviceSize>
) -> Option<Arc<BufferSlice<[T], Self>>> where
    Self: Sized + TypedBufferAccess<Content = [T]>, 

Returns a BufferSlice for a subrange of elements in the buffer. Returns None if out of range.

fn index<T>(
    self: &Arc<Self>,
    index: DeviceSize
) -> Option<Arc<BufferSlice<T, Self>>> where
    Self: Sized + TypedBufferAccess<Content = [T]>, 

Returns a BufferSlice for a single element in the buffer. Returns None if out of range.

fn raw_device_address(&self) -> Result<NonZeroU64, BufferDeviceAddressError>

Gets the device address for this buffer.

impl<T: ?Sized, B> Clone for BufferSlice<T, B>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: ?Sized, B> DeviceOwned for BufferSlice<T, B> where
    B: DeviceOwned, 

fn device(&self) -> &Arc<Device>

Returns the device that owns Self.

impl<T, B> From<BufferSlice<T, B>> for BufferSlice<[T], B>

fn from(r: BufferSlice<T, B>) -> BufferSlice<[T], B>

Performs the conversion.

impl<T: ?Sized, B> Hash for BufferSlice<T, B> where
    T: Send + Sync,
    B: BufferAccess, 

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl<T: ?Sized, B> PartialEq<BufferSlice<T, B>> for BufferSlice<T, B> where
    T: Send + Sync,
    B: BufferAccess, 

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 !=.

impl<T, B> TypedBufferAccess for BufferSlice<T, B> where
    T: BufferContents + ?Sized,
    B: BufferAccess, 

type Content = T

The type of the content.

fn len(&self) -> DeviceSize

Returns the length of the buffer in number of elements.

impl<T: ?Sized, B> Eq for BufferSlice<T, B> where
    B: BufferAccess,
    T: Send + Sync,