mirror of
https://github.com/yse/easy_profiler.git
synced 2024-12-26 16:11:02 +08:00
ba0f73bcf6
Set public target compile definition to BUILD_WITH_EASY_PROFILER. Install to system directory
164 lines
5.5 KiB
Markdown
164 lines
5.5 KiB
Markdown
# easy_profiler [](https://github.com/yse/easy_profiler/releases)
|
|
|
|
[](https://travis-ci.org/yse/easy_profiler)
|
|
|
|
[](https://www.apache.org/licenses/LICENSE-2.0)
|
|
[](http://www.gnu.org/licenses/gpl-3.0)
|
|
|
|
1. [About](#about)
|
|
2. [Usage](#usage)
|
|
- [Prepare build system](#prepare-build-system)
|
|
- [General build system](#general)
|
|
- [CMake](#build-with-cmake)
|
|
- [Add profiling blocks](#add-profiling-blocks)
|
|
- [Collect blocks](#collect-blocks)
|
|
3. [Build](#build)
|
|
- [Linux](#linux)
|
|
- [Windows](#windows)
|
|
|
|
# About
|
|
Lightweight cross-platform profiler library for c++
|
|
|
|
You can profile any function in you code. Furthermore this library provide measuring time of any block of code.
|
|
For example, information for 12 millions of blocks is using less than 300Mb of memory.
|
|
Working profiler slows your application execution for only 1-2%.
|
|
|
|
|
|
_Average overhead per block is about 15ns/block (tested on Intel Core i7-5930K 3.5GHz, Win7)_
|
|
|
|
Disabled profiler will not affect your application execution in any way. You can leave it in your Release build
|
|
and enable it at run-time at any moment during application launch to see what is happening at the moment.
|
|
|
|
Also the library can capture system's context switch events between threads. Context switch information includes
|
|
duration, target thread id, thread owner process id, thread owner process name.
|
|
|
|
You can see the results of measuring in simple GUI application which provides full statistics and renders beautiful time-line.
|
|
|
|
|
|
|
|
# Usage
|
|
|
|
## Prepare build system
|
|
|
|
### General
|
|
|
|
First of all you can specify path to include directory which contains `include/profiler` directory and define macro `BUILD_WITH_EASY_PROFILER`.
|
|
For linking with easy_profiler you can specify path to library.
|
|
|
|
### Build with cmake
|
|
|
|
If you are using `cmake` set `CMAKE_PREFIX_PATH` to `lib/cmake/easy_profiler` directory (from [release](https://github.com/yse/easy_profiler/releases) package) and use function `find_package(easy_profiler)` with `target_link_libraries(... easy_profiler)`. Example:
|
|
|
|
``` cmake
|
|
project(app_for_profiling)
|
|
|
|
set(SOURCES
|
|
main.cpp
|
|
)
|
|
|
|
#CMAKE_PREFIX_PATH should be set to <easy_profiler-release_dir>/lib/cmake/easy_profiler
|
|
find_package(easy_profiler REQUIRED)
|
|
|
|
add_executable(app_for_profiling ${SOURCES})
|
|
|
|
target_link_libraries(app_for_profiling easy_profiler)
|
|
```
|
|
|
|
## Add profiling blocks
|
|
|
|
Example of usage.
|
|
|
|
This code snippet will generate block with function name and Magenta color:
|
|
```cpp
|
|
#include <easy/profiler.h>
|
|
|
|
void frame() {
|
|
EASY_FUNCTION(profiler::colors::Magenta); // Magenta block with name "frame"
|
|
prepareRender();
|
|
calculatePhysics();
|
|
}
|
|
```
|
|
|
|
To profile any block you may do this as following.
|
|
You can specify these blocks also with Google material design colors or just set name of the block
|
|
(in this case it will have default color which is `Amber100`):
|
|
```cpp
|
|
#include <easy/profiler.h>
|
|
|
|
void foo() {
|
|
// some code
|
|
EASY_BLOCK("Calculating sum"); // Block with default color
|
|
int sum = 0;
|
|
for (int i = 0; i < 10; ++i) {
|
|
EASY_BLOCK("Addition", profiler::colors::Red); // Scoped red block (no EASY_END_BLOCK needed)
|
|
sum += i;
|
|
}
|
|
EASY_END_BLOCK; // This ends "Calculating sum" block
|
|
|
|
EASY_BLOCK("Calculating multiplication", profiler::colors::Blue500); // Blue block
|
|
int mul = 1;
|
|
for (int i = 1; i < 11; ++i)
|
|
mul *= i;
|
|
//EASY_END_BLOCK; // This is not needed because all blocks are ended on destructor when closing braces met
|
|
}
|
|
```
|
|
|
|
You can also use your own colors. easy_profiler is using standard 32-bit ARGB color format.
|
|
Example:
|
|
```cpp
|
|
#include <easy/profiler.h>
|
|
|
|
void bar() {
|
|
EASY_FUNCTION(0xfff080aa); // Function block with custom color
|
|
// some code
|
|
}
|
|
```
|
|
## Collect blocks
|
|
|
|
To collect blocks data you can either save them in file by `profiler::dumpBlocksToFile(const char*)`function or listen capturing signal from profiler_gui application. In the latter case you may control captruing blocks in GUI-based application after calling function `profiler::startListen()`.
|
|
|
|
# Build
|
|
|
|
## Prerequisites
|
|
|
|
For core:
|
|
* compiler with c++11 support
|
|
* cmake 3.0 or higher
|
|
|
|
For GUI:
|
|
* Qt 5.3.0 or higher
|
|
|
|
## Linux
|
|
|
|
```bash
|
|
$ mkdir build
|
|
$ cd build
|
|
$ cmake ..
|
|
$ make
|
|
```
|
|
|
|
## Windows
|
|
|
|
If you are using QtCreator IDE you can just open `CMakeLists.txt` file in root directory.
|
|
If you are using Visual Studio you can generate solution by cmake generator command.
|
|
Examples shows how to generate Win64 solution for Visual Studio 2013. To generate for another version use proper cmake generator (-G "name of generator").
|
|
|
|
### Way 1
|
|
Specify path to cmake scripts in Qt5 dir (usually in lib/cmake subdir) and execute cmake generator command,
|
|
for example:
|
|
```batch
|
|
$ mkdir build
|
|
$ cd build
|
|
$ cmake -DCMAKE_PREFIX_PATH="C:\Qt\5.3\msvc2013_64\lib\cmake" .. -G "Visual Studio 12 2013 Win64"
|
|
```
|
|
|
|
### Way 2
|
|
Create system variable "Qt5Widgets_DIR" and set it's value to "[path-to-Qt5-binaries]\lib\cmake\Qt5Widgets".
|
|
For example, "C:\Qt\5.3\msvc2013_64\lib\cmake\Qt5Widgets".
|
|
And then run cmake generator as follows:
|
|
```batch
|
|
$ mkdir build
|
|
$ cd build
|
|
$ cmake .. -G "Visual Studio 12 2013 Win64"
|
|
```
|