vp1394CMUGrabber Class Reference

#include <vp1394CMUGrabber.h>

Inheritance diagram for vp1394CMUGrabber:

Public Types
enum	vpColorCodingType {   YUV444 , YUV422 , YUV411 , RGB8 ,   MONO8 , MONO16 , UNKNOWN }

Public Member Functions
	vp1394CMUGrabber ()
virtual	~vp1394CMUGrabber ()
void	acquire (vpImage< unsigned char > &I)
void	acquire (vpImage< vpRGBa > &I)
void	close ()
void	displayCameraDescription (int cam_id)
void	displayCameraModel ()
int	getFramerate ()
void	getGainMinMax (unsigned short &min, unsigned short &max)
int	getNumberOfConnectedCameras () const
void	getShutterMinMax (unsigned short &min, unsigned short &max)
vpColorCodingType	getVideoColorCoding () const
void	open (vpImage< unsigned char > &I)
void	open (vpImage< vpRGBa > &I)
vp1394CMUGrabber &	operator>> (vpImage< unsigned char > &I)
vp1394CMUGrabber &	operator>> (vpImage< vpRGBa > &I)
void	selectCamera (int cam_id)
void	setAutoGain ()
void	setAutoShutter ()
void	setControl (unsigned short gain, unsigned short shutter)
void	setFramerate (unsigned long fps)
void	setShutter (unsigned short shutter)
void	setGain (unsigned short gain)
void	setVideoMode (unsigned long format, unsigned long mode)

Public Attributes
bool	init

Inherited functionalities from vpFramegrabber
unsigned int	getHeight () const
unsigned int	getWidth () const
unsigned int	height
unsigned int	width

Detailed Description

Firewire cameras video capture based on CMU 1394 Digital Camera SDK.

Thus to be enabled, this class needs the optional CMU 1394 3rd party. Installation instruction are provided here https://visp.inria.fr/3rd_cmu1394.

