capture(1)                                                          capture(1)



NAME
     capture - record movies, images, or sounds

SYNOPSIS
     capture [-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 ALSO
     mediarecorder(1)











































                                                                        Page 4