Application

General

The General system preferences section is a collection of miscellaneous settings that do not warrant their own category.

Units of measurement

Scene units:

The physical unit of distance used by the application (Default: Meters).

Cinema gound plane line spacing:

This parameter controls the spacing between lines used to draw the ground plane in the Cinema window, measured in scene units (Default: 1m).

Default tracker distance:

The default distance between the camera and tracking points in 3D space, measured in scene units. This is use to initialise tracking points in 3D space during a camera solve, and affects the overall scale of the camera track (Default: 5m).

Comfort zone viewer distance:

The default viewer distance used to estimate stereoscopic viewing comfort (Default: 1.0 Meters).

Comfort zone screen width:

The default screen width used to estimate stereoscopic viewing comfort (Default: 0.5 Meters).

Imported media

OBJ mesh coordinate system:

The default coordinate system used to import OBJ files as Test Objects or for tracking in the Geometry Track node. This can be overridden on a case by case basis inside the node (Default: Right-handed and Y up).

Survey data coordinate system:

The default coordinate system used to import and export numerical survey coordinate data in the Survey Solver node. This can be overridden on a case by case basis (Default: Right-handed and Y up).

Import Quicktime files starting at frame 0 (rather than frame 1):

When importing new quicktime files, number the first frame of the movie as frame 0, instead of frame 1.

Additional file locations

Camera presets:

A customizable location from which XML camera presets will be loaded.

Sensor presets:

A customizable location from which XML sensor presets will be loaded.

Tree preset location:

A customizable location from which XML tracking tree presets will be loaded.

Export script location:

A customizable location from which Python export scripts will be loaded.

Node script location:

A customizable location from which Python node scripts will be loaded.

Macro script location:

A customizable location from which Python macro scripts will be read (only available for Enterprise and Studio).

Modelling primitives:

A customizable location from which image-based modelling primitives will be loaded.

Test objects:

A customizable location from which test object geometry will be loaded.

Metadata tags:

A customizable file location from which custom metadata tags will be loaded.

LIDAR storage:

The location used to store compressed binary LIDAR data. Default: project:/scratch which represents the scratch folder in the current project folder.

Other options

Use GPU for ST-Map undistort:

When enabled, the GPU will be used to undistort clips using imported ST-Maps. On systems with appropriate GPU hardware, this may provide increased performance when undistorting clips.

Store solver logs in the project:

When selected, solver log information will be stored in the project files instead of being discarded once displayed in the user interface (Default: not selected).

Check for network proxy authentication at launch:

When this option is enabled, you will be prompted to enter your network proxy authentication credentials when PFTrack starts if required for communication with The Pixel Farm's servers. PFTrack must be restarted before changes to this option take effect (Enterprise only)

Export

The Export section controls various aspects of data and clip export from the Scene Export and Footage Export nodes.

Default Export Directory:

The default path that is used when creating a new export node. The initial value is project:/export, i.e. in the export sub-directory of the project. Variables can be used in this directory to automatically reference the project name, media filename, the input clip node and the export node if required. Further details of these variables are available in the Scene Export Node.

Default Export Name:

The default name that is used for exports in an export node. The initial value is Export-%q, where %q is a variable that creates a unique and increasing number. Other variables can be used to automatically reference the project name, media filename, the input clip node and the export node if required. Further details of these variables are available in the Scene Export Node.

Scene export

Store current scene units when exporting Autodesk FBX:

When exporting Autodesk FBX, set the scene units in the FBX file to match those used in PFTrack. This may increase ease of use when importing the FBX file into some third-party applications, but may also cause incorrect behaviour if the third-party application is expecting all FBX files to retain the default FBX unit setting.

Always start at time 0 when exporting Autodesk FBX:

When exporting AutoDesk FBX, animation times will be set so the first frame of the clip always corresponds to time 0 regardless of the actual frame number.

Clip Export

Default Clip Format:

The default image or movie file format and bit depth used to export media.

Default QuickTime Codec:

On macOS, this option is available to select the default QuickTime codec and quality used to export clips (this option is only available if QuickTime is chosen as the default format above).

Default Media Foundation bit-rate:

On Windows, this option is available to select the default bit-rate for exporting Media Foundation files.

Default number padding:

The default amount of padding in the filename's frame number when exporting (Default value: 6).

Export Clip Information XML File:

When selected, an XML formatted file is written out which details information about the exported clip. This file is written to the same directory as the exported clip, has the same name, but a .xml file extension. The purpose of this information file is to aid integration with other systems.

ST-Map Export

Export full ST-Map data window:

This preference specifies when the the Export Full ST-Map data window option will be enabled in the Scene Export node. The default setting is Only when cropping undistorted images which means the full data window will be enabled when any lens distortion correction is cropped to a smaller resolution. Alternatively, this can be set to Always or Never to always export (or not) the full data window.

Export a single ST-Map for constant focal length cameras:

This preference specifies the default setting for the corresponding option in the Scene Export node (default: enabled).

Use integer coordinates for the centre of ST-Map pixels:

This preference specifies the default setting for the corresponding option in the Scene Export node (default: disabled).

Include ST-Map pixels outside the valid image range:

This preference specifies the default setting for the corresponding option in the Scene Export node (default: enabled).

← SYSTEM

USER →