This block is based on the CMU 1394 Digital Camera SDK. The CMU 1394 Digital Camera Driver must be installed (go to http://www.cs.cmu.edu/~iwan/1394/index.html to download it).

• Parameters:
  • Camera index (0, 1, 2, ... or 10). First camera has index 0.
  • Image format
  • Frame rate. Real frame rate depends on device capacities.
  • Control : shutter speed and gain can be internally set, but it is possible to set manually them. Exposure time register value. Real exposure time depends on device capacities. Gain register value. Real gain depends on device capacities.

This first example available in tutorial-grabber-CMU1394.cpp shows how to grab and display images from a firewire camera under Windows.

#include <visp3/core/vpConfig.h>
#include <visp3/core/vpImage.h>
#include <visp3/gui/vpDisplayFactory.h>
#include <visp3/sensor/vp1394CMUGrabber.h>
 
int main()
{
#ifdef VISP_HAVE_CMU1394
#ifdef ENABLE_VISP_NAMESPACE
  using namespace VISP_NAMESPACE_NAME;
#endif
#if (VISP_CXX_STANDARD >= VISP_CXX_STANDARD_11)
  std::shared_ptr<vpDisplay> display;
#else
  vpDisplay *display = nullptr;
#endif
  try {
    vpImage<unsigned char> I;
 
    vp1394CMUGrabber g;
    g.setVideoMode(0, 1); // 640x480 MONO8
    g.setAutoShutter();
    g.setAutoGain();
    g.setFramerate(4); // 30 fps
    g.open(I);
 
    std::cout << "Image size: " << I.getWidth() << " " << I.getHeight() << std::endl;
 
#ifdef VISP_HAVE_DISPLAY
#if (VISP_CXX_STANDARD >= VISP_CXX_STANDARD_11)
    display = vpDisplayFactory::createDisplay(I);
#else
    display = vpDisplayFactory::allocateDisplay(I);
#endif
#else
    std::cout << "No image viewer is available..." << std::endl;
#endif
 
    while (1) {
      g.acquire(I);
      vpDisplay::display(I);
      vpDisplay::flush(I);
      if (vpDisplay::getClick(I, false)) // A click to exit
        break;
    }
  }
  catch (const vpException &e) {
    std::cout << "Catch an exception: " << e << std::endl;
  }
 
#if (VISP_CXX_STANDARD < VISP_CXX_STANDARD_11)
  if (display != nullptr) {
    delete display;
  }
#endif
#else
  std::cout << "Install CMU1394 SDK, configure and build ViSP again to use this example" << std::endl;
#endif
}

This other example shows how to consider more than one firewire camera, and how to grab and display images from the first camera found on the bus.

#include <iostream>
 
#include <visp3/core/vpImage.h>
#include <visp3/gui/vpDisplayOpenCV.h>
#include <visp3/sensor/vp1394CMUGrabber.h>
 
#ifdef ENABLE_VISP_NAMESPACE
using namespace VISP_NAMESPACE_NAME;
#endif
 
int main()
{
#if defined(VISP_HAVE_CMU1394)
  std::cout << "ViSP Image acquisition example" << std::endl;
 
  vpImage<unsigned char> I;
  vp1394CMUGrabber g;
 
  if( g.getNumberOfConnectedCameras() > 1 )
    std::cout << "There are " << g.getNumberOfConnectedCameras() << " connected cameras." << std::endl;
    if( g.getNumberOfConnectedCameras() == 1 )
      std::cout << "There is " << g.getNumberOfConnectedCameras() << " connected camera." << std::endl;
    else
      std::cout << "There is no connected camera." << std::endl;
 
  // Setting camera parameters manually
  g.selectCamera(0);
  g.setGain(0);
  g.setShutter(2000);
  g.setFramerate(3);    // 15 FPS
  g.setVideoMode(0, 5); // 640x480 - MONO
 
  g.acquire(I);
 
  // Display camera description
  g.displayCameraDescription(0);
  g.displayCameraModel();
  std::cout << "Height: " << g.getHeight() << " Width: " << g.getWidth() << std::endl;
 
  vpDisplayOpenCV d(I);
  vpDisplay::display(I);
 
  for(;;)
  {
    g.acquire(I);
    vpDisplay::display(I);
    vpDisplay::flush(I);
    if (vpDisplay::getClick(I, false)) // a click to exit
        break;
  }
 
  g.close();
#endif
  std::cout << "ViSP exiting..." <<std::endl;
  return 0;
}

Examples

grab1394CMU.cpp, servoPioneerPanSegment3D.cpp, servoPioneerPoint2DDepth.cpp, servoPioneerPoint2DDepthWithoutVpServo.cpp, tutorial-apriltag-detector-live.cpp, tutorial-blob-tracker-live.cpp, tutorial-grabber-CMU1394.cpp, tutorial-mb-generic-tracker-live.cpp, tutorial-me-ellipse-tracker.cpp, tutorial-me-line-tracker.cpp, and tutorial-pose-from-points-live.cpp.

Definition at line 162 of file vp1394CMUGrabber.h.

Member Enumeration Documentation

vpColorCodingType

enum vp1394CMUGrabber::vpColorCodingType

Enumeration of color codings.

Enumerator
YUV444
YUV422
YUV411
RGB8
MONO8
MONO16
UNKNOWN

Definition at line 168 of file vp1394CMUGrabber.h.

Constructor & Destructor Documentation

vp1394CMUGrabber()

BEGIN_VISP_NAMESPACE vp1394CMUGrabber::vp1394CMUGrabber

(

)

Basic constructor.

Definition at line 48 of file vp1394CMUGrabber.cpp.

References vpFrameGrabber::height, vpFrameGrabber::init, UNKNOWN, vp1394CMUGrabber(), and vpFrameGrabber::width.

Referenced by operator>>(), operator>>(), and vp1394CMUGrabber().

~vp1394CMUGrabber()

vp1394CMUGrabber::~vp1394CMUGrabber ( )

virtual

Destructor.

Definition at line 66 of file vp1394CMUGrabber.cpp.

References close().

Member Function Documentation

acquire() [1/2]

void vp1394CMUGrabber::acquire ( vpImage< unsigned char > & I )

virtual

Grabs a grayscale image from the selected camera. If the camera color coding differs from vp1394CMUGrabber::MONO8, the acquired image is converted in a gray level image to match the requested format.

Parameters

I	: Acquired gray level image.

Implements vpFrameGrabber.

Examples

grab1394CMU.cpp, and tutorial-grabber-CMU1394.cpp.

Definition at line 205 of file vp1394CMUGrabber.cpp.

References close(), MONO16, vpImageConvert::MONO16ToGrey(), MONO8, open(), vpFrameGrabberException::otherError, RGB8, vpImageConvert::RGBToGrey(), vpERROR_TRACE, YUV411, vpImageConvert::YUV411ToGrey(), YUV422, vpImageConvert::YUV422ToGrey(), YUV444, and vpImageConvert::YUV444ToGrey().

Referenced by operator>>(), and operator>>().

acquire() [2/2]

void vp1394CMUGrabber::acquire ( vpImage< vpRGBa > & I )

virtual

Grabs a color image from the selected camera. Since the cameras are not able to grab RGBa color coding format, the acquired image is converted in a RGBa to match the requested format. This transformation could be time consuming.

Parameters

I	: Acquired color image in RGBa format.

Implements vpFrameGrabber.

Definition at line 260 of file vp1394CMUGrabber.cpp.

References close(), vpImageConvert::GreyToRGBa(), MONO16, vpImageConvert::MONO16ToRGBa(), MONO8, open(), vpFrameGrabberException::otherError, RGB8, vpImageConvert::RGBToRGBa(), vpERROR_TRACE, YUV411, vpImageConvert::YUV411ToRGBa(), YUV422, vpImageConvert::YUV422ToRGBa(), YUV444, and vpImageConvert::YUV444ToRGBa().

close()

void vp1394CMUGrabber::close ( )

virtual

Stop the acquisition of images and free the camera.

Implements vpFrameGrabber.

Definition at line 312 of file vp1394CMUGrabber.cpp.

References close(), vpFrameGrabber::init, vpFrameGrabberException::otherError, and vpERROR_TRACE.

Referenced by acquire(), acquire(), close(), selectCamera(), setFramerate(), setVideoMode(), and ~vp1394CMUGrabber().

displayCameraDescription()

void vp1394CMUGrabber::displayCameraDescription

(

int

cam_id

)

Display information about the camera on the standard output.

Definition at line 477 of file vp1394CMUGrabber.cpp.

displayCameraModel()

void vp1394CMUGrabber::displayCameraModel

(

)

Display camera model on the standard output. Call it after open the grabber.

Definition at line 493 of file vp1394CMUGrabber.cpp.

getFramerate()

int vp1394CMUGrabber::getFramerate

(

)

Get the video framerate.

Returns

Value between 0 to 7 corresponding to a specific camera framerate. See the following table for the correspondences between the returned value and the framerate.

Value	Frame rate
0	1.875 fps
1	3.75 fps
2	7.5 fps
3	15 fps
4	30 fps
5	60 fps
6	120 fps
7	240 fps

See also

setFramerate()

Examples

grab1394CMU.cpp.

Definition at line 698 of file vp1394CMUGrabber.cpp.

getGainMinMax()

void vp1394CMUGrabber::getGainMinMax	(	unsigned short &	min,
		unsigned short &	max )

Get the gain min and max values.

See also

setAutoGain(), setGain()

Examples

grab1394CMU.cpp.

Definition at line 354 of file vp1394CMUGrabber.cpp.

getHeight()

BEGIN_VISP_NAMESPACE unsigned int vpFrameGrabber::getHeight ( ) const

inherited

Return the number of rows in the image.

Examples

AROgre.cpp, AROgreBasic.cpp, testPylonGrabber.cpp, and tutorial-rbt-sequence.cpp.

Definition at line 38 of file vpFrameGrabber.cpp.

References height.

getNumberOfConnectedCameras()

int vp1394CMUGrabber::getNumberOfConnectedCameras

(

)

const

Get the number of connected cameras.

Definition at line 342 of file vp1394CMUGrabber.cpp.

getShutterMinMax()

void vp1394CMUGrabber::getShutterMinMax	(	unsigned short &	min,
		unsigned short &	max )

Get the shutter min and max values.

See also

setAutoShutter(), setShutter()

Examples

grab1394CMU.cpp.

Definition at line 416 of file vp1394CMUGrabber.cpp.

getVideoColorCoding()

vpColorCodingType vp1394CMUGrabber::getVideoColorCoding ( ) const

inline

Get the video color coding format.

Definition at line 225 of file vp1394CMUGrabber.h.

References MONO16, MONO8, RGB8, UNKNOWN, YUV411, YUV422, and YUV444.

Referenced by setVideoMode().

getWidth()

unsigned int vpFrameGrabber::getWidth ( ) const

inherited

Return the number of columns in the image.

Examples

AROgre.cpp, AROgreBasic.cpp, testPylonGrabber.cpp, and tutorial-rbt-sequence.cpp.

Definition at line 43 of file vpFrameGrabber.cpp.

References width.

open() [1/2]

void vp1394CMUGrabber::open ( vpImage< unsigned char > & I )

virtual

Initialization of the grabber using a greyscale image.

Parameters

I	: gray level image.

Implements vpFrameGrabber.

Examples

tutorial-apriltag-detector-live.cpp, tutorial-grabber-CMU1394.cpp, and tutorial-pose-from-points-live.cpp.

Definition at line 182 of file vp1394CMUGrabber.cpp.

References vpFrameGrabber::height, and vpFrameGrabber::width.

Referenced by acquire(), and acquire().

open() [2/2]

void vp1394CMUGrabber::open ( vpImage< vpRGBa > & I )

virtual

Initialization of the grabber using a color image.

Parameters

I	: color image.

Implements vpFrameGrabber.

Definition at line 192 of file vp1394CMUGrabber.cpp.

References vpFrameGrabber::height, and vpFrameGrabber::width.

operator>>() [1/2]

vp1394CMUGrabber & vp1394CMUGrabber::operator>>

(

vpImage< unsigned char > &

I

)

Operator that allows to capture a grey level image.

Parameters

I	: The captured image.

#include <visp3/sensor/vp1394CMUGrabber.h>
 
#ifdef ENABLE_VISP_NAMESPACE
using namespace VISP_NAMESPACE_NAME;
#endif
 
int main()
{
  vpImage<unsigned char> I;
  vp1394CMUGrabber g;
  g >> I;
}

Definition at line 725 of file vp1394CMUGrabber.cpp.

References acquire(), and vp1394CMUGrabber().

operator>>() [2/2]

vp1394CMUGrabber & vp1394CMUGrabber::operator>>

(

vpImage< vpRGBa > &

I

)

Operator that allows to capture a grey level image.

Parameters

I	: The captured image.

#include <visp3/sensor/vp1394CMUGrabber.h>
 
#ifdef ENABLE_VISP_NAMESPACE
using namespace VISP_NAMESPACE_NAME;
#endif
 
int main()
{
  vpImage<vpRGBa> I;
  vp1394CMUGrabber g;
  g >> I;
}

Definition at line 751 of file vp1394CMUGrabber.cpp.

References acquire(), and vp1394CMUGrabber().

selectCamera()

void vp1394CMUGrabber::selectCamera

(

int

cam_id

)

Select the camera on the bus from its index. The first camera found on the bus has index 0.

Parameters

cam_id

: Camera index.

Definition at line 80 of file vp1394CMUGrabber.cpp.

References close(), vpFrameGrabberException::initializationError, and vpERROR_TRACE.

setAutoGain()

void vp1394CMUGrabber::setAutoGain

(

)

Enable auto gain.

See also

setGain()

Examples

tutorial-grabber-CMU1394.cpp.

Definition at line 368 of file vp1394CMUGrabber.cpp.

setAutoShutter()

void vp1394CMUGrabber::setAutoShutter

(

)

Enable auto shutter.

See also

setShutter()

Examples

tutorial-grabber-CMU1394.cpp.

Definition at line 431 of file vp1394CMUGrabber.cpp.

setControl()

void vp1394CMUGrabber::setControl	(	unsigned short	gain,
		unsigned short	shutter )

Set the gain and the shutter values.

See also

setGain(), setShutter()

Definition at line 333 of file vp1394CMUGrabber.cpp.

References setGain(), and setShutter().

setFramerate()

void vp1394CMUGrabber::setFramerate

(

unsigned long

fps

)

Set camera framerate rate. This method has to be called before open().

Parameters

fps	: Value between 0 to 7 used to select a specific camera framerate. See the following table for the correspondences between the input value and the framerate.

Value	Frame rate
0	1.875 fps
1	3.75 fps
2	7.5 fps
3	15 fps
4	30 fps
5	60 fps
6	120 fps
7	240 fps

See also

getFramerate()

Examples

grab1394CMU.cpp, and tutorial-grabber-CMU1394.cpp.

Definition at line 633 of file vp1394CMUGrabber.cpp.

References close(), vpFrameGrabberException::otherError, vpFrameGrabberException::settingError, and vpERROR_TRACE.

setGain()

void vp1394CMUGrabber::setGain

(

unsigned short

gain

)

Disable auto gain and set the gain to the requested value.

See also

setAutoGain()

Definition at line 378 of file vp1394CMUGrabber.cpp.

Referenced by setControl().

setShutter()

void vp1394CMUGrabber::setShutter

(

unsigned short

shutter

)

Disable auto shutter and set the shutter to the requested value.

See also

setAutoShutter()

Definition at line 441 of file vp1394CMUGrabber.cpp.

Referenced by setControl().

setVideoMode()

void vp1394CMUGrabber::setVideoMode	(	unsigned long	format,
		unsigned long	mode )

Set the camera format and video mode. This method has to be called before open().

Parameters

format	: Camera video format.
mode	: Camera video mode.

See the following table for the correspondences between the input format and mode and the resulting video color coding.

Format	Mode	(H) x (W)	Color
0	0	160 x 120	YUV444
0	1	320 x 240	YUV422
0	2	640 x 480	YUV411
0	3	640 x 480	YUV422
0	4	640 x 480	RGB8
0	5	640 x 480	MONO8
0	6	640 x 480	MONO16
1	0	800 x 600	YUV422
1	1	800 x 600	RGB8
1	2	800 x 600	MONO8
1	3	1024 x 768	YUV422
1	4	1024 x 768	RGB8
1	5	1024 x 768	MONO8
1	6	800 x 600	MONO16
1	7	1024 x 768	MONO16
2	0	1280 x 960	YUV422
2	1	1280 x 960	RGB8
2	2	1280 x 960	MONO8
2	3	1600 x 1200	YUV422
2	4	1600 x 1200	RGB8
2	5	1600 x 1200	MONO8
2	6	1280 x 960	MONO16
2	7	1600 x 1200	MONO16

Examples

grab1394CMU.cpp, servoPioneerPoint2DDepth.cpp, servoPioneerPoint2DDepthWithoutVpServo.cpp, and tutorial-grabber-CMU1394.cpp.

Definition at line 548 of file vp1394CMUGrabber.cpp.

References close(), getVideoColorCoding(), vpFrameGrabber::height, vpFrameGrabberException::otherError, vpFrameGrabberException::settingError, vpERROR_TRACE, and vpFrameGrabber::width.

Member Data Documentation

height

unsigned int vpFrameGrabber::height

protectedinherited

Number of rows in the image.

Definition at line 139 of file vpFrameGrabber.h.

Referenced by vp1394TwoGrabber::acquire(), vpDiskGrabber::acquire(), vpDiskGrabber::acquire(), vpDiskGrabber::acquire(), vpDiskGrabber::acquire(), vpDiskGrabber::acquire(), vpDiskGrabber::acquire(), vpFlyCaptureGrabber::acquire(), vpFlyCaptureGrabber::acquire(), vpPylonGrabberGigE::acquire(), vpPylonGrabberGigE::acquire(), vpPylonGrabberUsb::acquire(), vpPylonGrabberUsb::acquire(), vpV4l2Grabber::acquire(), vpV4l2Grabber::acquire(), vp1394TwoGrabber::dequeue(), vp1394TwoGrabber::dequeue(), vpDirectShowGrabber::getFormat(), vpVideoReader::getFrame(), vpVideoReader::getFrame(), vp1394TwoGrabber::getHeight(), vp1394TwoGrabber::getHeight(), getHeight(), vp1394CMUGrabber::open(), vp1394CMUGrabber::open(), vpDiskGrabber::open(), vpDiskGrabber::open(), vpDiskGrabber::open(), vpV4l2Grabber::open(), vpV4l2Grabber::open(), vpDirectShowGrabber::setFormat(), vp1394TwoGrabber::setFormat7ROI(), vpV4l2Grabber::setHeight(), vpDirectShowGrabber::setImageSize(), vp1394CMUGrabber::setVideoMode(), vp1394TwoGrabber::setVideoMode(), vp1394CMUGrabber::vp1394CMUGrabber(), vp1394TwoGrabber::vp1394TwoGrabber(), and vpFrameGrabber().

init

bool vpFrameGrabber::init

inherited

Set to true if the frame grabber has been initialized.

Definition at line 102 of file vpFrameGrabber.h.

Referenced by vpV4l2Grabber::acquire(), vpV4l2Grabber::acquire(), vp1394CMUGrabber::close(), vp1394TwoGrabber::close(), vpFlyCaptureGrabber::connect(), vpPylonGrabberGigE::connect(), vpPylonGrabberUsb::connect(), vpFlyCaptureGrabber::disconnect(), vpPylonGrabberGigE::disconnect(), vpPylonGrabberUsb::disconnect(), vpDiskGrabber::open(), vpDiskGrabber::open(), vpDiskGrabber::open(), vpV4l2Grabber::open(), vpV4l2Grabber::open(), vp1394TwoGrabber::resetBus(), vpFlyCaptureGrabber::startCapture(), vpPylonGrabberGigE::startCapture(), vpPylonGrabberUsb::startCapture(), vpFlyCaptureGrabber::stopCapture(), vpPylonGrabberGigE::stopCapture(), vpPylonGrabberUsb::stopCapture(), vp1394CMUGrabber::vp1394CMUGrabber(), vp1394TwoGrabber::vp1394TwoGrabber(), vpDiskGrabber::vpDiskGrabber(), vpDiskGrabber::vpDiskGrabber(), vpDiskGrabber::vpDiskGrabber(), vpFrameGrabber(), vpV4l2Grabber::vpV4l2Grabber(), vpV4l2Grabber::vpV4l2Grabber(), vpV4l2Grabber::vpV4l2Grabber(), vpV4l2Grabber::vpV4l2Grabber(), and vpV4l2Grabber::vpV4l2Grabber().

width

unsigned int vpFrameGrabber::width

protectedinherited

Number of columns in the image.

Definition at line 140 of file vpFrameGrabber.h.

Referenced by vp1394TwoGrabber::acquire(), vpDiskGrabber::acquire(), vpDiskGrabber::acquire(), vpDiskGrabber::acquire(), vpDiskGrabber::acquire(), vpDiskGrabber::acquire(), vpDiskGrabber::acquire(), vpFlyCaptureGrabber::acquire(), vpFlyCaptureGrabber::acquire(), vpPylonGrabberGigE::acquire(), vpPylonGrabberGigE::acquire(), vpPylonGrabberUsb::acquire(), vpPylonGrabberUsb::acquire(), vpV4l2Grabber::acquire(), vpV4l2Grabber::acquire(), vp1394TwoGrabber::dequeue(), vp1394TwoGrabber::dequeue(), vpDirectShowGrabber::getFormat(), vpVideoReader::getFrame(), vpVideoReader::getFrame(), vp1394TwoGrabber::getWidth(), vp1394TwoGrabber::getWidth(), getWidth(), vp1394CMUGrabber::open(), vp1394CMUGrabber::open(), vpDiskGrabber::open(), vpDiskGrabber::open(), vpDiskGrabber::open(), vpV4l2Grabber::open(), vpV4l2Grabber::open(), vpDirectShowGrabber::setFormat(), vp1394TwoGrabber::setFormat7ROI(), vpDirectShowGrabber::setImageSize(), vp1394CMUGrabber::setVideoMode(), vp1394TwoGrabber::setVideoMode(), vpV4l2Grabber::setWidth(), vp1394CMUGrabber::vp1394CMUGrabber(), vp1394TwoGrabber::vp1394TwoGrabber(), and vpFrameGrabber().