Struct plotters::chart::ChartState
source · [−]pub struct ChartState<CT: CoordTranslate> { /* private fields */ }Expand description
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 frameImplementations
sourceimpl<CT: CoordTranslate> ChartState<CT>
impl<CT: CoordTranslate> ChartState<CT>
sourcepub fn restore<'a, DB: DrawingBackend>(
self,
area: &DrawingArea<DB, Shift>
) -> ChartContext<'a, DB, 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
sourceimpl<CT: Clone + CoordTranslate> Clone for ChartState<CT>
impl<CT: Clone + CoordTranslate> Clone for ChartState<CT>
sourcefn clone(&self) -> ChartState<CT>
fn clone(&self) -> ChartState<CT>
Returns a copy of the value. Read more
1.0.0 · sourcefn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source. Read more
sourceimpl<'a, DB, CT> From<&ChartContext<'a, DB, CT>> for ChartState<CT> where
DB: DrawingBackend,
CT: CoordTranslate + Clone,
impl<'a, DB, CT> From<&ChartContext<'a, DB, CT>> for ChartState<CT> where
DB: DrawingBackend,
CT: CoordTranslate + Clone,
sourcefn from(chart: &ChartContext<'a, DB, CT>) -> ChartState<CT>
fn from(chart: &ChartContext<'a, DB, CT>) -> ChartState<CT>
Converts to this type from the input type.
sourceimpl<'a, DB: DrawingBackend, CT: CoordTranslate> From<ChartContext<'a, DB, CT>> for ChartState<CT>
impl<'a, DB: DrawingBackend, CT: CoordTranslate> From<ChartContext<'a, DB, CT>> for ChartState<CT>
sourcefn from(chart: ChartContext<'a, DB, CT>) -> ChartState<CT>
fn from(chart: ChartContext<'a, DB, CT>) -> ChartState<CT>
Converts to this type from the input type.
Auto Trait Implementations
impl<CT> RefUnwindSafe for ChartState<CT> where
CT: RefUnwindSafe,
impl<CT> Send for ChartState<CT> where
CT: Send,
impl<CT> Sync for ChartState<CT> where
CT: Sync,
impl<CT> Unpin for ChartState<CT> where
CT: Unpin,
impl<CT> UnwindSafe for ChartState<CT> where
CT: UnwindSafe,
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more