[−][src]Struct cart_tmp_wgpu::util::StagingBelt
Staging belt is a machine that uploads data.
Internally it uses a ring-buffer of staging buffers that are sub-allocated.
It has an advantage over Queue.write_buffer
in a way that it returns a mutable slice,
which you can fill to avoid an extra data copy.
Implementations
impl StagingBelt
[src]
pub fn new(chunk_size: BufferAddress, device: &Device) -> Self
[src]
Create a new staging belt.
The chunk_size
is the unit of internal buffer allocation.
It's better when it's big, but ideally still 1-4 times less than
the total amount of data uploaded per submission.
pub fn write_buffer(
&mut self,
target: &Buffer,
offset: BufferAddress,
size: BufferSize,
device: &Device
) -> BufferViewMut
[src]
&mut self,
target: &Buffer,
offset: BufferAddress,
size: BufferSize,
device: &Device
) -> BufferViewMut
Allocate the staging belt slice of size
to be uploaded into the target
buffer
at the specified offset.
The upload will only really be scheduled at the next StagingBelt::flush
call.
pub fn flush(&mut self, device: &Device) -> CommandBuffer
[src]
Produce a command buffer with all the accumulated transfers.
At this point, all the partially used staging buffers are closed until the GPU is done copying the data from them.
pub fn recall(&mut self) -> impl Future<Output = ()> + Send
[src]
Recall all of the closed buffers back for re-usal.
This has to be called after the command buffer produced by flush
is submitted!
Auto Trait Implementations
impl !RefUnwindSafe for StagingBelt
impl !Send for StagingBelt
impl !Sync for StagingBelt
impl Unpin for StagingBelt
impl !UnwindSafe for StagingBelt
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,