Struct Image 

pub struct Image { /* private fields */ }

Available on crate feature images only.

Immutable owned image bytes with a stable, process-unique reference.

Cloning preserves reference identity. References are opaque tokens, not security capabilities and not portable serialization identifiers.

Implementations

impl Image

pub fn from_bytes(data: impl Into<Arc<[u8]>>) -> Result<Self>

Inspect owned bytes without decoding or modifying pixels.

Errors

Returns InvalidImage for unsupported signatures, malformed inspected headers, animation, file/dimension/area limit violations, or exhausted reference identities. Successful inspection does not prove pixel decodability.

pub fn from_path(path: impl AsRef<Path>) -> Result<Self>

Read a caller-selected local path, with a bounded read and redacted errors.

Errors

Returns InvalidImage if the file cannot be opened/read or its bytes fail Image::from_bytes validation. Errors omit the supplied path.

pub fn from_base64(text: &str) -> Result<Self>

Decode standard padded base64, ignoring whitespace; data URLs are rejected.

Errors

Returns InvalidImage for a data-URL prefix, invalid base64, excessive encoded/decoded size, or any Image::from_bytes validation failure.

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

Original immutable bytes.

pub fn format(&self) -> ImageFormat

Encoding discovered from the file signature.

pub fn width(&self) -> u32

Width in pixels.

pub fn height(&self) -> u32

Height in pixels.

pub fn size(&self) -> usize

Original encoded byte length.

pub fn placeholder(&self) -> &str

Opaque reference to embed in state or question strings.

pub fn diagnostics(&self) -> &[ImageDiagnostic]

Metadata observations that have not been applied to the pixels.

pub fn base64(&self) -> String

Standard padded base64 of the original bytes.

Trait Implementations

impl Clone for Image

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 Image

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

Formats the value using the given formatter.

impl Display for Image

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

Formats the value using the given formatter.