Starting and Stopping Recording#

Once enabled correctly, PVRCarbon will be loaded and start recording for all launched applications. PVRCarbon Recorder on Android may lose data if it does not stop recording correctly. The following explains the right ways to end recording.

To stop recording, you will need to be familiar with setting Android properties using the setprop command, and/or editing the pvrcarbon.json configuration file. There is more information on how to do this, along with how to use the properties mentioned, in the Configuration Options section.

To stop recording, use one of these methods:

  • Set a fixed number of frames to record using the Android property pvrcbn.frames via setprop.

  • Set to exit after a specific frame, using the PVRCarbon property pvrcbn.exitAfterFrame via either the setprop or the pvrcarbon.json configuration file. Unlike with pvrcbn.frames, this will close the application. If PVRCarbon is recording at the time, it will finish and then finalise the file.

  • Send a SIGINT from the terminal to the process ID (PID) of the application being recorded e.g. kill -2 <PID>.

Note

These methods can also be applied to rooted and unrooted setups with both OpenGL ES and Vulkan libraries. Before rebooting the device use setprop pvrcbn.enable 0, otherwise the rooted device cannot be booted up.

This is an example of a configuration that enables and stops recording in the pvrcarbon.json file:

{
    "recording":
    {
        "enable": true,
        "exitAfterFrame": 500
    }
}

Note

For unrooted devices, setprop may not work, so the pvrcarbon.json configuration file will need to be used instead. Android does not report if the property has not been set, so use getprop to verify whether it was set.