vtrvfutil(1)

NAME

vtrvfutil - MSB vframe clip utility

SYNOPSIS

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

DESCRIPTION

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

QUICKTIME CONVERSION NOTES

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.

EXAMPLES

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