Struct EmptyElement

pub struct EmptyElement<Coord, DB>
where
    DB: DrawingBackend,
{ /* private fields */ }

An empty composable element. This is the starting point of a composed element.

Example

use plotters::prelude::*;
let data = [(1.0, 3.3), (2., 2.1), (3., 1.5), (4., 1.9), (5., 1.0)];
let drawing_area = SVGBackend::new("composable.svg", (300, 200)).into_drawing_area();
drawing_area.fill(&WHITE).unwrap();
let mut chart_builder = ChartBuilder::on(&drawing_area);
chart_builder.margin(7).set_left_and_bottom_label_area_size(20);
let mut chart_context = chart_builder.build_cartesian_2d(0.0..5.5, 0.0..5.5).unwrap();
chart_context.configure_mesh().draw().unwrap();
chart_context.draw_series(data.map(|(x, y)| {
    EmptyElement::at((x, y)) // Use the guest coordinate system with EmptyElement
    + Circle::new((0, 0), 10, BLUE) // Use backend coordinates with the rest
    + Cross::new((4, 4), 3, RED)
    + Pixel::new((4, -4), RED)
    + TriangleMarker::new((-4, -4), 4, RED)
})).unwrap();

The result is a data series where each point consists of a circle, a cross, a pixel, and a triangle:

Implementations

impl<Coord, DB> EmptyElement<Coord, DB>

where DB: DrawingBackend,

pub fn at(coord: Coord) -> EmptyElement<Coord, DB>

An empty composable element. This is the starting point of a composed element.

See EmptyElement for more information and examples.

Trait Implementations

impl<Coord, Other, DB> Add<Other> for EmptyElement<Coord, DB>

where DB: DrawingBackend, Other: Drawable<DB>, &'a Other: for<'a> PointCollection<'a, (i32, i32)>,

type Output = BoxedElement<Coord, DB, Other>

The resulting type after applying the + operator.

fn add(self, other: Other) -> <EmptyElement<Coord, DB> as Add<Other>>::Output

Performs the + operation.

impl<Coord, DB> Drawable<DB> for EmptyElement<Coord, DB>

where DB: DrawingBackend,

fn draw<I>( &self, _pos: I, _backend: &mut DB, _: (u32, u32), ) -> Result<(), DrawingErrorKind<<DB as DrawingBackend>::ErrorType>>

where I: Iterator<Item = (i32, i32)>,

Actually draws the element. The key points is already translated into the image coordinate and can be used by DC directly

impl<'a, Coord, DB> PointCollection<'a, Coord> for &'a EmptyElement<Coord, DB>

where DB: DrawingBackend,

type Point = &'a Coord

The item in point iterator

type IntoIter = Once<&'a Coord>

The point iterator

fn point_iter( self, ) -> <&'a EmptyElement<Coord, DB> as PointCollection<'a, Coord>>::IntoIter

framework to do the coordinate mapping