Skip to content

Performance Tools

PhoenixWhitefire edited this page Oct 19, 2025 · 3 revisions

Depending on whether you are on a Release build or not, you will have different Performance Tools available to you.

  • In every build configuration, the Info widget will list FPS, Frame time, Draw calls, and will provide a simple frame time and memory usage breakdown by category:
image
  • The "Start Profiling" button will appear exclusively in Debug and RelTracy builds, and relates to Tracy

Invariant Tools

These ones are in every build.

Summary stats

image

  • FPS and Frame time are relatively self-explanatory
  • "Draw calls" refer to individual requests sent to the GPU to render some geometry
  • Every single Draw Call has a fixed cost that can add up quickly, which the Engine tries to minimize by "Instancing" geometry that is similar into one single Draw Call. "Similar" geometry is geometry that shares the same Mesh, Material, Metallness and Roughness factors
  • Transparency is a special case, where translucent objects are in a separate Instancing group from opaque objects
  • Other visual properties, such as Color, Transform and Size can all be modified without reducing the effectiveness of Instancing. Non-visual properties do not affect Instancing

Timers

image
  • EntireFrame is equivalent to Frame Time in the prior Summary Stats

Each of the timers can be expanded to show a graph plotting the change in values over time:

image

Heap

image
  • Default refers to memory allocations that weren't assigned a category
  • Reflection will most likely always be 0 unless a memory leak has occurred within the Engine

Each of the categories can be expanded into a set of two graphs, showing the total in the category over time, as well as the change in the total over time:

image

Sampling

image

  • Allows you to collect the statistics per-frame over any period of time, and then save them to a CSV file

Tracy

image

Assuming you are using a Debug, RelTracy or other custom build which has Tracy integration enabled, you will see the button Start profiling appear in the Summary stats section.

Additionally, assuming you have compiled the Tracy profiler in the manner the README suggests, clicking this button will launch an instance of it. If the button simply disappears without launching anything, then the Tracy profiler application binary is not in the expected directory or does not have the expected file name.

image

Tracy may be launched at start-up by providing the command-line argument -tracyim.

Clone this wiki locally