Detailed Description

A wrapper for Point Gray Research (PGR) FlyCapture2 API for capturing images from Firewire, USB3 or GigaE cameras and stereo cameras.

This class is only available when compiling MRPT with "MRPT_HAS_PGR_FLYCAPTURE2".

See also: See the most generic camera grabber in MRPT: mrpt::hwdrivers::CCameraSensor; See example code in [samples]/captureVideoFlyCapture2 and [samples]/captureVideoFlyCapture2_stereo.

Definition at line 181 of file CImageGrabber_FlyCapture2.h.

#include <mrpt/hwdrivers/CImageGrabber_FlyCapture2.h>

Public Member Functions
	CImageGrabber_FlyCapture2 ()
	Constructor that does not open a camera. More...

	CImageGrabber_FlyCapture2 (const CImageGrabber_FlyCapture2 &)=delete

CImageGrabber_FlyCapture2 &	operator= (const CImageGrabber_FlyCapture2 &)=delete

	CImageGrabber_FlyCapture2 (const TCaptureOptions_FlyCapture2 &options)
	Constructor: tries to open the camera with the given options. More...

virtual	~CImageGrabber_FlyCapture2 ()
	Destructor. More...

const TCaptureOptions_FlyCapture2 &	getCameraOptions () const
	Returns the current settings of the camera. More...

void	open (const TCaptureOptions_FlyCapture2 &options, const bool startCapture=true)
	Tries to open the camera with the given options, and starts capture. More...

void	startCapture ()
	Start the actual image capture of the camera. More...

void	stopCapture ()
	Stop capture. More...

void	close ()
	Stop capture and closes the opened camera, if any. More...

bool	getObservation (mrpt::obs::CObservationImage &out_observation)
	Grab mono image from the camera. More...

bool	getObservation (mrpt::obs::CObservationStereoImages &out_observation)
	Grab stereo image from the camera. More...

bool	isStereo ()
	Returns if current configuration is stereo or not. More...

Static Public Member Functions
static void	startSyncCapture (int numCameras, const CImageGrabber_FlyCapture2 **cameras_array)
	Starts a synchronous capture of several cameras, which must have been already opened. More...

static std::string	getFC2version ()
	Returns the PGR FlyCapture2 library version. More...

Protected Attributes
void *	m_camera {nullptr}
	Opaque pointer to the FlyCapture2::Camera object. More...

void *	m_camera_info {nullptr}
	Opaque pointer to the FlyCapture2::CameraInfo object. More...

void *	m_img_buffer {nullptr}
	Opaque pointer to the FlyCapture2::Image, used as a temporary buffer and to avoid mem alloc/reallocs. More...

void *	m_triclops {nullptr}
	Opaque pointer to the TriclopsContext objetc. More...

float	m_baseline
	Camera baseline (only for stereo cameras) More...

float	m_focalLength
	Camera focal length. More...

float	m_centerCol
	Camera center coordinates. More...

float	m_centerRow

TCaptureOptions_FlyCapture2	m_options
	Camera options. More...

Constructor & Destructor Documentation

◆ CImageGrabber_FlyCapture2() [1/3]

CImageGrabber_FlyCapture2::CImageGrabber_FlyCapture2 ( )

Constructor that does not open a camera.

Default constructor.

See also: open()

Definition at line 234 of file CImageGrabber_FlyCapture2.cpp.

References m_img_buffer.

◆ CImageGrabber_FlyCapture2() [2/3]

mrpt::hwdrivers::CImageGrabber_FlyCapture2::CImageGrabber_FlyCapture2 ( const CImageGrabber_FlyCapture2 & )

delete

◆ CImageGrabber_FlyCapture2() [3/3]

CImageGrabber_FlyCapture2::CImageGrabber_FlyCapture2 ( const TCaptureOptions_FlyCapture2 & options )

Constructor: tries to open the camera with the given options.

Constructor + open.

Raises an exception on error.

See also: open()

Definition at line 242 of file CImageGrabber_FlyCapture2.cpp.

References m_img_buffer, and open().

Here is the call graph for this function:

◆ ~CImageGrabber_FlyCapture2()

CImageGrabber_FlyCapture2::~CImageGrabber_FlyCapture2 ( )

virtual

Destructor.

Definition at line 256 of file CImageGrabber_FlyCapture2.cpp.

