Struct CursorImage 

pub struct CursorImage {
    pub width: i32,
    pub height: i32,
    pub hotspot: Point,
    pub mask: &'static [u8],
}

A cursor bitmap: three levels, drawn in two theme colours.

mask is one ASCII byte per pixel in row-major order, which keeps the shape readable in the source instead of being a wall of hex:

• . transparent
• # fill, painted in Role::BaseContent
• + outline, painted in Role::Base100

Both colours come from the theme, so the pointer inverts with it and stays visible on a light panel and a dark one without a second asset.

Fields

width: i32

Width in pixels.

height: i32

Height in pixels.

hotspot: Point

The pixel that sits on the pointer position.

mask: &'static [u8]

width * height ASCII bytes.

Implementations

impl CursorImage

pub const fn is_well_formed(&self) -> bool

Returns true if mask matches the declared geometry.

pub fn rasterise(&self, theme: &Theme, out: &mut [u32]) -> usize

Writes the sprite into out as 0xAARRGGBB words, for a hardware cursor plane.

Returns the number of words written, which is width * height. The two colours are the theme’s, exactly as the software composite uses them, so a panel that switches to the plane does not also change appearance — transparent pixels come out as a fully zero word rather than as black, because a cursor plane composites during scanout and an opaque pad would draw a rectangle around the pointer.

Re-run this when the theme changes: the sprite is resolved to concrete colours here, so the plane holds pixels rather than roles.

pub fn bounds_at(&self, at: Point) -> Rect

Bounds the sprite would occupy with its hotspot at at.

Trait Implementations

impl Clone for CursorImage

fn clone(&self) -> CursorImage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for CursorImage

impl Debug for CursorImage

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

Formats the value using the given formatter.