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

Share on linkedin
Share on twitter
Share on facebook
Share on reddit
Share on digg
Share on email

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.

Benjamin Anuworakarn

Benjamin Anuworakarn

Ben Anuworakarn is a technical author in the PowerVR Developer Technology team and has a computer science engineering background. Primarily responsible for producing and maintaining both internal and external documentation, he has a knack for coming up with solutions to problems that don't exist yet. You can find him either clacking away at his keyboard or shuffling trading cards every few hours.

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

Please leave a comment below

Comment policy: We love comments and appreciate the time that readers spend to share ideas and give feedback. However, all comments are manually moderated and those deemed to be spam or solely promotional will be deleted. We respect your privacy and will not publish your personal details.

Blog Contact

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

United Kingdom

[email protected]
Tel: +44 (0)1923 260 511

Search by Tag

Search by Author

Related blog articles

Beaglebone Black

Fun with PowerVR and the BeagleBone Black: Low-Cost Development Made Easy

Development boards are cool and the BeagleBone® Black (BBB) is one of the more interesting ones around. This widely available tiny board costs around £35 and will boot Linux is only 10 seconds so anyone interested in development can get stuck in quickly. The Introduction to Mobile Graphics course has been recently revamped for 2020 for the Imagination’s University Programme and the widely available, low-cost BBB is an ideal platform for student teaching and exercises based on OpenGL® ES2.0, instead of an expensive standard PC.

Read More »
android background

The Android Invasion: Imagination GPU IP buddies up with Google-powered devices

Google Android continues to have the lion share of the mobile market, powering around 75% of all smartphones and tablets, making it the most used operating system in the world. Imagination’s PowerVR architecture-based IP and the Android OS are bedfellows, with a host of devices based on Android coming to market all the time. Here we list a few that have appeared in Q4 2020.

Read More »
pvrtextoolgui sunrise 2

PowerVR SDK and Tools 2020 Release 2 now available

We all know that 2020 has been quite a challenging year, but we hope you’re doing well. Over the last few months, here in DevTec, we’ve been working hard to get this new release out for you and the time has now come for our second release of the PowerVR SDK and Tools of 2020. So, what’s new with this latest release? Let’s take a quick look at a few of the major changes.

Read More »

Connect

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