vidtomem(1)vidtomem(1)NAMEvidtomem - Video Library capture single frame tool
SYNOPSISvidtomem [-f <filename>] [-w] [-d] [-c <count>] [-h] [-r [packing] ]
[-n <device>] [ -v <video-node> ] [-o <memory-node>] [-I] [-t]
[-z n/d] [-s wxh]
PARAMETERS-f <filename>
Name of output file to be created. '-00000.<ext>' will be appended
to the filename. If count is > 1 the subsequent filenames will be
sequenced.
-w Don't write frame to disk, simply capture and exit.
-d Display frame in window on screen.
-c <count>
Capture <count> frames, up to the limits of the hardware for burst
capture.
-r [packing]
Capture data in raw, device-dependent packing. When written to
disk, the filename's suffix will indicate the packing. The optional
packing parameter used with -r specifies the VL packing number to
use when capturing the image. If -r is specified without a packing
argument, VL_PACKING_YVYU_422_8 (packing # 5) is assumed.
-h Display help message
-n <device>
Specifies the VL device to use for capture.
-v <video-node>
Specifies the video node number to use for capture.
-o <memory-node>
Specifies the memory node number to use for capture.
-I Print node and path IDs for use with command line interface.
-t Wait for external trigger before frame capture.
-s <w>x<h>
Set frame dimensions, w is the width, h is the height.
Page 1
vidtomem(1)vidtomem(1)-z <n>/<d>
Set frame zoom ratio, n is the numerator, d is the denominator.
DESCRIPTION
The application, vidtomem , on hardware that supports the video to memory
path, captures and writes to disk the image on the current video input.
By default, it selects the current input last selected by vcp or if vcp
has not been used to change the default input, it uses node 0 of the
video source 0, which is the analog input, and writes its images to files
of the form <filename>-<N>.<ext> where N is replaced by the 5 digit
sequence number of the captured frame and ext is replaced by an
abbreviation for the data format (packing type). The default for
filename is 'out'.
If -w is specified vidtomem does not write the captured frame to disk.
If -d is specified vidtomem attempts to display the captured frame in a
window on the workstation screen using ipaste.
If -r is specified vidtomem doesn't perform any translation of the data
upon capture, and writes the raw data to disk for the user.
If -I is specified vidtomem prints the node and path IDs on stdout. These
are required when using the command line interface tool, vlcmd , to get
or set controls on the video hardware.
If -t is specified vidtomem waits for an external trigger before
capturing a frame or sequence of frames.
If -s is specified vidtomem clips the frame size to width w and height h
using the upper left corner of the frame as the clip origin. The values
of w and h must be positive. If either is negative the default sizes are
used.
If -z is specified vidtomem zooms the frame(s) to a ratio of n/d within
the range supported by the hardware.
The -v and -o options may be used to specify the source and drain node
numbers explicitely. For example:
vidtomem-v 1 -o 2
This instructs vidtomem to use video source node 1 and memory drain node
2. Note: all combinations of video and memory nodes may not be possible.
Consult the Owner's Guide or Programmer's Guide for a list of node
numbers for each device.
Page 2
vidtomem(1)vidtomem(1)SEE ALSOmemtovid(1), videopanel(1), vlinfo(1), ipaste(1), vlcmd(1)BUGS
If the -v option is used to specify a Galileo Video digital source node
(either 1 or 2) which does not have an input video signal connected
vidtomem will hang waiting for a video frame. If vidtomem is killed the
videod daemon will be left hanging. To correct the problem become
superuser and do a killall on the videod daemon.
Page 3
