12 releases (breaking)

0.10.0 Feb 17, 2024
0.9.0 Jul 29, 2023
0.8.0 Apr 13, 2023
0.7.0 Feb 21, 2023
0.1.2 Jul 2, 2021

#28 in Visualization

Download history 134/week @ 2023-12-06 198/week @ 2023-12-13 165/week @ 2023-12-20 225/week @ 2023-12-27 211/week @ 2024-01-03 256/week @ 2024-01-10 321/week @ 2024-01-17 248/week @ 2024-01-24 186/week @ 2024-01-31 250/week @ 2024-02-07 446/week @ 2024-02-14 259/week @ 2024-02-21 228/week @ 2024-02-28 238/week @ 2024-03-06 218/week @ 2024-03-13 181/week @ 2024-03-20

895 downloads per month
Used in 3 crates

MIT license

195KB
894 lines

plotters-iced

Test and Build Documentation Crates.io License

This is an implementation of an Iced backend for Plotters, for both native and wasm applications.

This backend has been optimized as for speed. Note that some specific plotting features supported in the Bitmap backend may not be implemented there, though.

Showcase

CPU Monitor Example

WASM Example

What is Plotters?

Plotters is an extensible Rust drawing library that can be used to plot data on nice-looking graphs, rendering them through a plotting backend (eg. to a Bitmap image raw buffer, to your GUI backend, to an SVG file, etc.).

For more details on Plotters, please check the following links:

How to install?

Include plotters-iced in your Cargo.toml dependencies:

[dependencies]
plotters-iced = "0.10"
iced = { version = "0.12", features = ["canvas", "tokio"] }
plotters="0.3"

How to use?

First, import Chart and ChartWidget:

use plotters_iced::{Chart, ChartWidget, DrawingBackend, ChartBuilder};

Then, derive Chart trait and build your chart, and let plotters-iced takes care the rest:

struct MyChart;
impl Chart<Message> for MyChart {
    type State = ();
    fn build_chart<DB:DrawingBackend>(&self, state: &Self::State, builder: ChartBuilder<DB>) {
        //build your chart here, please refer to plotters for more details
    }
}

Finally, render your chart view:

impl MyChart {
    fn view(&mut self)->Element<Message> {
        ChartWidget::new(self)
            .width(Length::Fixed(200))
            .height(Length::Fixed(200))
            .into()
    }
}

If you are looking for a full example of an implementation, please check cpu-monitor.rs.

How to run the examples?

Example #1: cpu-monitor

This example samples your CPU load every second, and renders it in a real-time chart:

cargo run --release --example cpu-monitor

From this example, you'll learn:

  • how to build charts by plotters-iced
  • how to feed data to charts
  • how to make layouts of charts responsive
  • how to use fonts with charts

Example #2: split-chart

This example shows you how to split drawing area.

  • run the native version
cargo run --release --example split-chart
  • run the web version
cd examples/split-chart
trunk serve

Are there any limitations?

Limitation #1: No image rendering

No image rendering for native and wasm applications.

Limitation #2: Limited text rendering for native applications

Only TTF font family are supported for text rendering, which is a limitation of Iced, please look at cpu-monitor.rs. As well, font transforms are not supported,which is also a limitation of Iced.

Credits

Dependencies

~36–73MB
~1M SLoC