Struct Canvas 

pub struct Canvas {
    pub axes: Axes,
    pub image: Image,
    /* private fields */
}

An image-backed plotting surface.

Canvas keeps the rendered image, the current axis configuration, and any series added to it. It is the lower-level incremental API for custom plotting workflows while Plot provides a simpler higher-level builder interface.

Fields

axes: Axes

The current axis configuration used to map data coordinates to pixels.

image: Image

The rasterized plot image.

Implementations

impl Canvas

pub fn new(width: usize, height: usize, axes: Axes) -> Self

Creates a new canvas with a given pixel size and axis configuration.

pub fn with_inset( width: usize, height: usize, axes: Axes, inset_x: usize, inset_y: usize, ) -> Self

Creates a new canvas with a custom inset margin around the drawing bounds.

pub fn width(&self) -> usize

Returns the canvas width in pixels.

pub fn height(&self) -> usize

Returns the canvas height in pixels.

pub fn insets(&self) -> (usize, usize)

Returns the horizontal and vertical inset values in pixels.

pub fn set_inset(&mut self, inset_x: usize, inset_y: usize)

Updates the inset margins used by the plot area.

pub fn set_render_scale(&mut self, scale: usize)

Sets the render scale used for higher-resolution output.

pub fn render(&mut self)

Draws the axes, labels, and ticks using the current axes configuration.

pub fn scatter(&mut self, points: &[(f64, f64)], size: usize)

Adds a scatter series with a default marker style and explicit marker size.

pub fn markers(&mut self, points: &[(f64, f64)], style: MarkerStyle)

Adds a marker-based series using a custom marker style.

pub fn plot(&mut self, points: &[(f64, f64)], line_width: usize)

Adds a line series with a default width.

pub fn line(&mut self, points: &[(f64, f64)], style: LineStyle)

Adds a line series using a custom style.

pub fn set_xlim(&mut self, xlim: (f64, f64))

Sets the x-axis limits and redraws the canvas.

pub fn set_ylim(&mut self, ylim: (f64, f64))

Sets the y-axis limits and redraws the canvas.

pub fn use_auto_xlim(&mut self)

Re-enables automatic x-axis scaling for data-driven limits.

pub fn use_auto_ylim(&mut self)

Re-enables automatic y-axis scaling for data-driven limits.

pub fn into_image(self) -> Image

Consumes the canvas and returns the rendered image.