Struct DrawingArea

pub struct DrawingArea<DB: DrawingBackend, CT: CoordTranslate> { /* private fields */ }

The abstraction of a drawing area. Plotters uses drawing area as the fundamental abstraction for the high level drawing API. The major functionality provided by the drawing area is

1. Layout specification - Split the parent drawing area into sub-drawing-areas
2. Coordinate Translation - Allows guest coordinate system attached and used for drawing.
3. Element based drawing - drawing area provides the environment the element can be drawn onto it.

Implementations

impl<DB: DrawingBackend, X: Ranged, Y: Ranged> DrawingArea<DB, Cartesian2d<X, Y>>

pub fn draw_mesh<DrawFunc, YH: KeyPointHint, XH: KeyPointHint>( &self, draw_func: DrawFunc, y_count_max: YH, x_count_max: XH, ) -> Result<(), DrawingAreaErrorKind<DB::ErrorType>>

where DrawFunc: FnMut(&mut DB, MeshLine<'_, X, Y>) -> Result<(), DrawingErrorKind<DB::ErrorType>>,

Draw the mesh on a area

pub fn get_x_range(&self) -> Range<X::ValueType>

Get the range of X of the guest coordinate for current drawing area

pub fn get_y_range(&self) -> Range<Y::ValueType>

Get the range of Y of the guest coordinate for current drawing area

pub fn get_x_axis_pixel_range(&self) -> Range<i32>

Get the range of X of the backend coordinate for current drawing area

pub fn get_y_axis_pixel_range(&self) -> Range<i32>

Get the range of Y of the backend coordinate for current drawing area

impl<DB: DrawingBackend, CT: CoordTranslate> DrawingArea<DB, CT>

pub fn get_base_pixel(&self) -> BackendCoord

Get the left upper conner of this area in the drawing backend

pub fn strip_coord_spec(&self) -> DrawingArea<DB, Shift>

Strip the applied coordinate specification and returns a shift-based drawing area

pub fn use_screen_coord(&self) -> DrawingArea<DB, Shift>

Strip the applied coordinate specification and returns a drawing area

pub fn dim_in_pixel(&self) -> (u32, u32)

Get the area dimension in pixel

pub fn relative_to_height(&self, p: f64) -> f64

Compute the relative size based on the drawing area’s height

pub fn relative_to_width(&self, p: f64) -> f64

Compute the relative size based on the drawing area’s width

pub fn get_pixel_range(&self) -> (Range<i32>, Range<i32>)

Get the pixel range of this area

pub fn fill<ColorType: Color>( &self, color: &ColorType, ) -> Result<(), DrawingAreaErrorKind<DB::ErrorType>>

Fill the entire drawing area with a color

pub fn draw_pixel<ColorType: Color>( &self, pos: CT::From, color: &ColorType, ) -> Result<(), DrawingAreaErrorKind<DB::ErrorType>>

Draw a single pixel

pub fn present(&self) -> Result<(), DrawingAreaErrorKind<DB::ErrorType>>

Present all the pending changes to the backend

pub fn draw<'a, E, B>( &self, element: &'a E, ) -> Result<(), DrawingAreaErrorKind<DB::ErrorType>>

where B: CoordMapper, &'a E: PointCollection<'a, CT::From, B>, E: Drawable<DB, B>,

Draw an high-level element

pub fn map_coordinate(&self, coord: &CT::From) -> BackendCoord

Map coordinate to the backend coordinate

pub fn estimate_text_size( &self, text: &str, style: &TextStyle<'_>, ) -> Result<(u32, u32), DrawingAreaErrorKind<DB::ErrorType>>

Estimate the dimension of the text if drawn on this drawing area. We can’t get this directly from the font, since the drawing backend may or may not follows the font configuration. In terminal, the font family will be dropped. So the size of the text is drawing area related.

• text: The text we want to estimate
• font: The font spec in which we want to draw the text
• return: The size of the text if drawn on this area

impl<DB: DrawingBackend> DrawingArea<DB, Shift>

pub fn shrink<A: SizeDesc, B: SizeDesc, C: SizeDesc, D: SizeDesc>( self, left_upper: (A, B), dimension: (C, D), ) -> DrawingArea<DB, Shift>

Shrink the region, note all the locations are in guest coordinate

pub fn apply_coord_spec<CT: CoordTranslate>( &self, coord_spec: CT, ) -> DrawingArea<DB, CT>

Apply a new coord transformation object and returns a new drawing area

pub fn margin<ST: SizeDesc, SB: SizeDesc, SL: SizeDesc, SR: SizeDesc>( &self, top: ST, bottom: SB, left: SL, right: SR, ) -> DrawingArea<DB, Shift>

Create a margin for the given drawing area and returns the new drawing area

pub fn split_vertically<S: SizeDesc>(&self, y: S) -> (Self, Self)

Split the drawing area vertically

pub fn split_horizontally<S: SizeDesc>(&self, x: S) -> (Self, Self)

Split the drawing area horizontally

pub fn split_evenly(&self, (row, col): (usize, usize)) -> Vec<Self>

Split the drawing area evenly

pub fn split_by_breakpoints<XSize: SizeDesc, YSize: SizeDesc, XS: AsRef<[XSize]>, YS: AsRef<[YSize]>>( &self, xs: XS, ys: YS, ) -> Vec<Self>

Split the drawing area into a grid with specified breakpoints on both X axis and Y axis

pub fn titled<'a, S: Into<TextStyle<'a>>>( &self, text: &str, style: S, ) -> Result<Self, DrawingAreaErrorKind<DB::ErrorType>>

Draw a title of the drawing area and return the remaining drawing area

pub fn draw_text( &self, text: &str, style: &TextStyle<'_>, pos: BackendCoord, ) -> Result<(), DrawingAreaErrorKind<DB::ErrorType>>

Draw text on the drawing area

impl<DB: DrawingBackend, CT: CoordTranslate> DrawingArea<DB, CT>

pub fn into_coord_spec(self) -> CT

Returns the coordinates by value

pub fn as_coord_spec(&self) -> &CT

Returns the coordinates by reference

pub fn as_coord_spec_mut(&mut self) -> &mut CT

Returns the coordinates by mutable reference

Trait Implementations

impl<DB: DrawingBackend, CT: CoordTranslate + Clone> Clone for DrawingArea<DB, CT>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a, DB: DrawingBackend> From<&'a Rc<RefCell<DB>>> for DrawingArea<DB, Shift>

fn from(backend: &'a Rc<RefCell<DB>>) -> Self

Converts to this type from the input type.

impl<DB: DrawingBackend> From<DB> for DrawingArea<DB, Shift>

fn from(backend: DB) -> Self

Converts to this type from the input type.

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.