PFTrack Documentation Customizing PFTrack

Metadata tags

The metatags.xml file can be used to customize how metadata is read from media files. An example file is included with PFTrack and is available in application installation folder: media/metatags.xml.

This file contains a list of metadata tag names, collected into a hierarchy, such as:

<?xml version="1.0" encoding="utf-8"?>
<metatags>
<photo>
<body>
<make>Exif.Image.Make</make>
<model>Exif.Image.Model</model>
<serial>Exif.Photo.BodySerialNumber</serial>
...
</body>
</photo>
</metatags>

In this example, the metadata tag Exif.Image.Make is used to define the camera body make for photogrammetry, Exif.Image.Model defines the camera body model, and Exif.Photo.BodySerialNumber contains the camera body serial number.

For example, this illustrates how to read camera focal length from the tag Exr.myApplication.FocalLength:

<?xml version="1.0" encoding="utf-8"?>
<metatags>
<movie>
<lens>
<focal>Exr.myApplication.FocalLength</focal>
</lens>
</movie>
</metatags>

Other examples are available in the file included in the installation folder media/metatags.xml, including reading position and orientation metadata from drones.

You can also read frame rates from movie clips by adding a frameRate entry to the movie information containing the metadata tag you wish to use:

<?xml version="1.0" encoding="utf-8"?>
<metatags>
<movie>
<body>
<frameRate>Exr.framesPerSecond</frameRate>
</body>
</movie>
</metatags>

You can place an additional file in metatags.xml containing any user-specific changes to avoid the need to edit the file installed alongside PFTrack.