Struct Image 

pub struct Image {
    pub bytes: Arc<[u8]>,
    pub format: ImageFormat,
    pub width_px: u32,
    pub height_px: u32,
    pub components: u8,
    pub common: Common,
}

A validated, embeddable JPEG or PNG. bytes are the original file bytes, kept as-is — pixel decoding (only ever needed for PNG, to split out the alpha channel as a SMask) happens later, in the facade.

Fields

bytes: Arc<[u8]>

format: ImageFormat

width_px: u32

height_px: u32

components: u8

1 = Gray, 3 = RGB, 4 = RGBA (JPEG is always 1 or 3, never 4).

common: Common

Implementations

impl Image

pub fn new(bytes: impl Into<Arc<[u8]>>) -> Result<Self, ImageError>

Validates bytes as a supported JPEG or PNG and extracts the metadata layout needs (dimensions, color components). Rejects anything outside V1’s explicit scope instead of a silent best-effort attempt (phases/phase-5-images.md step 2-3).

pub fn width(self, width: f32) -> Self

pub fn height(self, height: f32) -> Self

pub fn flex(self, factor: f32) -> Self

pub fn keep_with_next(self) -> Self

Trait Implementations

impl Clone for Image

fn clone(&self) -> Image

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 From<Image> for Element

fn from(value: Image) -> Self

Converts to this type from the input type.