vor 0.1.0

Cross-platform performance instrumentation with an in-app egui panel and live system and GPU metrics.
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
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90

//! Cross-platform performance instrumentation.
//!
//! Tag a function with `#[vor::profile]`, a whole `impl` with
//! `#[vor::all_functions]`, or open a scoped block with
//! [`profile_scope!`]. Each tag emits a `puffin` scope (frame-buffer
//! source for an in-app flame chart), a `tracing` span (sink source:
//! Chrome-trace file on `mac`, DevTools timeline on `web`), and —
//! under the `cuda` feature — an NVTX range for NVIDIA Nsight Systems.
//!
//! Frame boundaries: call [`frame_mark`] once per rendered frame so
//! puffin can group scopes by frame.

#[cfg(feature = "web")]
mod browser;
mod calibrate;
#[cfg(feature = "mac")]
mod chrome;
mod frame;
mod gpu;
mod io_acc;
mod macros;
mod mem;
mod sink;
#[cfg(feature = "viz")]
pub mod viz;

pub use vor_macros::{all_functions, profile, skip};

#[doc(hidden)]
pub use puffin as __priv_puffin;
#[doc(hidden)]
pub use tracing as __priv_tracing;

/// NVTX range guard the profiling macros open alongside their puffin
/// scope, so instrumented code also shows up on an NVIDIA Nsight
/// Systems timeline.
///
/// Real under the `cuda` feature; a zero-sized no-op otherwise, so
/// the macros can emit the call unconditionally.
#[cfg(feature = "cuda")]
#[doc(hidden)]
#[must_use = "bind the guard so the NVTX range stays open for the scope"]
pub struct __NvtxRange {
    _guard: nvtx::RangeGuard,
}

#[cfg(feature = "cuda")]
#[doc(hidden)]
pub fn __nvtx_range(name: &str) -> __NvtxRange {
    __NvtxRange {
        _guard: nvtx::range!("{name}"),
    }
}

#[cfg(not(feature = "cuda"))]
#[doc(hidden)]
pub struct __NvtxRange;

#[cfg(not(feature = "cuda"))]
#[doc(hidden)]
pub const fn __nvtx_range(_name: &str) -> __NvtxRange {
    __NvtxRange
}

#[cfg(feature = "web")]
pub use crate::browser::BrowserSink;
pub use crate::calibrate::{calibrate, empty_span_ns};
#[cfg(feature = "mac")]
pub use crate::chrome::ChromeTraceSink;
pub use crate::frame::FrameStats;
pub use crate::io_acc::{IoTick, drain as drain_io, record as record_io};
pub use crate::mem::current_memory_bytes;
pub use crate::sink::{Guard, Sink};

/// Turn on puffin scope collection process-wide.
///
/// Until enabled, every [`profile`] / [`profile_scope!`] expansion's
/// puffin half is a no-op; the tracing half is unaffected.
pub fn enable() {
    puffin::set_scopes_on(true);
}

/// Mark a frame boundary in puffin's ring buffer.
///
/// Required for the flame UI to slice scopes into frame-sized
/// columns. Pair with [`drain_io`] to harvest the same frame's I/O
/// totals.
pub fn frame_mark() {
    puffin::GlobalProfiler::lock().new_frame();
}