Struct plotters::chart::ChartState

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

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_cartesian_2d(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

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<CT: Clone + CoordTranslate> Clone for ChartState<CT>

fn clone(&self) -> ChartState<CT>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a, 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>

Converts to this type from the input type.

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

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

Converts to this type from the input type.