Struct PlotView 

pub struct PlotView { /* private fields */ }

A GPUI view that renders a Plot with interactive controls.

This view handles pan/zoom/box-zoom, hover readouts, and pin interactions while delegating data management to the underlying Plot.

Implementations

impl PlotView

pub fn new(plot: Plot) -> Self

Create a new GPUI plot view for the given plot.

Uses the default PlotViewConfig.

pub fn with_config(plot: Plot, config: PlotViewConfig) -> Self

Create a new GPUI plot view with a custom configuration.

Examples found in repository

examples/basic.rs (line 49)

fn main() {
    Application::new().run(|cx| {
        let options = WindowOptions {
            window_bounds: Some(WindowBounds::Windowed(Bounds::centered(
                None,
                size(px(720.0), px(480.0)),
                cx,
            ))),
            ..Default::default()
        };

        cx.open_window(options, |_window, cx| {
            let series = Series::from_iter_y(
                "signal",
                (0..400).map(|i| {
                    let x = i as f64 * 0.03;
                    x.sin()
                }),
                SeriesKind::Line(LineStyle {
                    color: Rgba {
                        r: 0.2,
                        g: 0.75,
                        b: 0.95,
                        a: 1.0,
                    },
                    width: 2.0,
                }),
            );

            let mut plot = Plot::builder()
                .theme(Theme::dark())
                .x_axis(AxisConfig::builder().title("Sample").build())
                .y_axis(AxisConfig::builder().title("Amplitude").build())
                .build();
            plot.add_series(&series);

            let config = PlotViewConfig {
                show_legend: true,
                show_hover: true,
                ..Default::default()
            };

            let view = PlotView::with_config(plot, config);
            cx.new(|_| view)
        })
        .unwrap();
    });
}

examples/advanced.rs (line 140)

fn build_views(
    cx: &mut gpui::App,
) -> (
    gpui::Entity<PlotView>,
    gpui::Entity<PlotView>,
    Series,
    Series,
) {
    let mut stream_a = Series::line("stream-A").with_kind(SeriesKind::Line(LineStyle {
        color: Rgba {
            r: 0.2,
            g: 0.82,
            b: 0.95,
            a: 1.0,
        },
        width: 2.0,
    }));
    let mut stream_b = Series::line("stream-B").with_kind(SeriesKind::Line(LineStyle {
        color: Rgba {
            r: 0.95,
            g: 0.64,
            b: 0.28,
            a: 1.0,
        },
        width: 2.0,
    }));

    for i in 0..1_000 {
        let phase = i as f64 * 0.02;
        let _ = stream_a.push_y((phase * 0.9).sin() + 0.2 * (phase * 0.13).cos());
        let _ = stream_b.push_y((phase * 0.45).cos() * 1.15 + 0.15 * (phase * 0.09).sin());
    }

    let events = Series::from_iter_points(
        "events(scatter)",
        (0..200).map(|i| {
            let x = i as f64 * 80.0 + 40.0;
            let y = (x * 0.02).sin() * 0.9;
            gpui_liveplot::Point::new(x, y)
        }),
        SeriesKind::Scatter(MarkerStyle {
            color: Rgba {
                r: 0.95,
                g: 0.25,
                b: 0.55,
                a: 1.0,
            },
            size: 5.0,
            shape: MarkerShape::Circle,
        }),
    );

    let baseline = Series::from_explicit_callback(
        "baseline(callback)",
        |x| (x * 0.015).sin() * 0.4,
        Range::new(0.0, 25_000.0),
        5_000,
        SeriesKind::Line(LineStyle {
            color: Rgba {
                r: 0.45,
                g: 0.45,
                b: 0.5,
                a: 0.8,
            },
            width: 1.0,
        }),
    );

    let mut top_plot = Plot::builder()
        .theme(Theme::dark())
        .x_axis(AxisConfig::builder().title("Sample").build())
        .y_axis(AxisConfig::builder().title("Top: stream + events").build())
        .view(View::FollowLastN { points: 2_000 })
        .build();
    top_plot.add_series(&stream_a);
    top_plot.add_series(&events);

    let mut bottom_plot = Plot::builder()
        .theme(Theme::dark())
        .x_axis(AxisConfig::builder().title("Sample").build())
        .y_axis(
            AxisConfig::builder()
                .title("Bottom: stream + baseline")
                .build(),
        )
        .view(View::FollowLastNXY { points: 2_000 })
        .build();
    bottom_plot.add_series(&stream_b);
    bottom_plot.add_series(&baseline);

    let config = PlotViewConfig {
        show_legend: true,
        show_hover: true,
        ..Default::default()
    };

    let link_group = PlotLinkGroup::new();
    let options = PlotLinkOptions {
        link_x: true,
        link_y: false,
        link_cursor: true,
        link_brush: true,
        link_reset: true,
    };

    let top = cx.new(|_| {
        PlotView::with_config(top_plot, config.clone()).with_link_group(link_group.clone(), options)
    });
    let bottom =
        cx.new(|_| PlotView::with_config(bottom_plot, config).with_link_group(link_group, options));

    (top, bottom, stream_a, stream_b)
}

