Intel® Graphics Performance Analyzers for macOS* Host

  • Intel® Graphics Performance Analyzers 2019 R4
  • 12/20/2019
  • Public Content
Contents

Creating Stream Captures

To perform offline analysis of your graphics application, you need to capture stream files. For stream capture, you can choose between two applications to capture from:
  • Graphics Frame Analyzer – capture from here using the
    Add
     button on the home screen.
  • Graphics Monitor – set the dropdown menu to
    Save Stream
     to trigger a capture of a stream file.
 
NOTE
If you are using a launcher, select a
Launcher
 option from the dropdown menu. If no launcher option is chosen, Intel® GPA will not hook to your application correctly and you will likely see an error.

To capture frames on your local system, use Graphics Monitor:

  1. Run the Graphics Monitor on your target system.
  2. Launch the graphics application as described in Launching an Application, remembering to select
    Save Stream
    . The application will start running with the System Analyzer HUD enabled. The stream file will record all movement and metrics for your game until you exit the application.

To capture frames on your local system, use Frame Analyzer:

  1. Open Frame Analyzer.
  2. Select the
    Add
     button.
  3. Navigate to the Metal tab.
  4. Select Save Stream or Launcher Save Stream from the dropdown menu.
 
All the captured frame and trace files are saved on your analysis system. By default, you can find them in the Intel® GPA home directory. On macOS*, the default home directory is
/Users/%USERNAME%/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>.stream
. For example:
StateManager_2011_02_17__11_25_14.stream
. 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. You can sort these files by date_time in Frame Analyzer, to see the newest files first.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804