Struct ElementGeom 

#[non_exhaustive]
pub struct ElementGeom {
    pub ink: Option<(u8, u8, u8)>,
    pub paper: Option<(u8, u8, u8)>,
    pub accent: Option<(u8, u8, u8)>,
    pub family: Option<String>,
}

Geom “ink”/“paper”/“accent” palette (ggplot2 4.0’s element_geom, B2-7): recolours a geom’s built-in default colour without touching every geom’s own color/fill field or needing a mapped/explicit colour to be set first. None everywhere (the default) changes nothing — byte-identical output. Marked #[non_exhaustive] so a later field can be added without an ..Default::default() break.

A default Geom::apply_element_geom is a no-op; a geom that honours this overrides it, replacing only fields still at their own built-in default — called once per layer, before the brand Theme::primary colour is applied, and (like the brand colour) only for a layer that was not configured explicitly via geom_*_with(...): that is the actual guard against touching an explicit colour (an explicit_style gate in the build pipeline), not a comparison of the field’s value against the hard-coded default, which can’t otherwise tell an explicitly-set black apart from a black nobody touched.

Geoms covered (0.21.0): GeomPoint, GeomLine, GeomPath, GeomText, GeomLabel and GeomBoxplot (ink for a black/ (50, 50, 50) line, text or outline; paper for a white fill) and GeomSmooth (accent for its default blue line and ribbon fill) — plus the legend key swatch colour, which reads ink directly rather than going through this trait method. Every other geom (segment, curve, reference lines, errorbar/linerange/pointrange, step, rect/tile outlines, density/violin/area outlines, crossbar, …) does not yet honour ElementGeom and keeps its hard-coded colour regardless — tracked at sipemu/ggplot-rs#142.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

ink: Option<(u8, u8, u8)>

Replaces a geom’s built-in black / (50, 50, 50) line, text or outline colour (including the legend key colour).

paper: Option<(u8, u8, u8)>

Replaces a geom’s built-in white fill.

accent: Option<(u8, u8, u8)>

Replaces the smooth line’s built-in colour.

family: Option<String>

Font family — the middle tier of B2-6’s resolution order (a geom’s own fontfamily, then this, then theme.text.family).

Implementations

impl ElementGeom

pub fn with_ink(self, color: (u8, u8, u8)) -> Self

Builder for ink — #[non_exhaustive] blocks a cross-crate struct literal even with ..Default::default(), so each field gets one of these.

pub fn with_paper(self, color: (u8, u8, u8)) -> Self

Builder for paper.

pub fn with_accent(self, color: (u8, u8, u8)) -> Self

Builder for accent.

pub fn with_family(self, family: &str) -> Self

Builder for family.

Trait Implementations

impl Clone for ElementGeom

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ElementGeom

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

Formats the value using the given formatter.

impl Default for ElementGeom

fn default() -> Self

Returns the “default value” for a type.