Struct PlottersAdapter 

pub struct PlottersAdapter<'a, DB: DrawingBackend> { /* private fields */ }

Adapter from plotters’ DrawingArea to our DrawBackend trait.

Implementations

impl<'a, DB: DrawingBackend> PlottersAdapter<'a, DB>

pub fn new(area: &'a DrawingArea<DB, Shift>, plot_area: Rect) -> Self

Trait Implementations

impl<'a, DB: DrawingBackend> DrawBackend for PlottersAdapter<'a, DB>

fn draw_polygon_rings( &mut self, rings: &[Vec<(f64, f64)>], style: &RectStyle, ) -> Result<(), RenderError>

Even-odd fill across every ring at once (geom_sf‘s polygon holes, #178) — plotters’ own Polygon element has no hole support, so the fill is a per-pixel scanline (as the canvas backend’s own fill_polygon_rings does), then each ring is stroked the same way (plotters’ PathElement, one closed path per ring).

fn draw_circle( &mut self, center: (f64, f64), radius: f64, style: &PointStyle, ) -> Result<(), RenderError>

fn draw_line( &mut self, points: &[(f64, f64)], style: &LineStyle, ) -> Result<(), RenderError>

fn draw_rect( &mut self, top_left: (f64, f64), bottom_right: (f64, f64), style: &RectStyle, ) -> Result<(), RenderError>

fn draw_text( &mut self, text: &str, pos: (f64, f64), style: &TextStyle, ) -> Result<(), RenderError>

fn draw_polygon( &mut self, points: &[(f64, f64)], style: &RectStyle, ) -> Result<(), RenderError>

fn draw_shape( &mut self, center: (f64, f64), radius: f64, style: &PointStyle, ) -> Result<(), RenderError>

Draw a point with a specific shape. Default delegates to draw_circle for Circle.

fn plot_area(&self) -> Rect

fn total_area(&self) -> Rect

fn draw_text_with_title( &mut self, text: &str, pos: (f64, f64), style: &TextStyle, _title: Option<&str>, ) -> Result<(), RenderError>

Like draw_text, but with an optional <title> tooltip carrying the full text when text itself has been shortened (e.g. a truncated-with-ellipsis legend label, #159). Default: ignores title and draws text plain — backends without native tooltip support (anything but SVG) have no better option. SVG overrides this to emit the <title> child, escaped the same way every other text run is.

fn set_tooltip(&mut self, _tooltip: Option<String>)

Attach a tooltip to subsequently-drawn marks until cleared with None. Backends that produce interactive output (SVG) emit it as a <title> for a native hover tooltip; others ignore it. Default: no-op.

fn set_mark_axis(&mut self, _key: Option<String>)

Attach an axis (x) key to subsequently-drawn marks — SVG emits it as a data-x attribute so a host can group marks by x (axis-pointer tooltip). Default: no-op.

fn set_mark_series(&mut self, _series: Option<String>)

Attach a series key (the colour / fill / group level) to subsequently drawn marks — SVG emits it as data-series, so a host can highlight or filter one series without parsing the tooltip. Default: no-op.

fn set_mark_value(&mut self, _value: Option<String>)

Attach the raw measured value (the unformatted y) to subsequently drawn marks — SVG emits it as data-value. Default: no-op.

fn set_mark_geom(&mut self, _geom: Option<&str>)

Tag subsequently drawn elements as data marks of the named geom (the layer’s Geom::name) until cleared with None. SVG emits class="gg-mark gg-<kind>" (kind from the primitive: point, line, band, bar, text) plus data-geom, so a host can select data marks without matching axes, grid lines or legends. Default: no-op.

fn warn(&mut self, _message: String)

Report a non-fatal problem found while drawing (e.g. labels a repel layout had to drop). Backends that collect warnings (the native SVG backend) append it to the render warnings. Default: ignored.

fn set_mark_part(&mut self, _part: Option<&str>)

Mark subsequently-drawn marks as belonging to a sub-part of a larger geom (e.g. "arrow" for an arrowhead drawn alongside a segment/curve/ path/line). While set, the SVG backend writes data-part="<part>" aria-hidden="true" and omits the <title> tooltip (the part is decorative; the parent mark already carries the semantic info). data-x/data-series/data-value (and any user data-* attrs) are still written. Default: no-op.

fn set_mark_attrs(&mut self, _attrs: Vec<(String, String)>)

Attach arbitrary data-* attributes to subsequently-drawn marks (B1-7’s Aes::data_attr). The SVG backend writes each, escaped; an attr with the same name as a built-in (data-x, data-series, data-value) replaces it rather than duplicating it. An empty Vec clears any previously set attrs. Default: no-op.

fn wants_formatted_values(&self) -> bool

Whether the caller asked for per-mark formatted values (crate::plot::GGPlot::svg_formatted_values, B2-4) — a query a geom checks before doing the (otherwise pointless) work of resolving a scale’s formatter for set_mark_fvalue/set_mark_fx. Default false, so the feature is byte-identical when never turned on.

fn set_mark_fvalue(&mut self, _value: Option<String>)

data-fvalue on subsequently-drawn marks: the “value” aesthetic’s raw data value (y for most geoms, fill for hex/tile), formatted through that aesthetic’s scale (Scale::format_value) — e.g. a de-DE currency string. Only meaningful while wants_formatted_values is true; None clears any previous mark’s value, per row. Default: no-op.

fn set_mark_fx(&mut self, _value: Option<String>)

data-fx on subsequently-drawn marks: the x value formatted through the x scale (e.g. a datetime axis’s ISO/locale date). The SVG backend omits it when it matches the already-written data-x, so a plain numeric x doesn’t get a redundant duplicate attribute. Default: no-op.

fn draw_quadratic( &mut self, p0: (f64, f64), ctrl: (f64, f64), p1: (f64, f64), style: &LineStyle, ) -> Result<(), RenderError>

Draw a quadratic Bézier curve from p0 to p1 with control point ctrl, in pixel space. The default implementation flattens the curve to 32 line segments and draws it with draw_line; backends that support real curves (SVG) should override this. Non-finite input draws nothing.