memtovid(1)memtovid(1)NAMEmemtovid - Video Library single frame output tool
SYNOPSISmemtovid-f <filename> [-h] [-o <output>] [-v <memnode>] [-n <num>]
[-F] [-c] [-t] [-p] [-P] [-I] [-m <format>]
[-r [packing]]
PARAMETERS-f <filename>
Name of input file containing image data.
-h Display a usage message
-o <output>
The node number of the video drain node you wish to use.
-v <memnode>
The node number of the memory source node you wish to use.
-n <num>
Number of images to be read in from disk and sent to video output.
-F Use filter when converting rgb to yuv
-c Center image in video output.
-t Wait for external trigger before sending image to video output.
-p Pause for user response after sending each image to output.
-P Pause for user response after all images have been output.
-I Print node and path IDs for use with command line interface.
-m <format>
Select format used to display the image.
-r [packing]
Selects raw input mode. The specified packing number will be used to
display the image.
DESCRIPTION
The application memtovid, on hardware that supports the memory to video
path, writes the image to the node specified by the -o option. If -o is
not specified, the image is sent to output node number 0.
Page 1
memtovid(1)memtovid(1)memtovid takes an image in any of the formats produced by running
vidtomem, the single frame capture tool.
This image is in device-dependent format (see applicable release notes on
specific products for more info on these formats.)
The -c option centers the image in the video output signal when using
images that are smaller than the video format.
The -p option pauses memtovid after each image is sent to the video
output until the user presses a key. If -p is not specified memtovid
sends successive images to video out with no pauses in between.
Specifying the -P option causes memtovid to pause only after all frames
have been output. There is no benefit gained in using this option in
addition to the -p option.
The -I option 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.
The -r option specifies the packing of the input file. If -r is not
specified, memtovid will attempt to determine the appropriate packing
based on the input file's extension. The filenames produced by with
vidtomem command are compatible with memtovid. See /usr/include/vl/vl.h
for specific numbers.
The -m option specifies the format. By default, VL_FORMAT_SMPTE_YUV is
used. See VL_FORMAT_* in /usr/include/vl/vl.h for specific numbers.
The -v and -o options may be used to specify the source and drain node
numbers explicitely. For instance, the following instructs memtovid to
use video node 2 and memory node 1:
memtovid-v 1 -o 2 -f image-00000.rgb
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.
SEE ALSOvidtomem(1), videopanel(1), vlinfo(1), vlcmd(1)NOTES
When neither the -P nor -p option is not specified, then memtovid waits
for a VLStreamStopped event to occur. Not all video products currently
support this event. This is the case for both Galileo and Indigo2 Video.
Simply interrupt the program to terminate it.
Page 2
memtovid(1)memtovid(1)
Some devices, such as IMPACT Video, do not contain a frame buffer to hold
the frame after it has been played. Consequently, if the -p option is not
used, the image will be output for only one frame duration. If the -p
option is used, then the frame will be output continuously.
Page 3
