Struct IconData 

pub struct IconData { /* private fields */ }

A decoded window/app icon: tightly-packed, non-premultiplied RGBA8 rows, top-to-bottom — the one representation every desktop platform can be fed from (winit’s Icon::from_rgba, an NSImage bitmap rep, an HICON DIB).

Decoding a PNG/ICNS/ICO into this is the caller’s job: this crate carries no image decoder, and the tooling tier already owns the icon pipeline.

The rgba/width/height triple is an invariant, not three independent fields (rgba.len() == width * height * 4), so the fields are private and IconData::from_rgba is the only way in — an inconsistent icon reaches a platform API as a buffer overrun, not a wrong picture.

Debug is hand-written rather than derived (see the manual impl below): a derived one would dump the whole pixel buffer, drowning a log line in thousands of byte values for even a small icon.

Implementations

impl IconData

pub fn from_rgba(rgba: Vec<u8>, width: u32, height: u32) -> Option<Self>

Wrap decoded RGBA8 pixels, or None when they do not describe a width × height image: either dimension is zero or exceeds MAX_ICON_SIDE, or rgba.len() != width * height * 4.

Option rather than a <Type>Error enum because there is exactly one failure mode and nothing to match on — and this crate carries no thiserror dependency to add one with (version pins are law). The caller that decoded the image is the one holding the context worth reporting.

Check order matters. The dimension cap runs before the size arithmetic below it, so a hostile width/height is rejected on a cheap comparison rather than reaching the multiply (or, on a caller that already allocated rgba to match, whatever cost that allocation carried) at all.

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

The tightly-packed RGBA8 pixels (width * height * 4 bytes).

pub fn width(&self) -> u32

The image width in pixels (never zero, never above MAX_ICON_SIDE).

pub fn height(&self) -> u32

The image height in pixels (never zero, never above MAX_ICON_SIDE).

Trait Implementations

impl Clone for IconData

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 IconData

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

Prints rgba.len() rather than the buffer itself (see the type’s doc comment) — the pixel count is all a log line needs to say.

impl Eq for IconData

impl PartialEq for IconData

fn eq(&self, other: &Self) -> bool

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for IconData