dear-implot 0.17.0

High-level Rust bindings to ImPlot with dear-imgui-rs integration
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

use dear_imgui_rs::Context;
use dear_implot::{AxisFlags, PlotContext, PlotError, XAxis, YAxisConfig};
use std::sync::{Mutex, OnceLock};

fn test_guard() -> std::sync::MutexGuard<'static, ()> {
    static GUARD: OnceLock<Mutex<()>> = OnceLock::new();
    GUARD
        .get_or_init(|| Mutex::new(()))
        .lock()
        .unwrap_or_else(|err| err.into_inner())
}

fn prepare_imgui(imgui: &mut Context) {
    let io = imgui.io_mut();
    io.set_display_size([800.0, 600.0]);
    io.set_delta_time(1.0 / 60.0);
    imgui
        .font_atlas()
        .try_claim_legacy_renderer()
        .expect("headless test requires the legacy font-atlas capability")
        .build();
}

#[test]
fn axis_closure_is_plot_scoped_even_if_token_is_dropped() {
    let _guard = test_guard();
    let mut imgui = Context::create();
    prepare_imgui(&mut imgui);
    let plot_ctx = PlotContext::create(&imgui);

    {
        let frame = imgui.begin_frame();
        let plot_ui = plot_ctx.get_plot_ui(frame.ui());
        let plot = plot_ui.begin_plot("t").expect("failed to begin plot");

        let _ = plot_ui.setup_x_axis_format_closure(XAxis::X1, |_v| "x".to_string());
        let _ = plot_ui.setup_x_axis_transform_closure(XAxis::X1, |v| v, |v| v);
        plot_ui.plot_line("l", &[0.0, 1.0], &[0.0, 1.0]);

        drop(plot);
    }

    // Start a second plot to ensure plot-scoped storage was cleaned up properly.
    {
        let frame = imgui.begin_frame();
        let plot_ui = plot_ctx.get_plot_ui(frame.ui());
        let _plot = plot_ui.begin_plot("t2").expect("failed to begin plot");
    }
}

#[test]
fn multi_axis_plot_rejects_interior_nul_labels() {
    let _guard = test_guard();
    let mut imgui = Context::create();
    prepare_imgui(&mut imgui);
    let plot_ctx = PlotContext::create(&imgui);

    let frame = imgui.begin_frame();
    let plot_ui = plot_ctx.get_plot_ui(frame.ui());

    let plot = dear_implot::MultiAxisPlot::new("t").add_y_axis(YAxisConfig {
        label: Some("a\0b"),
        flags: AxisFlags::NONE,
        range: None,
    });

    match plot.begin(&plot_ui) {
        Ok(_) => panic!("expected interior NUL label to be rejected"),
        Err(err) => assert!(matches!(err, PlotError::StringConversion(_))),
    }
}