Struct Screenshot 

pub struct Screenshot { /* private fields */ }

A captured screenshot backed by raw RGBA8 pixel data.

Pixels are stored in row-major order; each pixel is four consecutive bytes [R, G, B, A] with values in 0..=255.

Implementations

impl Screenshot

pub fn from_rgba(width: u32, height: u32, data: Vec<u8>) -> Screenshot

Create a screenshot from raw RGBA8 pixel data.

Panics

Panics if data.len() != width * height * 4.

pub fn from_rgb(width: u32, height: u32, data: &[u8]) -> Screenshot

Create a screenshot from raw RGB8 pixel data, promoting to RGBA8 with full opacity (alpha = 255).

Panics

Panics if data.len() != width * height * 3.

pub fn width(&self) -> u32

Width of the screenshot in pixels.

pub fn height(&self) -> u32

Height of the screenshot in pixels.

pub fn data(&self) -> &[u8]

Raw RGBA8 pixel data (row-major, 4 bytes per pixel).

pub fn into_data(self) -> Vec<u8>

Consume the screenshot and return the underlying RGBA8 pixel buffer.

pub fn encode_png(&self) -> Result<Vec<u8>, EncodeError>

Encode the screenshot as a PNG image.

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

Encode the screenshot as a PPM (Portable Pixmap, P6 binary) image.

The alpha channel is discarded; only RGB values are written.

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

Encode the screenshot as a PGM (Portable Graymap, P5 binary) image.

Each pixel is converted to grayscale using the ITU-R BT.601 luminance coefficients: Y = 0.299·R + 0.587·G + 0.114·B.

pub fn encode(&self, format: ImageFormat) -> Result<Vec<u8>, EncodeError>

Encode the screenshot in the given ImageFormat.

pub fn save<P>(&self, path: P) -> Result<(), SaveError>

where P: AsRef<Path>,

Save the screenshot to path.

The image format is inferred from the file extension (.png, .ppm, .pgm). When the extension is absent or unrecognised, PNG is used.

pub fn save_as<P>(&self, path: P, format: ImageFormat) -> Result<(), SaveError>

where P: AsRef<Path>,

Save the screenshot to path in the explicitly chosen format.

Trait Implementations

impl Clone for Screenshot

fn clone(&self) -> Screenshot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Screenshot

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

Formats the value using the given formatter.