Importing

< Previous | Contents | Manuals Home | Boris FX | Next >

Importing

The File/Import/Plain Text/Import 2-D Tracker Paths import can be used to read the output of the 2-D exporter, or from other programs as well. The import script offers a similar set of controls to the exporter. See the tooltips for information on each control.


A screenshot of a computer  Description automatically generated

The import runs roughly in reverse of the export. The frame offset is applied to the frame numbers in the file, and only those within the selected first and last frames are stored.

The scale and offset can be adjusted; by default they are 1 and 0 respectively.

The values of 2 and -1 shown undo the effect of the 0.5/0.5 in the example export panel.

If you are importing several different tracker data files into a single moving object or camera, you may have several different trackers all named Tracker1, for example, and after combining the files, this would be undesirable. Instead, by turning on Force unique names, each would be assigned a new unique name. Of course, if you have done supervised tracking in some different files to combine, you might well leave it off, to combine the paths together.

If the input data file contains data only for frames where a tracker has been found, the tracker will still be enabled past the last valid frame. By turning on Truncate enables after last, the enable will be turned off after the last valid frame.

After each tracker is read, it is locked up. You can unlock and modify it as necessary. The tracking data file contains only the basic path data, so you will probably want to adjust the tracker size, search size, etc.

If you will be writing your own tracker data file for this script to import, note that the lines must be sorted so that the lines for each specific tracker are contiguous, and sorted in order of ascending frame number. This convention makes everyone’s scripts easier. Also, note that the tracker names in the file never contain spaces, they will have been changed to underscores.

©2024 Boris FX, Inc. — UNOFFICIAL — Converted from original PDF.