VNR 100 • Reference Information
31
Description of the Frame Translator Utility
The Frame Translator utility is a command line utility that is run from a terminal window
on the VN-Matrix Recorder. The command line follows this structure:
./gcode
command flags
The available command flags are:
Flag
Description
-g
Enables graphical output. Opens a window that displays each frame in succession after it has
been exported.
NOTE:
A local display must be connected to the VN Recorder.
-t
Enables targa file output (.tga), one file per frame. Each frame is labelled video and numbered
sequentially from 1 onwards (for example
video000001.tga
).
-j
quality
Enables jpeg file output (.jpg), one file per frame. The quality parameter is a value between 0 and
100 that sets the compression of the jpg file from the minimum quality value (0, or maximum
compression) to the maximum quality value (100, or minimum compression). A value of 100
produces the best quality image with the largest file size. A typical quality value is 80.
-o
outputdir
outputdir
defines the path to the directory where the output files are stored. If this flag is not
specified, the files are output to the same directory as the gcode utility (typically
/home/matrix_
rec/VNRecorder_verx.y.z
).
NOTE:
The
-o
flag does not create the directory. To create a directory, see step 1 of
Frame
Translation Procedure
on page 33.
Each frame is labelled video and numbered sequentially from 1 onwards (for example
video000001.tga
). To aid identification and help with file management, Extron recommends
that a new output directory is created for each gcode file conversion.
-i
inputdir
inputdir
defines the path to the source directory containing the recording (
*.rec
) that is being
exported. For information about selecting the correct directory name, see
Recording File
Directory Nomenclature
on the following page.
-l
Lists the start and end times for the specified recording. This flag is used in conjunction with the
-i
flag, which specifies the directory where the recorded files are stored.
-s
start time
Specifies the time stamp from which the gcode process starts. The time is in the format
HH:MM:SS.tt
.
-f
end time
Specifies the time stamp at which the gcode process ends. The time is in the format
HH:MM:SS.tt
.
NOTE:
Setting a start time is optional. It is recommended that an end time is always
specified. Failure to do this may cause the command window to freeze after the last frame
to process. If this happens, use the <Ctrl>+<C> keys to end the process.
-h
Print help screen. This displays a list of flags and a brief description in the terminal window.
NOTES:
•
When using the
-j
,
-i
,
-o
,
-s
, and
-f
flags, it is necessary to leave a space between the command flag and
the parameter that follows (for example:
-o /home/matrix_rec/Recording_Files/recording1
).
•
Only one stream can be exported at a time. Video and audio must be exported separately (see
Working
with Video and Audio Streams
on page 37).
Summary of Contents for VNR 100
Page 6: ...VNR 100 Contents vi ...