Lumberyard
User Guide (Version 1.16)

User Interface

Statoscope data can be displayed as lines (such as for fps, number of drawcalls, memory usage, and threads), as bars (such as for function profiles or per-entity bandwidth statistics), as intervals (such as the status of queued streaming tasks), or as user markers, which are vertical lines displayed when infrequent actions occur (such as invalid file access or level load/unload).

You must select all nodes (and the parent node) down to the selected node in order to see data displayed for that item. When using the data group selection trees, right-click toggles selection of the entire sub-tree.

Here are the basic navigation methods for the Statoscope graph. The x-axis is displayed in both frame numbers and elapsed seconds while the y-axis is displayed in milliseconds.

  • To pan: left-click and drag

  • To zoom: right-click and drag

  • To scale horizontally: right-click hold and drag left/right

  • To scale vertically: right-click hold and drag up/down

  • To scale along both axes: right-click and drag top right and bottom left

Note

To reset the viewport, select View, Fit To Frame Records. This is useful if the data is off-screen from zooming in too much.

Function Profiling

As there are usually many more frames in a log than can easily be shown at once, only a subset of bars are displayed when zoomed out. This is indicated by the bars being displayed at 50% opacity.

The bars displayed are individual frames. The ones selected are the tallest of the range that they represent. This makes it easy to identify unusual spikes even when zoomed out.

Function profiling is enabled using the e_StatoscopeDataGroups r console variable.

Clicking on a bar selects that entry on the Function Profile tab, with focus moved to the tree view, so you can press the spacebar to unselect and hide that bar quickly. This is useful for eliminating profiling noise.

Hovering

When mouse hovering, a vertical red line clips to the nearest frame and a tooltip will follow your cursor over the window, displaying the following information for a selected frame:

  • Top line: frame number, game time, and y-axis value

  • Second line: What item you are hovering over

  • Third line: The time elapsed in ms

Axes Scaling

The x-axis is linear for number of frames by default. This is useful for function profiling since all bars have the same width. You can also select the x-axis to be linear for time instead.

The y-axis can be scaled in order to compare data that varies greatly in value, such as number of drawcalls.

You can also specify which target lines are displayed.