User Guide

  • 2020.3
  • 07/10/2020
  • Public Content

See Also

You can automate frame capturing by including calls to the Intel® GPA interface directly into your application using the Automatic Frame Capture. This allows you to streamline debugging and profiling by capturing the exact frame you are interested in. For example, you may want to capture a frame when a certain event happens, or you would like to capture frames.
The Automatic Frame Capture is not available for DirectX* 12 based applications.
To link the Automatic Frame Capture to your application:
  1. Open your application project in Microsoft Visual Studio*.
  2. Update the project
    , as follows:
    • Under
      Linker > Input > Additional Dependencies
      , add
    • Under
      Linker > General > Additional Library Directories
      , add
      “C:\Program Files\IntelSWTools\GPA\sdk\lib\x64 or lib\x86”.
    • Under
      /C++ > General > Additional Include Directories
      , add
      “C:\Program Files\IntelSWTools\GPA\sdk\include”.
  3. In your application source code:
    • Include GPASDK.h in your source code:
      #include <GPASDK.h>
    • Get the Intel® GPA interface:
      IGPA* gpa_interface = GetGPAInterface();
    • Insert the calls to the
      function into the source code before each event you want to capture in a frame:
      // If GPA is attached
      if (gpa_interface)
          const char* frame_filename = "Example.gpa_frame"; // You can also use nullptr and the name will be generated automatically
          IGPA::Result capture_result = gpa_interface->CaptureFrame(frame_filename);
          if (capture_result != IGPA::Result::Ok)
              // Capture failed
  4. Compile and build your application.
To capture frames, run your application from the Graphics Monitor, as usual. Intel® GPA captures the frames automatically as specified in the source code.

Product and Performance Information


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