Getting Started Guide

  • 06/26/2020
  • Public Content

Get Started with Intel® GPA for macOS* Host

Intel® Graphics Performance Analyzers (Intel® GPA) provide a solution for graphics analysis and optimization that can help you improve the performance of games and other graphics-intensive Microsoft DirectX*, Apple Metal*, Vulkan*, and OpenGL* applications.
Intel® GPA is available on Windows*, macOS*, and Ubuntu* hosts.

 

Choose your target application type:
 
Analyzing Metal* Desktop Applications on macOS* Host

Prerequisites

You have the following software installed on your analysis system:
  • Intel® GPA tools
For detailed system requirements and installation instructions, see the Release Notes.
 
Step 1: Launch a Metal* application for analysis
  1. Launch Graphics Monitor on your macOS target system.
  2. Select an application to run analysis.
    Note
    If your application requires a launcher to run, such as Blizzard* or Steam*, select the launcher not the standalone application.
  3. Choose the required
    Application Startup
    mode:
    • Frame
      : Choose this mode to capture a frame for an OpenGL application.
    • Trace
      : Choose this mode to capture a trace for an OpenGL application.
    • Stream
      : Choose this mode to capture frame sequence till the application is stopped for a Metal application.
    • Live Analysis
      : Choose this mode to pause a Metal application to analyze a frame in real time.
    • Live Analysis [Apps with Launchers]
      : Choose this mode to pause a launcher dependent Metal application to analyze a frame in real time.
  4. Click
    Start
    to begin application analysis. The application opens for real-time analysis with the Heads-Up Display (HUD) overlay.
Learn more about starting application analysis.
Step 2: Run high-level system analysis
  1. Use the
    HUD
    to examine various CPU, GPU, graphics API, or system metrics.
    Note
    To change the viewable metrics in the
    HUD
    , press
    F12
    >
    Edit
    >
    Options
    and select the metrics you would like to view. You can only select metrics from the same group at one time.
  2. To view and analyze a frame during game play, press
    F12
    ; this pauses and resumes the application, allowing you to pause on any frame of interest.
Step 3: Perform frame analysis for applications
  1. To save a stream file - multiple frames captured back-to-back - select
    Save Stream
    from the drop-down menu before launching an application.
  2. To open a stream file for analysis: open
    Graphics Frame Analyzer
    , select a stream file, and press
    Open
    .
    Note
    Frames show still images that are screenshots of the actual application, while streams are shown as an image of a video icon with a grey background:
  3. Enter Pause/Play mode by pressing F12, where you can:
  • Use Fast Scrub Mode to visualize the output of every drawcall, as your frame is being rendered out
  • Use the Metric Analysis tab to see which part of the rendering pipeline is experiencing a bottleneck for a specific erg (or multiple ergs)
  • Disable/enable events to see how the removal of an event will affect a scene, as well as performance
Note
You can pause on any frame during live analysis and during stream playback.
 
Analyzing OpenGL Desktop Applications on macOS Host
To profile a
n
OpenGL Desktop
application, you need to have the tools installed on the system where your application runs (target system). If you want to profile an application remotely, install the tools on both host and target systems.

Prerequisites

Make sure you have the following software installed:
  • Intel® GPA tools
For detailed system requirements, see the Release Notes.
Step 1. Launch your
OpenGL Desktop
application for analysis
  1. Launch Graphics Monitor on your
    macOS
    target system.
  2. Select an application for analysis.
  3. Choose the required
    Application Startup
    mode:
    • Frame
      : Choose this mode to capture a frame for an OpenGL application.
    • Trace
      : Choose this mode to capture a trace for an OpenGL application.
    • Stream
      : Choose this mode to capture frame sequence till the application is stopped for a Metal application.
    • Live Analysis
      : Choose this mode to pause a Metal application to analyze a frame in real time.
    • Live Analysis [Apps with Launchers]
      : Choose this mode to pause a launcher dependent Metal application to analyze a frame in real time.
  4. Click
    Start
    . The application opens for real-time analysis with the Heads-Up Display (HUD) overlay. Click CTRL+F1 to toggle between different HUD display modes that show frame rate, real-time performance metrics, and HUD controls.
Learn more about modifying analysis settings.
Step 2. Run high-level system analysis
  1. Using the HUD, examine various CPU, GPU, graphics API, or system metrics while your application is running. You can select the metrics for analysis in the
    Options
    screen accessible through the Graphics Monitor Launcher Screen.
  2. Modify render states and observe
    performance changes in frame rate and in metrics charts to identify performance bottlenecks. Click Ctrl+F1 to view the list of the available overrides and the respective keyboard shortcuts.
  3. Capture frame files for further in-depth analysis with
    Graphics Frame Analyzer
    .
Learn more about system analysis.
Step 3. Perform frame analysis for GPU-bound applications
  1. Find the most expensive draw calls in the frame and analyze their optimization opportunities.
  2. Experiment with state overrides to correlate performance issues with specific stages of the graphics pipeline.
  3. Depending on the results of your experiments, explore the following optimization opportunities:  
    • analyze texture bandwidth
    • optimize complex geometry
    • experiment with states and shaders
    • minimize overdraw
Learn more about frame analysis.
 
Training and Documentation
To learn more about the product, see the following resources:
Get access to Intel® GPA videos and tutorials.
Learn about Intel® GPA new features and supported system configurations.
View documentation for all the Intel® GPA features.
Ask your questions about Intel® GPA and get help and support.
Legal Information
Intel and the Intel logo are trademarks of Intel Corporation in the U.S. and/or other countries.
* Other names and brands may be claimed as the property of others.
Microsoft, Windows, and the Windows logo are trademarks, or registered trademarks of Microsoft Corporation in the United States and/or other countries.
© Intel Corporation.
This software and the related documents are Intel copyrighted materials, and your use of them is governed by the express license under which they were provided to you (
License
). Unless the License provides otherwise, you may not use, modify, copy, publish, distribute, disclose or transmit this software or the related documents without Intel's prior written permission.
This software and the related documents are provided as is, with no express or implied warranties, other than those that are expressly stated in the License.

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