User Guide

  • 2020.4
  • 12/10/2020
  • Public Content
Contents

Automating Frame Capture

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.
NOTE
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
    Properties
    , as follows:
    • Under
      Linker > Input > Additional Dependencies
      , add
      sdk.lib
      .
    • Under
      Linker > General > Additional Library Directories
      , add
      “C:\Program Files\IntelSWTools\GPA\sdk\lib\x64 or lib\x86”.
    • Under
      C
      /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
      CaptureFrame
      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.
 
See Also

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.