brown_perception: gscam

Package Summary

A ROS camera driver that uses gstreamer to connect to devices such as webcams.

• Author: Graylin Trevor Jay, Christopher Crick
• License: BSD
• Repository: brown-ros-pkg
• Source: svn http://brown-ros-pkg.googlecode.com/svn/trunk/distribution/brown_perception/gscam

Overview

gscam is meant as a simple approach to using a webcam in ROS that maximizes compatibility. gscam leverages Gstreamer, a multimedia framework similar to DirectShow. Specifically: Gstreamer can be used to build up multimedia "pipelines" consisting of sources, sinks, and filters. For example: a v4l webcam source might be filtered by an upscaler before being sent to the screen (a sink). Alternately, a mp4 file might act as a source and be filtered into an avi file as a sink. There are many possibilities. For an overview see: Using Gstreamer.

gscam can attach itself to a specially formatted pipeline. Provided this pipeline is processing RGB video, gscam will rebroadcast the video over as both a standard ROS image transport and a ROS Camera. Since Gstreamer is compatibile with almost every video capture standard under Linux (and many on OSX), gscam makes ROS defacto compatible with almost every Linux webcam or video system available. Moreover, because there are a number of Gstreamer filters for processing video (e.g. white-balancing, cropping, etc.) gscam allows for a more advanced video processing even with cheaper webcams.

Gstreamer is an extremely rich framework, but basic usage is fairly simple. Please see the "Basic Usage" section to get started. You may also find the Gstreamer documentation on their website to be helpful.

Running

gscam expects an environmental variable, GSCAM_CONFIG, to contain a gstreamer pipeline definition for it to launch. There is one important restriction:

• At the end of the pipeline where gscam will attach itself, the pipeline must be carrying RGB formatted video.

Here's an example launch that should work on almost any machine where Gstreamer is installed and a camera of some kind is available attached to /dev/video2. Note that gscam expects to start within the bin directory:

roscd gscam
cd bin
export GSCAM_CONFIG="v4l2src device=/dev/video2 ! video/x-raw-rgb ! ffmpegcolorspace"
rosrun gscam gscam

If you see a message about a "failure to PAUSE" or something similar, the most likely cause is a permission issue with the available video devices.

If you see a "Processing..." message, it means gscam is happily publishing.

You can graphically explore many of the available video devices with the gstreamer-properties utility. gst-inspect-0.10 (or .09 or whatever is your Gstreamer version number) will list all of the available plugins.

Advanced Usage

gscam is fully compatible with the ROS Camera interface and can be calibrated to provided rectified images. For details, see the appropriate ROS documentation.