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 download_into_profiled( &self, out: &mut [u8], stride: usize, ) -> Result<u128, Error>

Download the surface and return elapsed host copy time in microseconds.

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.

impl DeviceSurface for Surface

fn backend_kind(&self) -> BackendKind

Backend that owns or produced the surface.

fn residency(&self) -> SurfaceResidency

Memory residency of the surface.

fn dimensions(&self) -> (u32, u32)

Surface dimensions in pixels.

fn pixel_format(&self) -> PixelFormat

Pixel format stored by the surface.

fn byte_len(&self) -> usize

Number of bytes represented by the surface.

fn execution_stats(&self) -> ExecutionStats

Execution statistics attached to the surface.

fn memory_range(&self) -> Option<DeviceMemoryRange>

Backend-visible memory range, when the backend can expose one safely.