videoin(1)                                                          videoin(1)


NAME
     videoin - Video Library video-in-a-window tool

SYNOPSIS
     videoin [-t <title>] [-v <n>] [-n <devnum>] [-f] [-F <format>] [-d]
          [-b] [-B #] [-A] [-I] [-z n/d] [-r n/d] [-8] [-m] [-h] [-p x y]

PARAMETERS
     -t <title>
          Title of displayed window.

     -v <n>
          The number of the video input node to connect to.

     -n <devnum>
          The number of the video device to be used.


     -f   Disable forking.

     -F <fmt>
          Select video format.


     -d   Print debug messages.


     -b   Don't put borders on window.


     -B # Use # buffers for buffering video data between video input and the
          display.  The default is 3.


     -A   Display when source is available.


     -I   Print node and path IDs for use with command line interface.

     -z <n/d>
          Initial zoom ratio numerator/denominator.

     -r <n/d>
          Initial frame rate numerator/denominator.


     -8   Display using 8 bit pixels (depends on hardware).


     -m   Display using monochrome (depends on hardware).


     -h   Print usage message and exit.

     -p <x> <y>
          Window position x,y (must be last option if specified).

DESCRIPTION
     The application videoin puts video in a window on the workstation.

     This application first tries to establish a path between the video source
     and the screen directly.  If this fails, it tries to grab frames to
     memory and then writes to the screen using the window system as if it
     were a normal graphics application.

     On hardware that supports these operations the video can be zoomed and
     panned using the + and - keys (zoom) and the left and right arrow keys
     (pan).

     If the -f option is specified videoin will run in the foreground rather
     than spawning a child and returning immediately.

     If the -F option is specified videoin will select the video format using
     the VL_FORMAT SetControl.  Videoin will also attempt to select an input
     node that has the specified format.  Current choices are listed below and
     upper or lower case is ignored.

     This option is hardware dependent and is not available to Galileo or
     Indigo2 video users.

         COMPOSITE
         SVIDEO
         RGB
         BETACAM
         MII
         SMPTE_YUV
         DIGITAL_COMPOSITE
         DIGITAL_COMPONENT
         DIGITAL_COMPONENT_SERIAL
         DIGITAL_COMPONENT_DUAL
         DIGITAL_COMPONENT_DUAL_SERIAL
         DIGITAL_INDYCAM

     If -A is specified videoin prints messages indicating when the shared
     video source is available or when it has been taken away by another
     application.

     If -I is specified videoin prints the node and path IDs on stdout. These
     are required when using the command line interface tool.

     If -b is specified videoin puts up its output window with no border.


     If -B # is specified videoin uses # buffers for buffering video data
     between the video input and the display.  The default is 3 which allows
     for one buffer being filled, one being emptied and one (the last input
     frame) saved for screen refresh during window exposures.  To determine
     how much memory is being used for each buffer, caculate pixel size (in
     bytes) times the number of pixels on a line times the number of lines.
     For certain video devices, this number is rounded up to the next 4k page
     boundary.  Note that this option is relevant only for videoin operation
     which uses the video to memory to screen data path (currently only VINO
     uses this).


     If -z is specified videoin zooms the video to a ratio of n/d within the
     range supported by the hardware.

     If -p x y is specified videoin will place the upper right corner of the
     output window at x,y within the range supported by the hardware. This
     must the the last option on the command line if it is specified.

SEE ALSO
     videopanel(1), vlinfo(1), vlcmd(1)


                                                                        Page 3