Firewire camera capture

The camera1394 driver captures images from IEEE1394 (Firewire, iLink) cameras.

Compile-time dependencies
  • libraw1394
  • libdc1394_control
Provides
  • interface_camera
Requires
  • none
Configuration requests
  • none
Configuration file options
  • guid (string [16 digits])
  • Default: None
  • The GUID of the 1394 camera to use (only for libdc1394 >= 2.0)
  • Example: guid "0800460200060121"
  • Currently, if using libdc1394 >= 2.0
    • You should use GUID if you are on port > 0
    • To get GUID, run Player once with no GUID and look at the .player log file for the GUID of detected cameras.
  • port (integer)
  • Default: 0
  • The 1394 port the camera is attached to.
  • v2 of the dc1394 API no longer supports ports other than 0. If your camera is on a port > 0, and you are on Linux, you probably have /usr/include/dc1394/linux/control.h, which should allow you to use ports > 0 (if this file was detected during ./configure). Otherwise, use the GUID of the camera.
  • node (integer)
  • Default: 0
  • The node within the port
  • framerate (float)
  • Default: 15
  • Requested frame rate (frames/second)
  • mode (string)
  • Default: "640x480_yuv422"
  • Capture mode (size and color layour). Valid modes are:
  • "320x240_yuv422"
  • "640x480_mono"
  • "640x480_yuv422"
  • "640x480_rgb"
  • "800x600_mono"
  • "800x600_yuv422" - will be rescaled to 600x450
  • "1024x768_mono"
  • "1024x768_yuv422" - will be rescaled to 512x384
  • "1280x960_mono"
  • "1280x960_yuv422" - will be rescaled to 640x480
  • "FORMAT7_MODE0" - only available with libdc1394 >= 2.0
  • Currently, all mono modes will produce 8-bit monochrome images unless a color decoding option is provided (see bayer).
  • All yuv422 modes are converted to RGB24
  • force_raw (integer)
  • Default: 0
  • Force the driver to use (slow) memory capture instead of DMA transfer (for buggy 1394 drivers).
  • save (integer)
  • Default: 0
  • Debugging option: set this to write each frame as an image file on disk.
  • bayer (string)
  • Default: None.
  • Bayer color decoding options for cameras such as the Point Grey Dragonfly and Bummblebee. Option activates color decoding and specifies the Bayer color pattern. Valid modes are:
  • "BGGR"
  • "GRBG"
  • "RGGB"
  • "GBRG"
  • method (string)
  • Default: None (or "DownSample" if bayer option is specified)
  • Determines the algorithm used for Bayer coloro decoding. Valid modes are:
  • "Nearest"
  • "Simple"
  • "Bilinear"
  • "HQLinear"
  • "DownSample"
  • "VNG"
  • "AHG"
  • brightness (int)
  • Default: None
  • Sets the camera brightness setting. Valid modes are:
  • -1 for automatic mode
  • any suitable unsigned integer
  • exposure (int)
  • Default: None
  • Sets the camera exposure setting. Valid modes are:
  • -1 for automatic mode
  • any suitable unsigned integer
  • shutter (int)
  • Default: None
  • Sets the camera shutter setting. Valid modes are:
  • -1 for automatic mode
  • any suitable unsigned integer
  • gain (int)
  • Default: None
  • Sets the camera gain setting. Valid modes are:
  • -1 for automatic mode
  • any suitable unsigned integer
  • whitebalance (string)
  • Default: None
  • Sets the manual camera white balance setting. Valid modes are:
  • "auto" (only for dc1394 v2)
  • a string containing two suitable blue and red value unsigned integers
  • dma_buffers
  • Default: 4
  • the number of DMA buffers to use
  • iso_speed (unsigned int)
  • Default: 400
  • Sets the data rate of the 1394 bus. Valid rates are 100, 200, 400, 800, 1600, 3200.
    Example
    driver
    (
    name "camera1394"
    provides ["camera:0"]
    )
    
Author
Nate Koenig, Andrew Howard; major code rewrite by Paul Osmialowski, newch.nosp@m.ief@.nosp@m.king..nosp@m.net..nosp@m.pl