pub fn with_link_group( self, group: PlotLinkGroup, options: PlotLinkOptions, ) -> Self

Attach this view to a multi-plot link group.

Link groups synchronize viewport/cursor/brush state between views.

Examples found in repository

examples/advanced.rs (line 140)

fn build_views(
    cx: &mut gpui::App,
) -> (
    gpui::Entity<PlotView>,
    gpui::Entity<PlotView>,
    Series,
    Series,
) {
    let mut stream_a = Series::line("stream-A").with_kind(SeriesKind::Line(LineStyle {
        color: Rgba {
            r: 0.2,
            g: 0.82,
            b: 0.95,
            a: 1.0,
        },
        width: 2.0,
    }));
    let mut stream_b = Series::line("stream-B").with_kind(SeriesKind::Line(LineStyle {
        color: Rgba {
            r: 0.95,
            g: 0.64,
            b: 0.28,
            a: 1.0,
        },
        width: 2.0,
    }));

    for i in 0..1_000 {
        let phase = i as f64 * 0.02;
        let _ = stream_a.push_y((phase * 0.9).sin() + 0.2 * (phase * 0.13).cos());
        let _ = stream_b.push_y((phase * 0.45).cos() * 1.15 + 0.15 * (phase * 0.09).sin());
    }

    let events = Series::from_iter_points(
        "events(scatter)",
        (0..200).map(|i| {
            let x = i as f64 * 80.0 + 40.0;
            let y = (x * 0.02).sin() * 0.9;
            gpui_liveplot::Point::new(x, y)
        }),
        SeriesKind::Scatter(MarkerStyle {
            color: Rgba {
                r: 0.95,
                g: 0.25,
                b: 0.55,
                a: 1.0,
            },
            size: 5.0,
            shape: MarkerShape::Circle,
        }),
    );

    let baseline = Series::from_explicit_callback(
        "baseline(callback)",
        |x| (x * 0.015).sin() * 0.4,
        Range::new(0.0, 25_000.0),
        5_000,
        SeriesKind::Line(LineStyle {
            color: Rgba {
                r: 0.45,
                g: 0.45,
                b: 0.5,
                a: 0.8,
            },
            width: 1.0,
        }),
    );

    let mut top_plot = Plot::builder()
        .theme(Theme::dark())
        .x_axis(AxisConfig::builder().title("Sample").build())
        .y_axis(AxisConfig::builder().title("Top: stream + events").build())
        .view(View::FollowLastN { points: 2_000 })
        .build();
    top_plot.add_series(&stream_a);
    top_plot.add_series(&events);

    let mut bottom_plot = Plot::builder()
        .theme(Theme::dark())
        .x_axis(AxisConfig::builder().title("Sample").build())
        .y_axis(
            AxisConfig::builder()
                .title("Bottom: stream + baseline")
                .build(),
        )
        .view(View::FollowLastNXY { points: 2_000 })
        .build();
    bottom_plot.add_series(&stream_b);
    bottom_plot.add_series(&baseline);

    let config = PlotViewConfig {
        show_legend: true,
        show_hover: true,
        ..Default::default()
    };

    let link_group = PlotLinkGroup::new();
    let options = PlotLinkOptions {
        link_x: true,
        link_y: false,
        link_cursor: true,
        link_brush: true,
        link_reset: true,
    };

    let top = cx.new(|_| {
        PlotView::with_config(top_plot, config.clone()).with_link_group(link_group.clone(), options)
    });
    let bottom =
        cx.new(|_| PlotView::with_config(bottom_plot, config).with_link_group(link_group, options));

    (top, bottom, stream_a, stream_b)
}

pub fn plot_handle(&self) -> PlotHandle

Get a handle for mutating the underlying plot.

This is useful for streaming updates from async tasks.

Trait Implementations

impl Clone for PlotView

fn clone(&self) -> PlotView

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PlotView

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Render for PlotView

fn render( &mut self, _window: &mut Window, cx: &mut Context<'_, Self>, ) -> impl IntoElement

Render this view into an element tree.