vcapture-demo

Demonstrate camera and video content

Syntax:

vcapture-demo  [-device=deviceid]
               [-display=displayid]
               [-dmode=deinterlace_mode]
               [-flip]
               [-format=bufferformat]
               [-fs]
               [-mirror]
               [-pos=coordinates]
               [-rot=rotation]
               [-scale=scale_multiplier]
               [-source=index]
               -std=video_standard
               [-zorder=order]

Runs on:

QNX Neutrino

Options:

-device=deviceid
An integer that specifies the index of the device to use for capturing video.
-display=displayid
A string that represents a numeric value or a display type. As a numeric value, it's used to represent the display ID. As a string value, it represents the display type using one of these values, which are case-sensitive:
internal
An internal connection type to the display.
composite
A composite connection type to the display.
svideo
An S-Video connection type to the display.
YPbPr
The YPbPr signal of the component connection.
rgb
The RGB signal of the component connection.
rgbhv
The RBGHV signal of the component connection.
dvi
A DVI connection type to the display.
hdmi
An HDMI connection type to the display.
other
A connection type to the display which is one other than internal, composite, S-Video, component, DVI, HDMI, or DisplayPort.
-dmode=deinterlace_mode
A string that specifies the deinterlace mode to use for the captured video. The deinterlace mode that you specify must be supported by your capture hardware. This mode can be specified by using one of the following values, which are case-sensitive:
adaptive
Use motion adapative deinterlacing mode. This value is used if the -dmode= option isn't set.
Note: On supported platforms (e.g., Texas Instruments Jacinto 6), setting this value causes deinterlacing to be performed by using the on-board motion-adaptive hardware deinterlacer.
bob
Use BOB deinterlacing mode.
bob2
Use alternate BOB deinterlace mode.
none
Don't deinterlace the video. Set the -dmode= option to this value if deinterlacing isn't needed (e.g., on a NXP i.MX6 SABRE Smart target).
weave
Use WEAVE deinterlace mode.
weave2
Use alternate WEAVE deinterlace mode.
-flip
Display the output flipped vertically.
-format=bufferformat
A string that specifies the buffer format. If this option isn't set, the default format is yvyu. The format can be specified using one of the following values, which are case-sensitive:
  • rgba4444
  • rgbx4444
  • rgba5551
  • rgbx5551
  • rgb565
  • rgb888
  • rgba8888
  • rgbx8888
  • uyvy (default)
  • yuy2
  • yvyu
  • v422

You must select a format that's supported by your display hardware.

-fs
Stretch the output so that it's fullscreen, ignoring the aspect ratio, scale, and position.
-mirror
Display the output mirrored horizontally.
-pos=coordinates
A pair of integers that specifies the position of the video window on the display. The X and Y coordinates are delimited using a comma (,). For example, 10,10.
-rot=rotation
The rotation, in degrees (e.g., 0, 90, 180, or 270), of the capture window. The aspect ratio is maintained.
-scale=scale_multiplier
The multiplier for the window size. Typical multipler values range between 0.05 to 10.
-source=index
An integer that specifies the index of the device's video capture unit.
-std=video_standard
A string that specifies the video standard. It's mandatory that you specify the video standard. It can be one of the following values, which are case sensitive:
  • ntsc: Default frame size: 720x480.
  • pal: Default frame size: 720x576
  • secam Default frame size: 720x576
  • vga Default frame size: 640x480
-zorder=order
An integer that specifies the z-order of the video rendering window.
Note: On the NXP i.MX6 SABRE Smart target, de-interlacing isn't required with camera input. You must use -dmode=none (e.g., vcapture-demo -std=vga -format=uyvy -device=0 -source=0 -dmode=none).

Description:

The vcapture-demo utility demonstrates how to use Screen to display video that is captured using the Video capture API.

To run vcapture-demo on your target:

  1. Ensure that screen is running.
  2. Run vcapture-demo from a shell.
Note: Note that not all options, or values for each option, are valid for your specific target hardware.

Example:

Not all of the following examples may apply to your target hardware.

To start video capture with the VGA video standard, from source 0, and an output format of uyvy: 
vcapture-demo -std=vga -source=0 -format=uyvy -dmode=none
To start video capture with NTSC video standard, mirrored horizontally, and scaled by a factor of 1.2: 
vcapture-demo -std=ntsc -mirror -scale=1.2 -dmode=weave2