Struct Range 

pub struct Range {
    pub min: f64,
    pub max: f64,
}

Numeric range with inclusive bounds.

Range is used for axis limits, data bounds, and viewport calculations. The constructor automatically swaps bounds to maintain min <= max.

Fields

min: f64

Minimum value.

max: f64

Maximum value.

Implementations

impl Range

pub fn new(min: f64, max: f64) -> Self

Create a new range, swapping bounds if needed.

Examples found in repository

examples/advanced.rs (line 89)

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 span(&self) -> f64

Span of the range.

pub fn is_finite(&self) -> bool

Check whether both bounds are finite.

pub fn is_valid(&self) -> bool

Check whether the range has positive span and finite bounds.

pub fn expand_to_include(&mut self, value: f64)

Expand the range to include a value.

Non-finite values are ignored.

pub fn union(a: Self, b: Self) -> Option<Self>

Union two ranges if both are finite.

pub fn clamp(&self, value: f64) -> f64

Clamp a value into the range.

pub fn padded(&self, frac: f64, min_padding: f64) -> Self

Add padding around the range.

frac is applied to the current span and clamped by min_padding.

pub fn with_min_span(&self, min_span: f64) -> Self

Ensure the range has at least the given span.

Trait Implementations

impl Clone for Range

fn clone(&self) -> Range

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Range

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

Formats the value using the given formatter.

impl PartialEq for Range

fn eq(&self, other: &Range) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Range

impl StructuralPartialEq for Range