Struct vulkano::buffer::cpu_access::CpuAccessibleBuffer
source · [−]pub struct CpuAccessibleBuffer<T, A = PotentialDedicatedAllocation<StandardMemoryPoolAlloc>>where
T: BufferContents + ?Sized,{ /* private fields */ }
Expand description
Buffer whose content is accessible by the CPU.
Setting the host_cached
field on the various initializers to true
will make it so
the CpuAccessibleBuffer
prefers to allocate from host_cached memory. Host cached
memory caches GPU data on the CPU side. This can be more performant in cases where
the cpu needs to read data coming off the GPU.
Implementations
sourceimpl<T> CpuAccessibleBuffer<T>where
T: BufferContents,
impl<T> CpuAccessibleBuffer<T>where
T: BufferContents,
sourcepub fn from_data(
device: Arc<Device>,
usage: BufferUsage,
host_cached: bool,
data: T
) -> Result<Arc<CpuAccessibleBuffer<T>>, DeviceMemoryError>
pub fn from_data(
device: Arc<Device>,
usage: BufferUsage,
host_cached: bool,
data: T
) -> Result<Arc<CpuAccessibleBuffer<T>>, DeviceMemoryError>
Builds a new buffer with some data in it. Only allowed for sized data.
Panics
- Panics if
T
has zero size.
sourcepub unsafe fn uninitialized(
device: Arc<Device>,
usage: BufferUsage,
host_cached: bool
) -> Result<Arc<CpuAccessibleBuffer<T>>, DeviceMemoryError>
pub unsafe fn uninitialized(
device: Arc<Device>,
usage: BufferUsage,
host_cached: bool
) -> Result<Arc<CpuAccessibleBuffer<T>>, DeviceMemoryError>
sourceimpl<T> CpuAccessibleBuffer<[T]>where
[T]: BufferContents,
impl<T> CpuAccessibleBuffer<[T]>where
[T]: BufferContents,
sourcepub fn from_iter<I>(
device: Arc<Device>,
usage: BufferUsage,
host_cached: bool,
data: I
) -> Result<Arc<CpuAccessibleBuffer<[T]>>, DeviceMemoryError>where
I: IntoIterator<Item = T>,
I::IntoIter: ExactSizeIterator,
pub fn from_iter<I>(
device: Arc<Device>,
usage: BufferUsage,
host_cached: bool,
data: I
) -> Result<Arc<CpuAccessibleBuffer<[T]>>, DeviceMemoryError>where
I: IntoIterator<Item = T>,
I::IntoIter: ExactSizeIterator,
Builds a new buffer that contains an array T
. The initial data comes from an iterator
that produces that list of Ts.
Panics
- Panics if
T
has zero size. - Panics if
data
is empty.
sourcepub unsafe fn uninitialized_array(
device: Arc<Device>,
len: DeviceSize,
usage: BufferUsage,
host_cached: bool
) -> Result<Arc<CpuAccessibleBuffer<[T]>>, DeviceMemoryError>
pub unsafe fn uninitialized_array(
device: Arc<Device>,
len: DeviceSize,
usage: BufferUsage,
host_cached: bool
) -> Result<Arc<CpuAccessibleBuffer<[T]>>, DeviceMemoryError>
Builds a new buffer. Can be used for arrays.
Panics
- Panics if
T
has zero size. - Panics if
len
is zero.
sourceimpl<T> CpuAccessibleBuffer<T>where
T: BufferContents + ?Sized,
impl<T> CpuAccessibleBuffer<T>where
T: BufferContents + ?Sized,
sourcepub unsafe fn raw(
device: Arc<Device>,
size: DeviceSize,
usage: BufferUsage,
host_cached: bool,
queue_family_indices: impl IntoIterator<Item = u32>
) -> Result<Arc<CpuAccessibleBuffer<T>>, DeviceMemoryError>
pub unsafe fn raw(
device: Arc<Device>,
size: DeviceSize,
usage: BufferUsage,
host_cached: bool,
queue_family_indices: impl IntoIterator<Item = u32>
) -> Result<Arc<CpuAccessibleBuffer<T>>, DeviceMemoryError>
sourceimpl<T, A> CpuAccessibleBuffer<T, A>where
T: BufferContents + ?Sized,
impl<T, A> CpuAccessibleBuffer<T, A>where
T: BufferContents + ?Sized,
sourcepub fn queue_family_indices(&self) -> &[u32]
pub fn queue_family_indices(&self) -> &[u32]
Returns the queue families this buffer can be used on.
sourceimpl<T, A> CpuAccessibleBuffer<T, A>where
T: BufferContents + ?Sized,
A: MemoryPoolAlloc,
impl<T, A> CpuAccessibleBuffer<T, A>where
T: BufferContents + ?Sized,
A: MemoryPoolAlloc,
sourcepub fn read(&self) -> Result<ReadLock<'_, T, A>, ReadLockError>
pub fn read(&self) -> Result<ReadLock<'_, T, A>, ReadLockError>
Locks the buffer in order to read its content from the CPU.
If the buffer is currently used in exclusive mode by the GPU, this function will return
an error. Similarly if you called write()
on the buffer and haven’t dropped the lock,
this function will return an error as well.
After this function successfully locks the buffer, any attempt to submit a command buffer that uses it in exclusive mode will fail. You can still submit this buffer for non-exclusive accesses (ie. reads).
sourcepub fn write(&self) -> Result<WriteLock<'_, T, A>, WriteLockError>
pub fn write(&self) -> Result<WriteLock<'_, T, A>, WriteLockError>
Locks the buffer in order to write its content from the CPU.
If the buffer is currently in use by the GPU, this function will return an error. Similarly
if you called read()
on the buffer and haven’t dropped the lock, this function will
return an error as well.
After this function successfully locks the buffer, any attempt to submit a command buffer
that uses it and any attempt to call read()
will return an error.
Trait Implementations
sourceimpl<T, A> BufferAccess for CpuAccessibleBuffer<T, A>where
T: BufferContents + ?Sized,
A: Send + Sync,
impl<T, A> BufferAccess for CpuAccessibleBuffer<T, A>where
T: BufferContents + ?Sized,
A: Send + Sync,
sourcefn inner(&self) -> BufferInner<'_>
fn inner(&self) -> BufferInner<'_>
sourcefn size(&self) -> DeviceSize
fn size(&self) -> DeviceSize
sourcefn usage(&self) -> &BufferUsage
fn usage(&self) -> &BufferUsage
sourcefn into_buffer_slice(self: &Arc<Self>) -> Arc<BufferSlice<Self::Content, Self>>where
Self: Sized + TypedBufferAccess,
fn into_buffer_slice(self: &Arc<Self>) -> Arc<BufferSlice<Self::Content, Self>>where
Self: Sized + TypedBufferAccess,
BufferSlice
covering the whole buffer.sourcefn slice<T>(
self: &Arc<Self>,
range: Range<DeviceSize>
) -> Option<Arc<BufferSlice<[T], Self>>>where
Self: Sized + TypedBufferAccess<Content = [T]>,
fn slice<T>(
self: &Arc<Self>,
range: Range<DeviceSize>
) -> Option<Arc<BufferSlice<[T], Self>>>where
Self: Sized + TypedBufferAccess<Content = [T]>,
BufferSlice
for a subrange of elements in the buffer. Returns None
if
out of range. Read more