mirror of
https://github.com/wolfpld/tracy.git
synced 2024-11-22 14:44:34 +00:00
Simplify README.
This commit is contained in:
parent
9034c9d9e6
commit
68bc82c11b
63
README.md
63
README.md
@ -2,72 +2,17 @@
|
||||
|
||||
[![Build status](https://ci.appveyor.com/api/projects/status/968a88arq06gm3el/branch/master?svg=true)](https://ci.appveyor.com/project/wolfpld/tracy/branch/master)
|
||||
|
||||
Tracy is a real time, nanosecond resolution frame profiler that can be used for remote or embedded telemetry of your application. It can profile CPU (C, C++11, Lua), GPU (OpenGL, Vulkan) and memory. It also can display locks held by threads and their interactions with each other.
|
||||
|
||||
![](doc/profiler.png)
|
||||
|
||||
The following compilers are supported:
|
||||
### A real time, nanosecond resolution, remote telemetry frame profiler for games and other applications.
|
||||
|
||||
- MSVC
|
||||
- gcc
|
||||
- clang
|
||||
Tracy supports profiling CPU (C, C++11, Lua), GPU (OpenGL, Vulkan), memory, locks, context switches, per-frame screenshots and more.
|
||||
|
||||
The following platforms are confirmed to be working (this is not a complete list):
|
||||
For usage instructions, consult the user manual [at the following address](https://bitbucket.org/wolfpld/tracy/downloads/tracy.pdf).
|
||||
|
||||
- Windows (x86, x64)
|
||||
- Linux (x86, x64, ARM, ARM64)
|
||||
- Android (ARM, x86)
|
||||
- FreeBSD (x64)
|
||||
- Cygwin (x64)
|
||||
- WSL (x64)
|
||||
- OSX (x64)
|
||||
[Changelog](NEWS)
|
||||
|
||||
[Introduction to Tracy Profiler v0.2](https://www.youtube.com/watch?v=fB5B46lbapc)
|
||||
[New features in Tracy Profiler v0.3](https://www.youtube.com/watch?v=3SXpDpDh2Uo)
|
||||
[New features in Tracy Profiler v0.4](https://www.youtube.com/watch?v=eAkgkaO8B9o)
|
||||
[New features in Tracy Profiler v0.5](https://www.youtube.com/watch?v=P6E7qLMmzTQ)
|
||||
|
||||
[List of changes.](NEWS)
|
||||
|
||||
### High-level overview
|
||||
|
||||
![](doc/design.svg)
|
||||
|
||||
Tracy is split into client and server side. The client side collects events using a high-efficiency queue and awaits for an incoming connection. The server part connects to client and receives collected data from the client, which is then reconstructed into a viewable timeline. The transfer is performed using a TCP connection.
|
||||
|
||||
### Performance impact
|
||||
|
||||
To check how much slowdown is introduced by using Tracy, I have profiled [etcpak](https://bitbucket.org/wolfpld/etcpak), which is the fastest ETC texture compression utility there is. I used an 8192×8192 test image as input data and instrumented everything down to the 4×4 pixel block compression function (that's 4 million blocks to compress). It should be noted that Tracy needs to calibrate its internal timers at each run. This introduces a delay of 115 ms (on my machine), which is negligible when doing lengthy profiling runs, but it skews the results of etcpak timing. The following times have this delay subtracted, to give focus on zone collection impact, which is the thing that really matters here.
|
||||
|
||||
| Scenario | Zones | Clean run | Profiling run | Difference |
|
||||
|-------------------------------------------------------|---------|-----------|---------------|------------|
|
||||
| Compression of an image to ETC1 format | 4194568 | 0.94 s | 1.003 s | +0.063 s |
|
||||
| Compression of an image to ETC2 format, with mip-maps | 5592822 | 1.034 s | 1.119 s | +0.085 s |
|
||||
|
||||
In both scenarios the per-zone time cost is at ~15 ns. This is in line with the measured 8 ns single event collection time (each zone has to report start and end event).
|
||||
|
||||
## Usage instructions
|
||||
|
||||
The user manual for Tracy is available [at the following address](https://bitbucket.org/wolfpld/tracy/downloads/tracy.pdf). It provides information about the integration process, required code markup and so on.
|
||||
|
||||
## Features
|
||||
|
||||
#### Histogram of function execution times
|
||||
|
||||
![](doc/histogram.png)
|
||||
|
||||
#### Comparison of two profiling runs
|
||||
|
||||
![](doc/compare.png)
|
||||
|
||||
#### Marking locks
|
||||
|
||||
![](doc/locks.png)
|
||||
|
||||
#### Plotting data
|
||||
|
||||
![](doc/plot.png)
|
||||
|
||||
#### Message log
|
||||
|
||||
![](doc/messages.png)
|
||||
|
BIN
doc/compare.png
BIN
doc/compare.png
Binary file not shown.
Before Width: | Height: | Size: 26 KiB |
Binary file not shown.
Before Width: | Height: | Size: 16 KiB |
BIN
doc/locks.png
BIN
doc/locks.png
Binary file not shown.
Before Width: | Height: | Size: 8.3 KiB |
BIN
doc/messages.png
BIN
doc/messages.png
Binary file not shown.
Before Width: | Height: | Size: 4.6 KiB |
BIN
doc/plot.png
BIN
doc/plot.png
Binary file not shown.
Before Width: | Height: | Size: 9.3 KiB |
Loading…
Reference in New Issue
Block a user