Creating Frame and Trace Capture Files

To perform offline analysis of your graphics application, you need to capture stream, frame and trace files.

To capture streams, frames and traces on your local system, use System Analyzer HUD:

  1. Run the Graphics Monitor on your target system.

  2. Launch the graphics application as described in Launching an Application. The application starts running with the System Analyzer HUD enabled.

  3. Use Ctrl+Shift+C to create frame capture files or Ctrl+Shift+T to create trace capture files. Streams are created automatically upon startup. During the capture, all applied overrides are turned off. When the capture is complete, the System Analyzer HUD displays the message providing information on the file name or on possible errors, if any.

NOTE

To capture a frame, trace or stream, you should launch different instances of your application.

To capture frames and traces on a remote system, use System Analyzer:

  1. Run the Graphics Monitor on your target system.
  2. Start the System Analyzer on the analysis system and connect them to the Graphics Monitor running on the target system.
  3. Launch the graphics application on your target system as described in Launching an Application.
  4. In the System Analyzer, click the Capture Frame/Capture Trace button, or use the Ctrl+Shift+C/Ctrl+Shift+T keyboard shortcut. The frame/trace files are captured immediately.

NOTE

Some games and applications trap all keystrokes, so keyboard shortcuts within the Intel® GPA do not work. In this case, to create frame/trace capture files you can:

  • Use Capture Frame/Capture Trace buttons of the System Analyzer.

  • Set up a trigger in the Graphics Monitor to automatically create frame/trace capture files when certain conditions occur, for example when FPS is 20.

All the captured stream, frame and trace files are saved on your analysis system. By default, you can find them in the user's home directory. On Windows*, the default home directory is %USERPROFILE%\Documents\GPA.

The filenames consist of two fields: the name of the game executable and the capture date and time, in the format <executable name>_<date_time>. For example: StateManager_2011_02_17__11_25_14. This two-field format allows you to capture many frames/traces in a short amount of time without typing a name and overwriting the previous capture file.

NOTE

The capture functionality differs for frames and traces:

  • When you capture traces, Intel® GPA saves the contents of the ring buffer just prior to the triggered capture.
  • When you capture frames, Intel® GPA saves the next frame after the triggered capture.

Capturing Trace Data for Application Startup

To analyze data for your application startup:

  1. On the Graphics Monitor Launcher screen, click the button.
  2. In the Trace tab, click the Capture application startup toggle button.
  3. Start your application as described in the Launching an Application Manually topic. Intel® GPA captures the trace data once the trace buffer is full.

See Also

Customizing the Keyboard-shortcut Assignments

Automating Frame Capture

 

 

For more complete information about compiler optimizations, see our Optimization Notice.