capture(1)capture(1)NAMEcapture - record movies, images, or sounds
SYNOPSIScapture [-nofork] [-n #] [-analog] [-digital] [-vino] [-ev1] [-audio]
[-video] [-still] [-snapshot] [-fixedMode[audio] [video] [still]
[snapshot]] [-movieCompression none | MVC1 | MVC2 | JPEGhard | JPEGsoft |
qtvideo ] [-movieFormat sgi | qt ] [-execString string ] [-fixedFile]
[filename]
DESCRIPTION
The capture program is obsolete. The command name and argument syntax
have been retained for backwards compatibility, but their use is strongly
deprecated. capture has been replaced by mediarecorder. Please refer to
the manual page for mediarecorder(1) and update your scripts accordingly.
capture is an interactive program to record digital media files from the
camera, microphone and workstation screen.
-nofork
Causes capture to run in the foreground, rather than the default
behavior of forking itself off as a background process.
-n #
Chooses the video device # to use on an Indy workstation with an
Indy Video option board. Vino is device 0; Indy Video is device 1.
-analog
Use the analog input source for the video camera.
-digital
Use the digital input source for the video camera.
-vino
Use the vino video hardware (built in video for the Indy) as the
input source.
-ev1 Use the Galileo, Indy Video, or Indigo2 Video hardware has the input
source.
-audio
Start up in audio capture mode.
-video
Start up in video/movie capture mode.
-still
Start up in video/still frame grab mode. All images are created in
SGI rgb file format.
Page 1
capture(1)capture(1)-snapshot
Start up in screen snapshot mode.
-fixedMode [ audio video still snapshot ]
Do not allow user to change from startup mode. This option takes up
to four optional qualifiers:
audio
video
still
snapshot
capture will limit the choices on the record mode menu to only those
modes specified. If fixedMode is invoked with no qualifiers, it
locks capture into whatever mode it starts up with and disables the
record mode menu.
If you use -audio, -video, -still or -snapshot to force a record mode for
startup, and you specify a list of qualifiers for -fixedMode, you must
also include the forced startup mode in the list.
-movieCompression
Chooses compression to use for movie recording. This option is
always followed by exactly one qualifier from the following list:
none
MVC1
MVC2
JPEGhard
JPEGsoft
qtvideo
Because the Cosmo Compress option is compatible only with the
Galileo, Indy Video, and Indigo2 Video options, the JPEGhard option
cannot be used with the vino video hardware (built in video for the
Indy).
-movieFormat
Chooses output format for movie recording. Currently, the available
choices are the following:
sgi
Page 2
capture(1)capture(1)
qt
-execString[string]
specifies a command string for capture to execute whenever it writes
a file. If the string "%s" appears within string, it will be
replaced with the file name which was written to disk. This allows
an application to learn when a file was written to disk by having
capture run an accessory program, which sends a message to the
application.
-fixedFile
Prevent user from changing the file name set on the command line at
startup.
EXAMPLES
To use capture to record video from your application, into a file called
TEMPMOVIE which your application will later access, do this:
capture-video -fixedMode -nofork -fixedFile TEMPMOVIE
This will force video mode and will prevent changing from that mode. It
will place the resultant movie file in TEMPMOVIE. The user cannot change
this name while capture is running. When capture exits, TEMPMOVIE will
either contain the last movie created or will be unchanged (if the user
exited without creating a movie).
To use capture to record either still images or screen snapshots from
your application into a file called TEMPIMAGE which your application will
later access, do this:
capture-snapshot -fixedMode snapshot still -nofork -fixedFile TEMPIMAGE
This will force screen snapshot mode and will allow the user to choose
between screen snapshot mode and video still frame mode. It will place
the resultant image file in TEMPIMAGE. The user cannot change this name
while capture is running. When capture exits, TEMPIMAGE will either
contain the image file created or will be unchanged (if the user exited
without creating a movie).
To use capture to record SGI format movies from the IndyCam using MVC2
video compression do this:
capture-video -digital -vino -movieFormat sgi -movieCompression MVC2
This will start up capture in video capture mode, using the IndyCam and
the built-in Indy video hardware. The resulting movie will be saved in
SGI movie format using MVC2 video compression. The user may change both
the recording mode (video, still, audio, snapshot) and the movie file
name using capture's graphical interface.
Page 3
capture(1)capture(1)
To use capture to record a movie file, then to run the program "myprog"
whenever it writes a file, do this:
capture-video -execString "myprog %s"
This will start up capture in video capture mode, using the current
default settings. Every time the user captures a file, capture will
execute the program "myprog", passing it the name of the file the user
just captured.
SEE ALSOmediarecorder(1)
Page 4
