User Guide (Version 1.17)

Filtering Data

There are a number of data filtering options available in Statoscope.

Use the Overview and Function Profile tabs to access and then select and deselect data plots. For a plot to be drawn, it and all its parents in the tree must be selected.

There are several shortcuts for selecting items:

  • Ctrl+left-click label: select just that item

  • Right-click label: selects or deselects every item under the selected item in the hierarchy.

  • Shift+left-click label (Function Profile tab): collapses all children into a single bar color. This will cause the label to have a gray background. This is useful for seeing the performance cost of a whole thread or profile module.

Item Info tab

This tab is used to control how a data item is displayed and shows some basic data.

Line and bar data colors can be changed by clicking the color swatch button to get a color picker dialog, or by clicking the Rnd button to select a random color.

Basic statistics shown include the number of frames the data is present for in the log, and the corresponding minimum, maximum, and average values. In the case of hierarchical bar data, this will represent the total of all selected children.

Line data can be filtered to make it easier to see trends.

Moving Average (MA) shows the same line averaged out using the values from a number of frames on either side of the current frame, with five frames being the default.

Local Maximum (LM) is useful for data that varies consistently for each frame, such as time-sliced shadows for example.

Enabling either of these will hide the base item by default. You can only display the information in one mode at a time: Off, MA, or LM.

Screenshot tab

Screenshots are useful for seeing what happened while the log was being recorded. They are captured at 1/8 resolution to keep the log file size small.

To enable screenshots, set the e_StatoscopeScreenshotCapturePeriod console variable and enter the number of seconds between screenshots, with a value of -1 to disable and a value of 0 to capture screenshot frames continuously.

To view the screenshots during a captured session, hover the mouse over the timeline horizontally to view the screenshots updating.

Buckets tab

Available buckets are: Overall fps, RT fps, GPU fps, Triangles, Total Draw Calls, Shadow Draw Calls, Draw Calls and Texture Pool.

The 5fps clamp referred to in some columns treats frames whose length is longer than 200ms (5fps) as if it was 200ms. This is useful to stop very long frames from skewing the data too much.