Struct GeomTextRepel 

pub struct GeomTextRepel {
    pub size: f64,
    pub color: (u8, u8, u8),
    pub alpha: f64,
    pub fontface: FontFace,
    pub repel: RepelParams,
}

Text labels repelled away from each other and from their points (ggrepel::geom_text_repel). Requires x, y, label; an empty / NA label is not drawn but its point is still avoided (as in ggrepel).

Fields

size: f64

color: (u8, u8, u8)

alpha: f64

fontface: FontFace

repel: RepelParams

Implementations

impl GeomTextRepel

pub fn box_padding(self, px: f64) -> Self

Padding (px) around label boxes when testing overlaps.

pub fn point_padding(self, px: f64) -> Self

Padding (px) around the labelled points.

pub fn point_size(self, px: f64) -> Self

Radius (px) of the points to avoid.

pub fn nudge(self, x: f64, y: f64) -> Self

Nudge the starting position (data units).

pub fn force(self, force: f64) -> Self

Repulsion strength.

pub fn force_pull(self, force: f64) -> Self

Spring strength back to the point.

pub fn max_iter(self, n: usize) -> Self

Maximum iterations.

pub fn max_time(self, t: Duration) -> Self

Wall-clock bound of the layout.

pub fn max_overlaps(self, n: usize) -> Self

Drop labels overlapping more than n labels/points.

pub fn min_segment_length(self, px: f64) -> Self

Minimum label–point distance (px) that gets a segment.

pub fn seed(self, seed: u64) -> Self

Seed of the deterministic tie-breaking jitter.

pub fn direction(self, d: RepelDirection) -> Self

Restrict movement to one axis.

pub fn max_labels(self, n: usize) -> Self

Label-count cap of the force layout.

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

Segment colour.

Trait Implementations

impl Default for GeomTextRepel

fn default() -> Self

Returns the “default value” for a type.

impl Geom for GeomTextRepel

fn draw( &self, data: &DataFrame, coord: &dyn Coord, scales: &ScaleSet, _theme: &Theme, backend: &mut dyn DrawBackend, ) -> Result<(), RenderError>

Draw this geometry.

fn required_aes(&self) -> Vec<Aesthetic>

Required aesthetics.

fn default_stat(&self) -> Box<dyn Stat>

Default stat for this geom.

fn default_position(&self) -> Box<dyn Position>

Default position adjustment.

fn default_params(&self) -> GeomParams

Non-mapped visual defaults.

fn name(&self) -> &str

Name for debug/display.

fn set_series_color(&mut self, _color: (u8, u8, u8))

Apply a brand/primary color to this geom’s single-series default (its color or fill). The build pipeline calls this only when the layer has no color/fill aesthetic mapped, so an explicit mapping always wins. The default is a no-op; series geoms override it.

fn include_zero_baseline(&self) -> bool

Whether this geom draws from a 0 baseline, so the Y scale should include 0 even when y is explicitly mapped (bars/columns/area/histograms — as in ggplot2). Default false.

fn allows_infinite(&self) -> bool

Whether -Inf/Inf position values are meaningful for this geom (ggplot2: “extend to the panel edge”). Rows with infinite positions are otherwise dropped with a warning before stats run. NaN is always dropped. Default false; geom_rect returns true.

fn setup_data(&self, _data: &mut DataFrame)

Geom-specific data preparation after the stat and position steps but before scale training (ggplot2’s GeomX$setup_data) — e.g. a tile adds its xmin/xmax/ymin/ymax extents so continuous scales train on them. Default: no-op.

fn inherit_aes(&self) -> bool

Whether the layer inherits the plot-level aesthetic mapping (ggplot2’s inherit.aes). Reference-line geoms return false, as in ggplot2, so a plot-level color/x/y mapping does not leak into a geom_hline. Default true.