Struct GpuiPlotView 

pub struct GpuiPlotView { /* 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 GpuiPlotView

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 44)

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: Color::new(0.2, 0.75, 0.95, 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 = GpuiPlotView::with_config(plot, config);
            cx.new(|_| view)
        })
        .unwrap();
    });
}

examples/advanced.rs (line 120)

fn build_views(
    cx: &mut gpui::App,
) -> (
    gpui::Entity<GpuiPlotView>,
    gpui::Entity<GpuiPlotView>,
    Series,
    Series,
) {
    let mut stream_a = Series::line("stream-A").with_kind(SeriesKind::Line(LineStyle {
        color: Color::new(0.2, 0.82, 0.95, 1.0),
        width: 2.0,
    }));
    let mut stream_b = Series::line("stream-B").with_kind(SeriesKind::Line(LineStyle {
        color: Color::new(0.95, 0.64, 0.28, 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: Color::new(0.95, 0.25, 0.55, 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: Color::new(0.45, 0.45, 0.5, 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(|_| {
        GpuiPlotView::with_config(top_plot, config.clone())
            .with_link_group(link_group.clone(), options)
    });
    let bottom = cx.new(|_| {
        GpuiPlotView::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 121)

fn build_views(
    cx: &mut gpui::App,
) -> (
    gpui::Entity<GpuiPlotView>,
    gpui::Entity<GpuiPlotView>,
    Series,
    Series,
) {
    let mut stream_a = Series::line("stream-A").with_kind(SeriesKind::Line(LineStyle {
        color: Color::new(0.2, 0.82, 0.95, 1.0),
        width: 2.0,
    }));
    let mut stream_b = Series::line("stream-B").with_kind(SeriesKind::Line(LineStyle {
        color: Color::new(0.95, 0.64, 0.28, 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: Color::new(0.95, 0.25, 0.55, 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: Color::new(0.45, 0.45, 0.5, 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(|_| {
        GpuiPlotView::with_config(top_plot, config.clone())
            .with_link_group(link_group.clone(), options)
    });
    let bottom = cx.new(|_| {
        GpuiPlotView::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 GpuiPlotView

fn clone(&self) -> GpuiPlotView

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Render for GpuiPlotView

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

Render this view into an element tree.