Struct Yuv420pReadback 

pub struct Yuv420pReadback { /* private fields */ }

A submitted GPU RGB-to-YUV420 conversion whose buffer is not mapped yet.

Implementations

impl Yuv420pReadback

pub const fn size(&self) -> RenderSize

The luma-plane dimensions.

pub const fn staging_bytes(&self) -> u64

Bytes held by the staging buffer.

pub fn wait_ready(&self) -> Result<(), RenderError>

Blocks a native caller until this readback is mapped.

Errors

Returns RenderError::TextureReadback when mapping or polling fails.

pub fn wait_for_submission(&self) -> Result<(), RenderError>

Blocks until this readback’s submission completes; may follow an earlier Self::map_async.

Errors

RenderError::GpuTimeout past the renderer’s wait timeout, or RenderError::TextureReadback when device polling fails.

pub fn wait(self) -> Result<Yuv420pPlanes, RenderError>

Waits for this readback and returns tightly packed planes.

Errors

RenderError::TextureReadback when mapping, polling or row packing fails.

pub fn map_async( &self, on_ready: impl FnOnce(Result<(), RenderError>) + Send + 'static, )

Requests buffer mapping and reports readiness exactly once.

pub fn poll(&self)

Polls backends that need it to resolve a mapping.

pub fn finish_into( self, targets: &mut Yuv420pTargets<'_>, ) -> Result<(), RenderError>

Packs mapped planes into caller-owned, possibly strided, plane buffers, avoiding the allocation and copy of Yuv420pReadback::finish.

Errors RenderError::TextureReadback when the buffer is not mapped, the layout is

unrepresentable or a target is too small, and RenderError::GpuWorkDropped when the GPU did not run the copy (the buffer is not recycled and the renderer refuses further work).

pub fn finish(self) -> Result<Yuv420pPlanes, RenderError>

Packs mapped planes into three tightly packed planes.

Errors

As Self::finish_into.

pub fn pixel_layout(&self) -> Option<PixelLayout>

The layout a texel readback packs into, None for a GPU-packed 8-bit 4:2:0 readback.

pub fn finish_into_planes( self, targets: &mut [PlaneTarget<'_>], ) -> Result<(), RenderError>

Packs the mapped frame into one target per plane of its layout, in storage order (PixelLayout::planes).

Errors

As Self::finish_into, and RenderError::TextureReadback for a wrong target count.

Trait Implementations

impl Debug for Yuv420pReadback

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.