Struct DesktopIconData 

pub struct DesktopIconData { /* private fields */ }

The desktop app’s identity and native-integration vocabulary, re-exported from the desktop core so app code never names a shell crate: DesktopConfig (the whole declaration — app name, reverse-DNS id, window icon, menu bar, last-window-close policy — handed to App::desktop, run_desktop_config or app!’s desktop = { .. } argument), MenuSpec/MenuItemSpec/MenuRole (the platform-independent native menu tree a per-OS shell translates into an NSApp menu bar or an HMENU), DesktopIconData (decoded, tightly-packed RGBA8 — decoding a PNG/ICO/ICNS is the caller’s job), and DEFAULT_APP_NAME (the window title a config that names nothing still gets).

frust-shell-desktop‘s IconData is re-exported renamed: the facade already carries frust-widgets’ IconData, an in-UI vector icon, and the two are unrelated (one is a BezPath a widget paints, the other is the window/taskbar bitmap the OS shows). The Desktop prefix matches DesktopConfig, whose with_window_icon is its only consumer.

use frust::{DesktopConfig, MenuItemSpec, MenuRole, MenuSpec};

let file = MenuSpec::new()
    .with_item(MenuItemSpec::item("file.open", "Open…").with_accelerator("CmdOrCtrl+O"))
    .with_item(MenuItemSpec::separator())
    .with_item(MenuItemSpec::role(MenuRole::Quit));

let config = DesktopConfig::new()
    .with_app_name("Huddle")
    .with_app_id("dev.frust.huddle")
    .with_menu_spec(MenuSpec::new().with_item(MenuItemSpec::submenu("File", file)));

Desktop-only, unlike the menu_events read side: these types are defined in frust-shell-desktop, which is not in a mobile build’s or a wasm32 build’s dependency graph at all (see this crate’s Cargo.toml). Code shared with a mobile or wasm32 target keeps a DesktopConfig behind its own #[cfg(not(any(target_os = "android", target_os = "ios", target_arch = "wasm32")))] — or, more simply, writes it inline in app!’s desktop = { .. } argument, which the macro already emits only on the targets that have it. 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<IconData>

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) -> IconData

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<(), Error>

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: &IconData) -> bool

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for IconData