Scene Primitives#

#ScenePrimitive

Every frame is a flat list of ScenePrimitive values. There are five variants:

#[non_exhaustive]
pub enum ScenePrimitive {
    Rect(RectPrimitive),
    Text(TextPrimitive),
    Line(LinePrimitive),
    Polygon(PolygonPrimitive),
    Image(ImagePrimitive),
}

Custom renderers must include a wildcard arm (_ => {}) when matching ScenePrimitive, since the enum is #[non_exhaustive].

#RectPrimitive

Filled rectangle with optional stroke and rounded corners.

Used for: cell backgrounds, headers, selection rectangles, scrollbar elements.

#TextPrimitive

Clipped text run with alignment.

Used for: cell values, headers, row numbers, search highlights.

#LinePrimitive

Straight line segment.

Used for: grid lines, header borders, separator lines.

#PolygonPrimitive

Filled convex polygon with optional rounded corners.

Used for: sort indicator arrows, scrollbar arrow buttons.

#ImagePrimitive

Image loaded from a URL.

Used for: CellFormat::Image and CellFormat::ImageText cells.

#Color

pub struct Color { pub r: u8, pub g: u8, pub b: u8, pub a: u8 }

Color::rgb(255, 255, 255)      // opaque white
Color::rgba(0, 0, 0, 128)      // 50% transparent black
color.to_css()                  // "rgba(255,255,255,1.0000)"