Exporting REALVIZ Ascii Point Tracks (.rz2)exportingREALVIZ Ascii Point Tracks

Use the procedure described in the Exporting a project section. See Exporting a project. From the Save as type drop-down list, select REALVIZ Point Tracks (.rz2). MatchMover exports only the point tracks of the current sequence.

TipIf you have several sequences you must change the current time to export the point tracks of each sequence.

You can edit this file then re-import it into MatchMover.

The file created contains four object type descriptions, the tracks, the computed 2D points, the keys and the sequence corresponding to the file (a file equals a sequence).

Sequence

This is the first information contained in the file.

imageSequence "Label"

{360				243	f("path") b(0 38 1) -Upper field first/-Lower field first}

The label can contain letters, numbers, spaces and underscores. It must be contained within quotation marks and is optional.

The numbers 360 and 243 correspond to the film resolution, width followed by height.

The path indicates the position of the file. It is shown by f("...").The path is optional.

b(0 38 1) indicates the start, end and step of the sequence and determines the tracked point Id. Start, end and step are whole numbers. This element is optional and if omitted the start value is 0.

For example, if b(15 50 1), the tracked point Id is numbered between 15 and 50. When you open the file with a sequence that starts at 0, the tracked point Id is automatically re-numbered between 0 and 35. However, if you want to keep the original Id you must change b(15 50 1) to b(0 35 1).

-Upper field first/-Lower field first specifies the interlacing of the film. If there is no parameter, there is no interlacing. Otherwise, you must specify it with Upper field first or Lower field first.

Track

pointTrack "Label" -nc -nr rgb( 64 0 128 )

...

The label can contain letters, numbers, spaces and underscores. It must be contained within brackets and is optional. The Label is useful to complete a track when one sequence follows another (there are two files). During the import of the second file, the tracks with the same label are completed.

If nc is specified this indicates that the track is not used for 3D calibration.

If nr is specified this indicates that the track is not reconstructed in 3D.

The color rgb (red, green, blue) is optional.

The track contains the points and the corresponding keys.

Keys and points

For the keys:

Id	X	Y	kb(threshold)		s(top bottom right left )			p(top bottom right left)

Intermediate key -> ki (threshold).
Automatic key -> ka (threshold).
Begin key -> kb (threshold).
End key -> ke (threshold).
Single key -> ks (threshold).
s(...)corresponds to the search area.
p(...)corresponds to the pattern area.

For the points:

Id	X	Y	p+( score )		-ncp

Id indicates the frame number relative to the start of the sequence.

X and Y indicate the coordinates of the key or point from the upper left corner.

For the points:

p+(score ) Point obtained from a backward track.
p-( score ) Point obtained from a forward track.
p*(score) Point obtained from a bi-directional track.

If ncp is specified, this indicates an incomplete track point.

If there is only Id X Y, this means the creation of a single key with default parameters.

Creating a minimal rz2 file

For each track:

Track point

Id	CoordX		CoordY

Id	CoordX		CoordY

Id	CoordX		CoordY

Id	CoordX		CoordY

Id	CoordX		CoordY

... }