Struct vulkano::buffer::cpu_access::CpuAccessibleBuffer

pub struct CpuAccessibleBuffer<T: ?Sized, A = Arc<StdMemoryPool>> where
    A: MemoryPool,  { /* fields omitted */ }

Buffer whose content is accessible by the CPU.

Methods

impl<T> CpuAccessibleBuffer<T>

fn new<'a, I>(
    device: Arc<Device>,
    usage: BufferUsage,
    queue_families: I
) -> Result<Arc<CpuAccessibleBuffer<T>>, OomError> where
    I: IntoIterator<Item = QueueFamily<'a>>, 

Deprecated

Deprecated. Use from_data instead.

fn from_data<'a, I>(
    device: Arc<Device>,
    usage: BufferUsage,
    queue_families: I,
    data: T
) -> Result<Arc<CpuAccessibleBuffer<T>>, OomError> where
    I: IntoIterator<Item = QueueFamily<'a>>,
    T: Content + 'static, 

Builds a new buffer with some data in it. Only allowed for sized data.

unsafe fn uninitialized<'a, I>(
    device: Arc<Device>,
    usage: BufferUsage,
    queue_families: I
) -> Result<Arc<CpuAccessibleBuffer<T>>, OomError> where
    I: IntoIterator<Item = QueueFamily<'a>>, 

Builds a new uninitialized buffer. Only allowed for sized data.

impl<T> CpuAccessibleBuffer<[T]>

fn from_iter<'a, I, Q>(
    device: Arc<Device>,
    usage: BufferUsage,
    queue_families: Q,
    data: I
) -> Result<Arc<CpuAccessibleBuffer<[T]>>, OomError> where
    I: ExactSizeIterator<Item = T>,
    T: Content + 'static,
    Q: IntoIterator<Item = QueueFamily<'a>>, 

Builds a new buffer that contains an array T. The initial data comes from an iterator that produces that list of Ts.

fn array<'a, I>(
    device: Arc<Device>,
    len: usize,
    usage: BufferUsage,
    queue_families: I
) -> Result<Arc<CpuAccessibleBuffer<[T]>>, OomError> where
    I: IntoIterator<Item = QueueFamily<'a>>, 

Deprecated

Deprecated. Use uninitialized_array or from_iter instead.

unsafe fn uninitialized_array<'a, I>(
    device: Arc<Device>,
    len: usize,
    usage: BufferUsage,
    queue_families: I
) -> Result<Arc<CpuAccessibleBuffer<[T]>>, OomError> where
    I: IntoIterator<Item = QueueFamily<'a>>, 

Builds a new buffer. Can be used for arrays.

impl<T: ?Sized> CpuAccessibleBuffer<T>

unsafe fn raw<'a, I>(
    device: Arc<Device>,
    size: usize,
    usage: BufferUsage,
    queue_families: I
) -> Result<Arc<CpuAccessibleBuffer<T>>, OomError> where
    I: IntoIterator<Item = QueueFamily<'a>>, 

Builds a new buffer without checking the size.

Safety

You must ensure that the size that you pass is correct for T.

impl<T: ?Sized, A> CpuAccessibleBuffer<T, A> where
    A: MemoryPool, 

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

Returns the device used to create this buffer.

fn queue_families(&self) -> Vec<QueueFamily>

Returns the queue families this buffer can be used on.

impl<T: ?Sized, A> CpuAccessibleBuffer<T, A> where
    T: Content + 'static,
    A: MemoryPool, 

fn read(&self) -> Result<ReadLock<T>, TryLockError<RwLockReadGuard<()>>>

Locks the buffer in order to write its content.

If the buffer is currently in use by the GPU, this function will block until either the buffer is available or the timeout is reached. A value of 0 for the timeout is valid and means that the function should never block.

After this function successfully locks the buffer, any attempt to submit a command buffer that uses it will block until you unlock it.

fn write(&self) -> Result<WriteLock<T>, TryLockError<RwLockWriteGuard<()>>>

Locks the buffer in order to write its content.

If the buffer is currently in use by the GPU, this function will block until either the buffer is available or the timeout is reached. A value of 0 for the timeout is valid and means that the function should never block.

After this function successfully locks the buffer, any attempt to submit a command buffer that uses it will block until you unlock it.

Trait Implementations

impl<T: Debug + ?Sized, A: Debug> Debug for CpuAccessibleBuffer<T, A> where
    A: MemoryPool,
    A::Alloc: Debug, 

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.

impl<T: ?Sized, A> BufferAccess for CpuAccessibleBuffer<T, A> where
    T: 'static + Send + Sync,
    A: MemoryPool, 

fn inner(&self) -> BufferInner

Returns the inner information about this buffer.

fn conflict_key(&self, self_offset: usize, self_size: usize) -> u64

Returns a key that uniquely identifies the range given by offset/size.

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

Locks the resource for usage on the GPU. Returns false if the lock was already 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.

fn size(&self) -> usize

Returns the size of the buffer in bytes.

fn len(&self) -> usize where
    Self: TypedBufferAccess,
    Self::Content: Content, 

Returns the length of the buffer in number of elements.

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

Builds a BufferSlice object holding the buffer by reference.

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

Builds a BufferSlice object holding part of the buffer by reference.

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

Builds a BufferSlice object holding the buffer by value.

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

Builds a BufferSlice object holding part of the buffer by reference.

fn conflicts_buffer(
    &self,
    self_offset: usize,
    self_size: usize,
    other: &BufferAccess,
    other_offset: usize,
    other_size: usize
) -> bool

Returns true if an access to self (as defined by self_offset and self_size) potentially overlaps the same memory as an access to other (as defined by other_offset and other_size).

fn conflicts_image(
    &self,
    self_offset: usize,
    self_size: usize,
    other: &ImageAccess,
    other_first_layer: u32,
    other_num_layers: u32,
    other_first_mipmap: u32,
    other_num_mipmaps: u32
) -> bool

Returns true if an access to self (as defined by self_offset and self_size) potentially overlaps the same memory as an access to other (as defined by other_first_layer, other_num_layers, other_first_mipmap and other_num_mipmaps).

fn conflicts_buffer_all(&self, other: &BufferAccess) -> bool

Shortcut for conflicts_buffer that compares the whole buffer to another.

fn conflicts_image_all(&self, other: &ImageAccess) -> bool

Shortcut for conflicts_image that compares the whole buffer to a whole image.

fn conflict_key_all(&self) -> u64

Shortcut for conflict_key that grabs the key of the whole buffer.

impl<T: ?Sized, A> TypedBufferAccess for CpuAccessibleBuffer<T, A> where
    T: 'static + Send + Sync,
    A: MemoryPool, 

type Content = T

The type of the content.

impl<T: ?Sized, A> DeviceOwned for CpuAccessibleBuffer<T, A> where
    A: MemoryPool, 

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

Returns the device that owns Self.