triglyceride 0.1.2

A simple realtime event loop profiler with egui ui
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
72
73
74
75
76
77
78
79
80

use std::sync::{RwLock, RwLockWriteGuard};

pub use lazy_static::lazy_static;

pub use function_profile::FunctionProfile;
pub use profiler::{PerformanceProfiler, Settings};
pub use tri_macros::time_event;

#[cfg(not(target_arch = "wasm32"))]
pub use ui::disconnected_display_window::spawn_disconnected_window;

pub(crate) mod function_profile;
pub(crate) mod profiler;
pub(crate) mod utils {
   pub(crate) mod tree;
   pub(crate) mod macros;
   pub(crate) mod ui_modules;
}
pub mod ui {
   pub mod user_interface;
   
   #[cfg(not(target_arch = "wasm32"))]
   pub(crate) mod disconnected_display_window;
}

pub type StatString = &'static str;


/// used to access a profiler static, takes a closure to a mut profiler 
/// ```
/// use triglyceride::{init_profiler, open_profiler, Settings};
/// 
/// init_profiler!(PROF, Settings::default());
/// 
/// fn main() {
/// 
///    // you can do anything with p such as manually starting and stopping timers
///    // mut this is the main use for it 
///    open_profiler(&PROF, |mut p| {
///       p.set_constant_reference("REFERENCE")
///    })
/// 
/// }
/// 
/// 
/// ```
#[inline(always)]
pub fn open_profiler<F>(profiler: &'static RwLock<PerformanceProfiler>, code: F)
where
    F: FnOnce(RwLockWriteGuard<'static, PerformanceProfiler>),
{
   code(profiler.write().unwrap());
}

/// used to modify a profilers settings though code instead of the ui
/// ```
/// use triglyceride::{init_profiler, open_profiler, Settings, change_profiler_settings};
///
/// init_profiler!(PROF, Settings::default());
///
/// fn main() {
///
///    change_profiler_settings(&PROF, |s: &mut Settings| {
///       s.active = false;
///       s.smoothing_amount = 1000;
///    });
///
/// }
///
///
/// ```
#[inline(always)]
pub fn change_profiler_settings<F>(profiler: &'static RwLock<PerformanceProfiler>, code: F)
where
    F: FnOnce(&mut Settings),
{
   open_profiler(profiler, |mut p| {
      code(&mut p.settings);
   });
}