Struct Surface 

pub struct Surface { /* private fields */ }

Host- or CUDA-backed decoded surface.

Implementations

impl Surface

pub fn residency(&self) -> SurfaceResidency

Return where the surface’s pixels currently reside.

pub fn pitch_bytes(&self) -> usize

Row pitch in bytes.

pub fn as_host_bytes(&self) -> Option<&[u8]>

Borrow host bytes when the surface is host-backed.

pub fn download_into(&self, out: &mut [u8], stride: usize) -> Result<(), Error>

Download or copy the surface into caller-owned strided output.

pub fn cuda_surface(&self) -> Option<CudaSurface<'_>>

Borrow CUDA metadata when the surface is CUDA-backed.

pub fn download_batch_tight(surfaces: &[Self]) -> Result<Vec<u8>, Error>

Download a sequence of surfaces into a tightly concatenated output buffer.

CUDA surfaces produced from one contiguous batch allocation are copied with one device-to-host transfer. Other layouts fall back to downloading each surface tightly in order.

pub fn download_batch_tight_into( surfaces: &[Self], out: &mut [u8], ) -> Result<(), Error>

Download a sequence of surfaces into a tightly concatenated output buffer.

CUDA surfaces produced from one contiguous batch allocation are copied with one device-to-host transfer. Other layouts fall back to downloading each surface tightly in order.

Trait Implementations

impl Debug for Surface

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

Formats the value using the given formatter.