dear-implot3d 0.17.0

High-level Rust bindings to ImPlot3D 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

use std::marker::PhantomData;

use crate::{debug_end_plot, sys};
use dear_imgui_rs::{DrawListMut, Ui};

use super::binding::Plot3DContextBinding;

/// RAII token that ends the plot on drop
///
/// This token is returned by `Plot3DBuilder::build()` and automatically calls
/// `ImPlot3D_EndPlot()` when it goes out of scope, ensuring proper cleanup.
pub struct Plot3DToken<'ui> {
    pub(crate) binding: Plot3DContextBinding,
    pub(crate) ui: &'ui Ui,
    pub(crate) _lifetime: PhantomData<&'ui Ui>,
}

impl<'ui> Plot3DToken<'ui> {
    /// Get the active 3D plot draw list as a frame-bound wrapper.
    pub fn plot_draw_list(&self) -> Option<DrawListMut<'_>> {
        self.binding.with_bound_context(|| {
            let draw_list = unsafe { sys::ImPlot3D_GetPlotDrawList() };
            if draw_list.is_null() {
                None
            } else {
                Some(unsafe { DrawListMut::from_raw_mut(self.ui, draw_list) })
            }
        })
    }
}

impl Drop for Plot3DToken<'_> {
    fn drop(&mut self) {
        let _ = self.binding.try_with_bound_context(|| unsafe {
            debug_end_plot();
            sys::ImPlot3D_EndPlot();
        });
    }
}