This is an old revision of the document!
Every program that is built using Orx contains a profiler tool. The Profiler is compiled-in when using either debug or release modes.
The tool helps you diagnose bottlenecks and monitor performance and internal resources.
To show the profiler in your game or application, add the following to your config:
[]
Although it makes more practical sense to toggle it on and off with a key stroke:
Config []
Code []
Run your application again, and press the [] key to bring up your Profiler.
Profiler Layout
1) Thread Frame bar
This grey bar indicates which thread is currently selected. Most of Orx's subsystems run on the main thread. There are other systems like streaming audio which runs on another thread. Select your thread with the Page Up and Page Down keys.
The first value displayed is the amount of time in ms that it took to render the entire frame. The second value shows the largest amount of time that a frame took to render in the last second.
2) The meter bar panel These coloured meter bars indicate how much time each subsystem took to complete within the frame. The colours themselves correspond to the colours on the subsystem in the subsystem panels.
The bars are spread over four or more lines. The row of the bar corresponds to the level of the system. For example, the render task is on the top level, so sits in the top row. The orxSpawner_Update is three levels into the hierarchy and is therefore on the third row.
3) Subsystem panel This panel shows all the subsystems currently running in the frame. Each system contains three numbers. The first is the amount of time in ms that this system has taken to run in the current frame. The second number indicates the longest time this system took to run in the last second.
The last number shows how many times this subsystem was run in the last frame.
4) Secondary Subsystem panel The subsystems in this panel do not have colouring. The grey lines indicate xxxxx. The white lines indicate xxxx.
