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.
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:
to the folder containing the executable.
Step 3: Find: “PowerVR_Tools/PVRVFrame/Library/Windows_x86_32”
Copy the VFrame libraries:
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:
Please note, since SDK 3.5 the format of the config has been updated. If you are using the 3.5 tracing libraries you will need to use the following config instead:
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.
Additional information, including more detailed configuration options, can be found in the PVRTrace User Manual, included in the SDK.Follow @ImaginationTech