Struct plotters_unstable::chart::ChartState

pub struct ChartState<CT: CoordTranslate> { /* fields omitted */ }

A chart context state - This is the data that is needed to reconstruct the chart context without actually drawing the chart. This is useful when we want to do realtime rendering and want to incrementally update the chart.

For each frame, instead of updating the entire backend, we are able to keep the keep the figure component like axis, labels untouched and make updates only in the plotting drawing area. This is very useful for incremental render.

  use plotters::prelude::*;
   let mut buffer = vec![0u8;1024*768*3];
   let area = BitMapBackend::with_buffer(&mut buffer[..], (1024, 768))
       .into_drawing_area()
       .split_evenly((1,2));
   let chart = ChartBuilder::on(&area[0])
       .caption("Incremental Example", ("sans-serif", 20))
       .set_all_label_area_size(30)
       .build_ranged(0..10, 0..10)
       .expect("Unable to build ChartContext");
   // Draw the first frame at this point
   area[0].present().expect("Present");
   let state = chart.into_chart_state();
   // Let's draw the second frame
   let chart = state.restore(&area[0]);
   chart.plotting_area().fill(&WHITE).unwrap(); // Clear the previously drawn graph
   // At this point, you are able to draw next frame

#[derive(Clone)]

Implementations

impl<CT: CoordTranslate> ChartState<CT>

pub fn restore<'a, DB: DrawingBackend>(
    self,
    area: &DrawingArea<DB, Shift>
) -> ChartContext<'a, DB, CT>

Restore the chart context on the given drawing area

• area: The given drawing area where we want to restore the chart context
• returns The newly created chart context

Trait Implementations

impl<'a, 'b, DB, CT, '_> From<&'_ ChartContext<'a, DB, CT>> for ChartState<CT> where
    DB: DrawingBackend,
    CT: CoordTranslate + Clone, 

fn from(chart: &ChartContext<'a, DB, CT>) -> ChartState<CT>

Performs the conversion.

impl<'a, DB: DrawingBackend, CT: CoordTranslate> From<ChartContext<'a, DB, CT>> for ChartState<CT>

fn from(chart: ChartContext<'a, DB, CT>) -> ChartState<CT>

Performs the conversion.