Struct TrayIconImage 

#[repr(C)]
pub struct TrayIconImage {
    pub key: IconKey,
    pub width: u32,
    pub height: u32,
    pub rgba: U8Vec,
}

RGBA8 image for a tray icon, at one specific size.

Unlike crate::window::WindowIcon, which is fixed at 16x16 / 32x32, a tray icon needs arbitrary sizes: Windows wants GetSystemMetricsForDpi(SM_CXSMICON) (16 / 20 / 24 / 32 px as the taskbar’s DPI changes), macOS wants an 18x18 point template image (so 36x36 px on a 2x display), and SNI wants an array of whatever sizes we care to publish so the panel can pick.

rgba is straight, non-premultiplied RGBA8, width * height * 4 bytes, top row first. Every backend converts from this one representation: Windows builds a BGRA HBITMAP + mask, macOS an NSBitmapImageRep, and Linux byte-swaps to the ARGB32-big-endian that IconPixmap requires.

Fields

key: IconKey

Cache key - lets a backend skip re-uploading an unchanged icon.

width: u32

height: u32

rgba: U8Vec

Implementations

impl TrayIconImage

pub fn new(width: u32, height: u32, rgba: U8Vec) -> OptionTrayIconImage

rgba must be exactly width * height * 4 bytes; returns None otherwise.

Returns OptionTrayIconImage rather than Option<Self> so the signature crosses the C ABI unchanged.

pub fn to_argb32_be(&self) -> U8Vec

The icon’s pixels as ARGB32 in network (big-endian) byte order, the wire format org.kde.StatusNotifierItem’s IconPixmap (a(iiay)) requires. Nothing else uses this layout, so it is computed on demand.

Trait Implementations

impl Clone for TrayIconImage

fn clone(&self) -> TrayIconImage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TrayIconImage

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

Formats the value using the given formatter.

impl Eq for TrayIconImage

impl FromIterator<TrayIconImage> for TrayIconImageVec

fn from_iter<T>(iter: T) -> Self

where T: IntoIterator<Item = TrayIconImage>,

Creates a value from an iterator.

impl PartialEq for TrayIconImage

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

Equality operator ==.

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

Inequality operator !=.