References close(), FC2_BUF_IMG, and m_img_buffer.

Here is the call graph for this function:

Member Function Documentation

◆ close()

void CImageGrabber_FlyCapture2::close ( )

Stop capture and closes the opened camera, if any.

Closes the opened camera, if any.

Called automatically on object destruction.

Definition at line 618 of file CImageGrabber_FlyCapture2.cpp.

References FC2_CAM, FC2_CAM_INFO, m_camera, m_camera_info, m_triclops, stopCapture(), THROW_EXCEPTION, and TRI_CONTEXT.

Referenced by open(), and ~CImageGrabber_FlyCapture2().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getCameraOptions()

const TCaptureOptions_FlyCapture2& mrpt::hwdrivers::CImageGrabber_FlyCapture2::getCameraOptions ( ) const

inline

Returns the current settings of the camera.

Definition at line 224 of file CImageGrabber_FlyCapture2.h.

References m_options.

◆ getFC2version()

std::string CImageGrabber_FlyCapture2::getFC2version ( )

static

Returns the PGR FlyCapture2 library version.

Definition at line 672 of file CImageGrabber_FlyCapture2.cpp.

References mrpt::format(), and THROW_EXCEPTION.

Referenced by open().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getObservation() [1/2]

bool CImageGrabber_FlyCapture2::getObservation ( mrpt::obs::CObservationImage & out_observation )

Grab mono image from the camera.

This method blocks until the next frame is captured.

Returns: false on any error.

Definition at line 691 of file CImageGrabber_FlyCapture2.cpp.

References CHECK_FC2_ERROR, mrpt::obs::gnss::error, FC2_BUF_IMG, FC2_CAM, mrpt::obs::CObservationImage::image, mrpt::img::CImage::loadFromMemoryBuffer(), m_camera, mrpt::system::now(), THROW_EXCEPTION, mrpt::system::time_tToTimestamp(), and mrpt::obs::CObservation::timestamp.

Here is the call graph for this function:

◆ getObservation() [2/2]

bool CImageGrabber_FlyCapture2::getObservation ( mrpt::obs::CObservationStereoImages & out_observation )

Grab stereo image from the camera.

This method blocks until the next frame is captured.

Returns: false on any error.

Definition at line 755 of file CImageGrabber_FlyCapture2.cpp.

References mrpt::obs::CObservationStereoImages::cameraPose, CHECK_FC2_ERROR, mrpt::img::DEEP_COPY, FC2_CAM, mrpt::obs::CObservationStereoImages::hasImageRight, mrpt::obs::CObservationStereoImages::imageLeft, mrpt::obs::CObservationStereoImages::imageRight, mrpt::obs::CObservationStereoImages::leftCamera, m_baseline, m_camera, m_centerCol, m_centerRow, m_focalLength, mrpt::system::now(), mrpt::poses::CPose3DQuat::quat(), mrpt::math::CQuaternion< T >::r(), mrpt::obs::CObservationStereoImages::rightCamera, mrpt::obs::CObservationStereoImages::rightCameraPose, mrpt::img::TCamera::setIntrinsicParamsFromValues(), THROW_EXCEPTION, mrpt::system::time_tToTimestamp(), mrpt::obs::CObservation::timestamp, mrpt::math::CQuaternion< T >::x(), mrpt::poses::CPoseOrPoint< DERIVEDCLASS, DIM >::x(), mrpt::math::CQuaternion< T >::y(), mrpt::poses::CPoseOrPoint< DERIVEDCLASS, DIM >::y(), and mrpt::math::CQuaternion< T >::z().

Here is the call graph for this function:

◆ isStereo()

bool mrpt::hwdrivers::CImageGrabber_FlyCapture2::isStereo ( )

inline

Returns if current configuration is stereo or not.

Definition at line 276 of file CImageGrabber_FlyCapture2.h.

References m_options, and mrpt::hwdrivers::TCaptureOptions_FlyCapture2::stereo_mode.

◆ open()

void CImageGrabber_FlyCapture2::open	(	const TCaptureOptions_FlyCapture2 &	options,
		const bool	startCapture = `true`
	)

Tries to open the camera with the given options, and starts capture.

Tries to open the camera with the given options.

Raises an exception on error.

Parameters

[in] startCapture If set to false, the camera is only opened and configured, but a posterior call to startCapture() is required to start grabbing images.