Struct ImageDescriptor 

pub struct ImageDescriptor<'a> {
    pub format: PixelFormat,
    pub width: u16,
    pub height: u16,
    pub data: ImageData<'a>,
    pub stride: Option<u32>,
}

Description of an image’s dimensions, format, storage, and row stride.

Fields

format: PixelFormat

Pixel layout used by the image data.

width: u16

Width in pixels.

height: u16

Height in pixels.

data: ImageData<'a>

Pixel bytes or safe borrowed color pixels.

stride: Option<u32>

Bytes per row; None means tightly packed rows.

Implementations

impl<'a> ImageDescriptor<'a>

pub const fn new( format: PixelFormat, width: u16, height: u16, data: ImageData<'a>, stride: Option<u32>, ) -> Self

Create an image descriptor from explicit parts.

pub const fn borrowed( format: PixelFormat, width: u16, height: u16, data: &'a [u8], ) -> Self

Create a tightly packed descriptor over borrowed encoded pixel bytes.

pub fn owned( format: PixelFormat, width: u16, height: u16, data: Vec<u8>, ) -> Self

Create a tightly packed descriptor over owned encoded pixel bytes.

pub const fn from_color_slice( pixels: &'a [Color], width: u16, height: u16, ) -> Self

Create a zero-copy ARGB8888 descriptor over borrowed Color pixels.

The descriptor uses ImageData::BorrowedColors instead of exposing raw bytes because Color does not define a stable memory layout. The effective representation is still ARGB8888: consumers serialize each color through Color::to_argb8888 when byte output is needed.

pub const fn dimensions(&self) -> (u16, u16)

Return (width, height) in pixels.

pub const fn tightly_packed_stride(&self) -> u32

Return the bytes per row for tightly packed rows.

pub fn stride_bytes(&self) -> u32

Return the effective bytes per row.

pub fn is_tightly_packed(&self) -> bool

Return true when rows are tightly packed with no padding bytes.

Trait Implementations

impl<'a> Clone for ImageDescriptor<'a>

fn clone(&self) -> ImageDescriptor<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for ImageDescriptor<'a>

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

Formats the value using the given formatter.

impl<'a> Eq for ImageDescriptor<'a>

impl<'a> PartialEq for ImageDescriptor<'a>

fn eq(&self, other: &ImageDescriptor<'a>) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl<'a> StructuralPartialEq for ImageDescriptor<'a>