Home
FAQ
Player
Stage
Gazebo
Contrib
Documentation
Publications
Contributors
Users

Project
Download
Bugs/Feedback
Mailing lists

Radish

Old news
Old stuff

camerav4l
[Drivers]

The camerav4l driver captures images from V4l-compatible cameras. See below for notes on specific camera/frame grabber combinations.

Compile-time dependencies
  • <linux/videodev.h>

Provides

Requires
  • none

Configuration requests
  • none

Configuration file options
  • port (string)
    • Default: "/dev/video0"
    • Device to read video data from.

  • source (integer)
    • Default: 3
    • Some capture cards have multiple input sources; use this field to select which one is used.

  • norm (string)
    • Default: "ntsc"
    • Capture format; "ntsc" or "pal"

  • size (integer tuple)
    • Default: varies with norm
    • Desired image size. This may not be honoured if the driver does not support the requested size).

  • mode (string)
    • Default: "RGB24"
    • Desired capture mode. Can be one of:
      • GREY (8-bit monochrome)
      • RGB565 (16-bit RGB)
      • RGB24 (24-bit RGB)
      • RGB32 (32-bit RGB; will produce 24-bit color images)
      • YUV420P (planar YUV data; will produce 8-bit monochrome images)
    • Note that not all capture modes are supported by Player's internal image format; in these modes, images will be translated to the closest matching internal format (e.g., RGB32 -> RGB888).

  • save (integer)
    • Default: 0
    • Debugging option: set this to write each frame as an image file on disk.

Note that some of these options may not be honoured by the underlying V4L kernel driver (it may not support a given image size, for example).

Example
driver ( name "camerav4l" provides ["camera:0"] )

Logitech QuickCam Pro 4000
For the Logitech QuickCam Pro 4000, use:
driver ( name "camerav4l" provides ["camera:0"] port "/dev/video0" source 0 size [160 120] mode "YUV420P" )

Kernel notes: with a little bit of tweaking, this camera will work with the pwc (Phillips Web-Cam) driver in the Linux 2.4.20 kernel. The stock driver recognizes the QC Pro 3000, but not the QC Pro 4000; to support the latter, you must modify the kernel source (add a product id in a couple of places in pwc-if.c). Milage may vary for other kernel versions. Also, the binary-only pwcx.o module is needed to access frame sizes larger than 160x120; good luck finding this and/or getting it to work (the developer spat the dummy and took down his website).

Authors
Andrew Howard


Generated on Tue May 3 14:16:10 2005 for Player by doxygen 1.3.6