vtrvfutil - MSB vframe clip utility


/usr/vtr/bin/vtrvfutil [ options ... ] clip [ new-clip ]


vtrvfutil is a utility for examining and modifying VCP-Recorder clips stored using the vframe clip format. clip specifies the name of the clip: Not the full filename, as in /usr/vtr/clips/d/news, but rather the clip name, d/news.

If new-clip is specified, clip is copied to new-clip. The clip alignment can be changed by using the -A options.

Each vtrvfutil option may have one or more suboptions that are specified using the format:

-x subopt1[=value1],...,suboptn[=valuen])

Some suboptions take values, while others do not.

vtrvfutil has the following options:

Audio options:
-a export=file
Export audio to file (AIFF-C format)
-a import=file
Import audio from file (AIFF-C format)
-a in=h:m:s:f
Timecode of in point (starting frame)
-a out=h:m:s:f
Timecode of out point (ending frame +1)
Alignment options:
-A major=bytes
Specify clip major (stripe) alignment
-A minor=bytes
Specify clip minor (block) alignment
Command options:
-c checknondrop
Check for non drop vitc timecode
-c checkrice
Software decodes each field of Rice-coded clip
-c checkvitc
Check for vitc discontinunity
-c copy
Copy input clip to output clip
-c makeindex
Make vframe index (input clip in Quicktime format)
-c makeqt
Make Quicktime (add Quicktime metadata to clip file)
-c realign
Realign clip in place (use -A to specify alignment)
Input clip options:
-i file=file
Specify clip filename
-i index=file
Specify clip index filename
-i nodirect
Do not use direct I/O to access clip
-i qt
Clip is in Quicktime format (no vframe index)
Output clip options:
-o file=file
Specify clip filename
-o index=file
Specify clip index filename
-o nodirect
Do not use direct I/O to access clip
-o vitc
Use vitc as frame count to generate index file
Printing options:
-p headers
Print all clip headers
-p info
Print clip header summary and analysis
-p frames
Print clip per-frame info
-p sizes=bins
Print frame-size histogram
Still image import/export options:
-s export
Copy the image at the specified timecode from the clip to the specified file. This is the default when -s is specified but neither import nor export is specified.
-s file=file
Specify image file name
-s import
Copy the image from the file into the clip at the specified timecode.
-s mode=mode
Specify interleave mode (f1, f2, f1f1, f2f2, f1f2)
-s type=type
Specify image format (rice, yuv, rgb, jpeg, tiff)
-s tc=h:m:s:f
Specify clip frame to import or export
Update options:
NOTE: If a new-clip name is specified, the update is applied to both the original clip and the new clip.
-u header
Update vframe index header using analysis results
-u frames=num
Set number of frames to num
-u start=h:m:s:f
Set starting frame timecode
-v level
Set verbosity level


The SGI MovieLib support for Quicktime-formatted files only supports audio sample widths of 8 or 16 bits. This may conflict with the default input audio sample width for the device port you are using to record your clips.


To copy clip A to clip B:

vtrvfutil A B

To copy clip A to /clips/B.{media,index}:

vtrvfutil -o file=/clips/B.media,index=/clips/B.index A B