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<DeviceLocalBuffer<[u8]>>>> = return;
let vertex_slice: Arc<BufferSlice<[VertexImpl], Arc<DeviceLocalBuffer<[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 usage(&self) -> &BufferUsage

Returns the usage the buffer was created with.

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>

Converts to this type from the input type.

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 !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

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,