Struct EmptyElement

pub struct EmptyElement<Coord, 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: DrawingBackend> EmptyElement<Coord, DB>

pub fn at(coord: Coord) -> Self

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: DrawingBackend> Add<Other> for EmptyElement<Coord, DB>

where Other: Drawable<DB>, for<'a> &'a Other: PointCollection<'a, BackendCoord>,

type Output = BoxedElement<Coord, DB, Other>

The resulting type after applying the + operator.

fn add(self, other: Other) -> Self::Output

Performs the + operation.

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

fn draw<I: Iterator<Item = BackendCoord>>( &self, _pos: I, _backend: &mut DB, _: (u32, u32), ) -> Result<(), DrawingErrorKind<DB::ErrorType>>

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: DrawingBackend> PointCollection<'a, Coord> for &'a EmptyElement<Coord, DB>

type Point = &'a Coord

The item in point iterator

type IntoIter = Once<&'a Coord>

The point iterator

fn point_iter(self) -> Self::IntoIter

framework to do the coordinate mapping

Layout

Note: Unable to compute type layout, possibly due to this type having generic parameters. Layout can only be computed for concrete, fully-instantiated types.