summaryrefslogtreecommitdiffstats
path: root/third_party/rust/tracy-rs/README.md
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-21 11:44:51 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-21 11:44:51 +0000
commit9e3c08db40b8916968b9f30096c7be3f00ce9647 (patch)
treea68f146d7fa01f0134297619fbe7e33db084e0aa /third_party/rust/tracy-rs/README.md
parentInitial commit. (diff)
downloadthunderbird-9e3c08db40b8916968b9f30096c7be3f00ce9647.tar.xz
thunderbird-9e3c08db40b8916968b9f30096c7be3f00ce9647.zip
Adding upstream version 1:115.7.0.upstream/1%115.7.0upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'third_party/rust/tracy-rs/README.md')
-rw-r--r--third_party/rust/tracy-rs/README.md15
1 files changed, 15 insertions, 0 deletions
diff --git a/third_party/rust/tracy-rs/README.md b/third_party/rust/tracy-rs/README.md
new file mode 100644
index 0000000000..abdcb51f5f
--- /dev/null
+++ b/third_party/rust/tracy-rs/README.md
@@ -0,0 +1,15 @@
+# tracy-rs
+
+This provides a Rust integration for the Tracy profiling library (https://bitbucket.org/wolfpld/tracy).
+
+## Usage
+
+1) Clone the Tracy library from the above URL.
+2) Follow the steps to build the profiler GUI (e.g. in tracy/profiler/build/unix/).
+3) Follow the steps to build the profiler shared library (e.g. in tracy/library/unix).
+4) Add this crate to your project dependencies, with the 'enable_profiler' cargo feature.
+5) Call `tracy_rs::load` at the start of your application, providing path to library from (3).
+6) Insert the main frame marker `tracy_frame_marker!();` at the end of your frame.
+7) Optionally, add sub-frame markers with `tracy_begin_frame!()` and `tracy_end_frame!()`.
+8) Annotate functions to be profiled with `profile_scope!()`.
+9) Run the application and profiler GUI.