Struct CpuImage 

pub struct CpuImage { /* private fields */ }

A picture the CPU renderer drew or was lent: premultiplied, sRGB-encoded RGBA, as every GPU intermediate texture holds it.

Only its content rectangle is stored; every pixel outside it is transparent. A label on a 1080p canvas keeps the label’s pixels, not the canvas’s.

Implementations

impl CpuImage

pub fn from_premultiplied_rgba8( size: RenderSize, rgba8: &[u8], ) -> Result<Self, RenderError>

Premultiplied, sRGB-encoded RGBA8 pixels, rows packed, as crate::Renderer::upload_rgba8 takes them: a picture sampled as that texture is.

Errors

Returns RenderError::InvalidImageData when rgba8 does not hold four bytes per pixel of size.

pub const fn size(&self) -> RenderSize

The picture’s dimensions.

pub fn retained_bytes(&self) -> u64

Bytes the picture holds.

pub fn read_rgba8(&self) -> Vec<u8>

The picture as tightly packed RGBA8, as crate::Renderer::read_rgba8 reads a texture back: each component rounded to the nearest code.

Trait Implementations

impl Clone for CpuImage

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CpuImage

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

Formats the value using the given formatter.