videoin(1)videoin(1)NAMEvideoin - Video Library video-in-a-window tool
SYNOPSISvideoin [-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).
Page 1
videoin(1)videoin(1)-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.
Page 2
videoin(1)videoin(1)
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 ALSOvideopanel(1), vlinfo(1), vlcmd(1)
Page 3
