5 easy steps to add PVRTrace libraries to your own OpenGL ES application

This post serves as a quick start guide of how you can add the PVRTrace libraries to your own OpenGL ES application and begin capturing traces. We will use the PowerVR SDK example applications to demonstrate the process.

PowerVR SDK - reflection + chromatic dispersion (1)

We will be attaching the trace libraries to Windows 32-bit applications here. Dynamically linked libraries are also provided for all other platforms, which can be found in the logically named sub-folders.

Step 1: From the PowerVR_SDK installation directory, navigate to “Binaries/Windows_x86_32/Examples”. Choose any example application, this will be the application that we will be working with.

Step 2: Find: “PowerVR_Tools/PVRTrace/Recorder/Windows_x86_32”

Copy the trace libraries:

libEGL.dll
libGLES_CM.dll
libGLESv1_CM.dll
libGLESv2.dll
PVRTrace.dll

to the folder containing the executable.

Step 3: Find: “PowerVR_Tools/PVRVFrame/Library/Windows_x86_32”

Copy the VFrame libraries:

libEGL.dll
libGLES_CM.dll
libGLESv2.dll

to a new sub-folder named /PVRVFrameLibs in the executable folder.

 

Step 4: Create a new file named “pvrtraceconfig.json” in the executable folder, with the following contents:

{
  "*": {
    "Tracing": {
      "StartFrame": 0,
      "EndFrame": 9999
    },
    "Host": {
      "EglLibraryPath": "PVRVFrameLibs/libEGL.dll",
      "Es1LibraryPath": "PVRVFrameLibs/libGLES_CM.dll",
      "Es2LibraryPath": "PVRVFrameLibs/libGLESv2.dll"
    }
  }
}

Please note, prior to SDK 3.5 the format of the config was different. If you are using tracing libraries from SDK 3.4 or older you will need to use the following config instead:

{
  "Tracing": {
    "StartFrame": 0,
    "EndFrame": 9999
  },
  "Host": {
    "EglLibraryPath": "PVRVFrameLibs/libEGL.dll",
    "Es1LibraryPath": "PVRVFrameLibs/libGLES_CM.dll",
    "Es2LibraryPath": "PVRVFrameLibs/libGLESv2.dll"
  }
}

Step 5: That’s it! Run the executable, and the trace libraries should now begin writing to a file named “<executable-name>.pvrt”

We’ve also made a batch file that can be dropped in next to any Windows 32-bit executable in the PowerVR_SDK folder. Download  and run it – it will copy in the required trace libraries and create the pvrtraceconfig.json file for you, ready to begin tracing.

 

PowerVR SDK - reflection + chromatic dispersion (2)

Additional information, including more detailed configuration options, can be found in the PVRTrace User Manual, included in the SDK.

3 thoughts on “5 easy steps to add PVRTrace libraries to your own OpenGL ES application”

Leave a Comment

Search by Tag

Search for posts by tag.

Search by Author

Search for posts by one of our authors.

Featured posts
Popular posts

Blog Contact

If you have any enquiries regarding any of our blog posts, please contact:

United Kingdom

benny.har-even@imgtec.com
Tel: +44 (0)1923 260 511

Related blog articles

AI in the UK: Year in Review

As a company focused heavily on enabling AI processing, it’s important to us that the country where we live is supporting efforts around AI technology development and policy. Indeed, the government, academic institutions, investors, and the entire ecosystem in the

CES 2019 banner

Get some facetime with Imagination at CES 2019

As the holiday season starts to fade to a distant memory the reality of CES is once again looming large our horizons, promising a new flurry of technology announcements to try and make sense of. As the saying goes, what

Lenovo 300e

PowerVR 2018 consumer tech round-up

Before we shut up shop for the year here at Imagination HQ, we thought we take a quick look at some of the end user products that Imagination tech found its way into in 2018. Our IP has appeared in

7 technology predictions for 2019

It’s the time of year again when Imagination once again gazes into its crystal ball to see if we can discern what will be coming our way in 2019 – and if you want to see how our 2018 predictions

Stay up-to-date with Imagination

Sign up to receive the latest news and product updates from Imagination straight to your inbox.

  • This field is for validation purposes and should be left unchanged.