Struct CpuTile 

#[non_exhaustive]
pub struct CpuTile { /* private fields */ }

Generic decoded pixel buffer.

Invariant: data length must equal width * height * channels in samples. Use CpuTile::new() to construct with validation, and use the read accessors for metadata and pixel storage.

Implementations

impl CpuTile

pub fn new( width: u32, height: u32, channels: u16, color_space: ColorSpace, layout: CpuTileLayout, data: CpuTileData, ) -> Result<Self, WsiError>

Construct a CpuTile, validating that the data length matches width * height * channels. Uses checked arithmetic to prevent overflow on large dimensions.

pub fn from_u8_interleaved( width: u32, height: u32, channels: u16, color_space: ColorSpace, pixels: Vec<u8>, ) -> Result<Self, WsiError>

Construct an interleaved U8 CPU tile.

pub fn width(&self) -> u32

pub fn height(&self) -> u32

pub fn channels(&self) -> u16

pub fn color_space(&self) -> &ColorSpace

pub fn layout(&self) -> CpuTileLayout

pub fn data(&self) -> &CpuTileData

pub fn stride_bytes(&self) -> usize

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

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

pub fn to_rgba(&self) -> Result<RgbaImage, WsiError>

Convert Uint8 data to RgbaImage. Returns error for non-Uint8 data.

pub fn into_rgba(self) -> Result<RgbaImage, WsiError>

Convert this buffer into an owned RgbaImage, reusing the underlying byte vector directly when the buffer is already RGBA8 interleaved.

pub fn to_rgba_windowed( &self, window: &DisplayWindow, ) -> Result<RgbaImage, WsiError>

Convert any sample type to RgbaImage with explicit windowing.

pub fn to_rgb(&self) -> Result<RgbImage, WsiError>

Convert Uint8 data to RgbImage. Direct path for RGB8 and Grayscale; other color spaces fall through RGBA conversion.

pub fn into_rgb(self) -> Result<RgbImage, WsiError>

Convert this buffer into an owned RgbImage, reusing the underlying byte vector directly when the buffer is already RGB8 interleaved.

pub fn to_rgb_windowed( &self, window: &DisplayWindow, ) -> Result<RgbImage, WsiError>

Convert any sample type to RgbImage with explicit windowing. Direct path avoids intermediate RGBA allocation.

Trait Implementations

impl Clone for CpuTile

fn clone(&self) -> CpuTile

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CpuTile

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

Formats the value using the given formatter.