Struct TextElement 

pub struct TextElement {

    pub font: FontSpec,
    pub color: Option<ThemeColor>,
    pub size_pt: Option<Length>,
    pub align: Option<HAlign>,
    pub valign: Option<VAlign>,
    pub angle: Option<Rotation>,
    pub lineheight: Option<Length>,
    pub letter_spacing: Option<Length>,
    pub underline: Option<bool>,
    pub strikethrough: Option<bool>,
    pub margin: Option<Margin>,
    pub text_stroke: Option<ThemeColor>,
    pub text_linewidth_pt: Option<Length>,
    pub markdown: Option<bool>,
}

Text styling — font selection, colour, size, alignment, rotation, line height, margin.

Every field is Option<...> so an override can set just the fields it cares about, with the rest cascading through the parent chain. After cascading, callers fall through to text_concrete_defaults for any remaining Nones.

Fields

font: FontSpec

Font specification. Each FontSpec field cascades independently — a child can override weight while inheriting family.

color: Option<ThemeColor>

Ink colour. Resolved against the theme’s palette at draw time.

size_pt: Option<Length>

Font size. Resolves against the inherited parent’s resolved size — Rel(1.5) = 1.5× the parent.

align: Option<HAlign>

Horizontal alignment within the slot.

valign: Option<VAlign>

Vertical alignment within the slot.

angle: Option<Rotation>

Rotation — absolute degrees, or Along / Across to follow the surface’s baseline direction.

lineheight: Option<Length>

Line height — typically Rel(1.2) (120% of the resolved size).

letter_spacing: Option<Length>

Letter spacing (tracking). Length::Abs(pt) is absolute pt between glyph pairs; Length::Rel(m) is m × resolved_size_pt. Abs(0.0) (the default) is the natural font advance.

underline: Option<bool>

Underline the text. Position and thickness are taken from the font’s reported metrics.

strikethrough: Option<bool>

Strike through the text. Position and thickness are taken from the font’s reported metrics.

margin: Option<Margin>

Margin around the text block, each side independent.

text_stroke: Option<ThemeColor>

Per-glyph outline color. None renders no outline — the one field text_concrete_defaults leaves unset, since a concrete value here would halo every string in the figure. A child layer therefore cannot clear an outline a parent set by writing None; set text_linewidth_pt to Abs(0.0) instead.

Mirrors the "text_stroke" channel on the text geoms.

text_linewidth_pt: Option<Length>

Outline thickness. Resolves against DEFAULT_LINEWIDTH_PT, the parent every other linewidth in the theme resolves against, so Rel(2.0) is twice the standard hairline rather than a multiple of the font size. Has no effect unless text_stroke resolves to a color.

The stroke centres on the glyph contour and does not grow the text’s measured box, matching the text geoms — a deliberately heavy outline needs clearance from margin, which is measured.

markdown: Option<bool>

Interpret the slot’s string as marquee-flavoured markdown and shape it through the rich-text pipeline (crate::text::rich::RichTextRun). Off by default so every existing chrome label renders unchanged.

When on, the slot’s crate::plot::theme::Theme::rich_text style sheet drives the markdown styling; the TextElement’s resolved font / colour / size / letter-spacing feed into the rich run’s base style so plain-text fragments still inherit the slot’s ambient look.

Text-outline (text_stroke / text_linewidth_pt) is not applied on markdown slots — the rich pipeline doesn’t expose a glyph-outline surface. Chrome renderers fall back to plain text when an outline is needed on the same slot.

Implementations

impl TextElement

pub fn cascade(&self, parent: &Self) -> Self

Merge self over parent: per-field, self’s Some wins; None falls through to parent’s value. font cascades through FontSpec::cascade (each FontSpec field merges independently; feature / variation lists merge by tag).

Trait Implementations

impl Clone for TextElement

fn clone(&self) -> TextElement

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TextElement

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

Formats the value using the given formatter.

impl Default for TextElement

fn default() -> TextElement

Returns the “default value” for a type.

impl PartialEq for TextElement

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for TextElement