vpPylonGrabberUsb Class Reference

#include "vpPylonGrabberUsb.h"

Inheritance diagram for vpPylonGrabberUsb:

Public Types
enum	UserSetName {   USERSET_DEFAULT, USERSET_USERSET1, USERSET_USERSET2, USERSET_USERSET3,   USERSET_UNKNOWN }

Public Member Functions
	vpPylonGrabberUsb ()
virtual	~vpPylonGrabberUsb ()
void	acquire (vpImage< unsigned char > &I)
void	acquire (vpImage< vpRGBa > &I)
void	close ()
void	connect ()
void	disconnect ()
float	getBlackLevel ()
std::ostream &	getCameraInfo (std::ostream &os)
Pylon::CInstantCamera *	getCameraHandler ()
unsigned int	getCameraIndex () const
std::string	getCameraSerial (unsigned int index)
float	getExposure ()
float	getFrameRate ()
float	getGain ()
unsigned int	getNumCameras ()
float	getGamma ()
bool	loadUserSet (UserSetName user_set)
UserSetName	getUserSetDefault ()
bool	isConnected () const
bool	isCaptureStarted () const
void	open (vpImage< unsigned char > &I)
void	open (vpImage< vpRGBa > &I)
vpPylonGrabber &	operator>> (vpImage< unsigned char > &I)
vpPylonGrabber &	operator>> (vpImage< vpRGBa > &I)
float	setBlackLevel (float blacklevel_value=0)
void	setCameraIndex (unsigned int index)
void	setCameraSerial (const std::string &serial)
float	setExposure (bool exposure_on, bool exposure_auto, float exposure_value=0)
float	setGain (bool gain_auto, float gain_value=0)
float	setFrameRate (float frame_rate)
float	setGamma (bool gamma_on, float gamma_value=1)
bool	saveUserSet (UserSetName user_set, bool set_default=false)
bool	setUserSetDefault (UserSetName user_set)
void	startCapture ()
void	stopCapture ()
Inherited functionalities from vpFramegrabber
unsigned int	getHeight () const
unsigned int	getWidth () const

Public Attributes
bool	init

Protected Member Functions
void	open ()
bool	selectUserSet (UserSetName user_set)

Protected Attributes
unsigned int	height
unsigned int	width

Detailed Description

Allows to grab images from a Basler USB camera using Pylon SDK.

This class should not be instantiated directly. Use vpPylonFactory::createPylonGrabber() instead.

Definition at line 65 of file vpPylonGrabberUsb.h.

Member Enumeration Documentation

UserSetName

enum vpPylonGrabber::UserSetName

inherited

Valid values for user set names.

Enumerator
USERSET_DEFAULT	The default user set.
USERSET_USERSET1	User set 1.
USERSET_USERSET2	User set 2.
USERSET_USERSET3	User set 3.
USERSET_UNKNOWN	User set not supported.

Definition at line 106 of file vpPylonGrabber.h.

Constructor & Destructor Documentation

vpPylonGrabberUsb()

vpPylonGrabberUsb::vpPylonGrabberUsb

(

)

Default constructor that consider the first camera found on the bus as active.

Definition at line 55 of file vpPylonGrabberUsb.cpp.

References getNumCameras().

~vpPylonGrabberUsb()

vpPylonGrabberUsb::~vpPylonGrabberUsb ( )

virtual

Default destructor that closes the connection with the camera.

Definition at line 63 of file vpPylonGrabberUsb.cpp.

References close().

Member Function Documentation

acquire() [1/2]

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

virtual

Acquire a gray level image from the active camera.

Parameters

I	: Image data structure (8 bits image).

Implements vpPylonGrabber.

Definition at line 636 of file vpPylonGrabberUsb.cpp.

References vpImage< Type >::bitmap, vpException::fatalError, getCameraSerial(), vpFrameGrabber::height, open(), vpImage< Type >::resize(), and vpFrameGrabber::width.

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

acquire() [2/2]

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

virtual

Acquire a color image from the active camera.

Parameters

I	: Image data structure (RGBa image).

Implements vpPylonGrabber.

Definition at line 665 of file vpPylonGrabberUsb.cpp.

References vpException::fatalError, getCameraSerial(), vpFrameGrabber::height, open(), vpImage< Type >::resize(), and vpFrameGrabber::width.

close()

void vpPylonGrabberUsb::close ( )

virtual

Stop active camera capturing images and disconnect the active camera.

If you want to use again this camera, you may call setCameraIndex(const unsigned int &) and open(vpImage<unsigned char> &) or open(vpImage<vpRGBa> &) to connect again the camera.

Implements vpPylonGrabber.

Definition at line 625 of file vpPylonGrabberUsb.cpp.

References disconnect(), and stopCapture().

Referenced by ~vpPylonGrabberUsb().

connect()

void vpPylonGrabberUsb::connect ( )

virtual

Connect the active camera.

See also

disconnect()

Implements vpPylonGrabber.

Definition at line 572 of file vpPylonGrabberUsb.cpp.

References vpException::fatalError, getNumCameras(), and vpFrameGrabber::init.

Referenced by getBlackLevel(), getCameraHandler(), getCameraInfo(), getExposure(), getFrameRate(), getGain(), getGamma(), getUserSetDefault(), loadUserSet(), open(), saveUserSet(), selectUserSet(), setBlackLevel(), setExposure(), setFrameRate(), setGain(), setGamma(), setUserSetDefault(), and startCapture().

disconnect()

void vpPylonGrabberUsb::disconnect ( )

virtual

Disconnect the active camera.

See also

connect()

Implements vpPylonGrabber.

Definition at line 605 of file vpPylonGrabberUsb.cpp.

References vpFrameGrabber::init.

Referenced by close().

getBlackLevel()

float vpPylonGrabberUsb::getBlackLevel ( )

virtual

Return blacklevel value in % or raw value. If the camera doesn't support blacklevel property, return an exception.

According to SFNC (standard feature naming convention) of GenICam standard, Black level is used instead of brightness.

See "Terminology Changes" section of the page: https://www.ptgrey.com/kb/11020?countryid=237

See also

setBlackLevel()

Implements vpPylonGrabber.

Definition at line 165 of file vpPylonGrabberUsb.cpp.

References connect(), and vpException::notImplementedError.

getCameraHandler()

Pylon::CInstantCamera * vpPylonGrabberUsb::getCameraHandler ( )

virtual

Return the handler to the active camera or NULL if the camera is not connected. This function was designed to provide a direct access to the Pylon SDK to get access to advanced functionalities that are not implemented in this class.

Implements vpPylonGrabber.

Definition at line 113 of file vpPylonGrabberUsb.cpp.

References connect().

getCameraIndex()

unsigned int vpPylonGrabberUsb::getCameraIndex ( ) const

inlinevirtual

Return the index of the active camera.

Implements vpPylonGrabber.

Definition at line 82 of file vpPylonGrabberUsb.h.

References vpPylonGrabber::getCameraSerial(), vpPylonGrabber::getExposure(), vpPylonGrabber::getFrameRate(), vpPylonGrabber::getGain(), vpPylonGrabber::getGamma(), vpPylonGrabber::getNumCameras(), vpPylonGrabber::getUserSetDefault(), and vpPylonGrabber::loadUserSet().

getCameraInfo()

std::ostream & vpPylonGrabberUsb::getCameraInfo ( std::ostream &  os )

virtual

Print to the output stream active camera information (serial number, camera model, camera vendor, sensor, resolution, firmware version, ...).

Implements vpPylonGrabber.

Definition at line 86 of file vpPylonGrabberUsb.cpp.

References connect().

getCameraSerial()

std::string vpPylonGrabberUsb::getCameraSerial ( unsigned int  index )

virtual

Return the serial id of a camera with index.

Parameters

index

: Camera index.

See also

setCameraSerial()

Implements vpPylonGrabber.

Definition at line 216 of file vpPylonGrabberUsb.cpp.

References vpException::badValue, and getNumCameras().

Referenced by acquire(), and setCameraSerial().

getExposure()

float vpPylonGrabberUsb::getExposure ( )

virtual

Return exposure value in ms. If the camera doesn't support exposure property, return an exception.

According to SFNC (standard feature naming convention) of GenICam standard, Exposure is used and deprecates shutter.

See "Terminology Changes" section of the page: https://www.ptgrey.com/kb/11020?countryid=237

See also

setExposure()

Implements vpPylonGrabber.

Definition at line 186 of file vpPylonGrabberUsb.cpp.

References connect(), and vpException::notImplementedError.

getFrameRate()

float vpPylonGrabberUsb::getFrameRate ( )

virtual

Return camera capture framerate. If the camera doesn't support framerate property, return an exception.

See also

setFrameRate()

Implements vpPylonGrabber.

Definition at line 130 of file vpPylonGrabberUsb.cpp.

References connect().

getGain()

float vpPylonGrabberUsb::getGain ( )

virtual

Return camera gain value in dB or raw value. If the camera doesn't support gain property, return an exception.

See also

setGain()

Implements vpPylonGrabber.

Definition at line 144 of file vpPylonGrabberUsb.cpp.

References connect(), and vpException::notImplementedError.

getGamma()

float vpPylonGrabberUsb::getGamma ( )

virtual

Return gamma correction value. If the camera doesn't support gamma property, return an exception.

See also

setGamma()

Implements vpPylonGrabber.

Definition at line 202 of file vpPylonGrabberUsb.cpp.

References connect().

getHeight()

unsigned int vpFrameGrabber::getHeight ( ) const

inlineinherited

Return the number of rows in the image.

Examples:

AROgre.cpp, AROgreBasic.cpp, and testPylonGrabber.cpp.

Definition at line 114 of file vpFrameGrabber.h.

getNumCameras()

unsigned int vpPylonGrabberUsb::getNumCameras ( )

virtual

Returns

Return the number of cameras connected on the bus.

Implements vpPylonGrabber.

Definition at line 68 of file vpPylonGrabberUsb.cpp.

Referenced by connect(), getCameraSerial(), setCameraSerial(), and vpPylonGrabberUsb().

getUserSetDefault()

vpPylonGrabber::UserSetName vpPylonGrabberUsb::getUserSetDefault ( )

virtual

Gets the configuration set being used as the default startup set.

See also

setUserSetDefault()

Implements vpPylonGrabber.

Definition at line 267 of file vpPylonGrabberUsb.cpp.

References connect(), vpPylonGrabber::USERSET_DEFAULT, vpPylonGrabber::USERSET_UNKNOWN, vpPylonGrabber::USERSET_USERSET1, vpPylonGrabber::USERSET_USERSET2, and vpPylonGrabber::USERSET_USERSET3.

getWidth()

unsigned int vpFrameGrabber::getWidth ( ) const

inlineinherited

Return the number of columns in the image.

Examples:

AROgre.cpp, AROgreBasic.cpp, and testPylonGrabber.cpp.

Definition at line 116 of file vpFrameGrabber.h.

isCaptureStarted()

bool vpPylonGrabberUsb::isCaptureStarted ( ) const

inlinevirtual

Return true if the camera capture is started.

Implements vpPylonGrabber.

Definition at line 95 of file vpPylonGrabberUsb.h.

References vpPylonGrabber::open(), vpPylonGrabber::operator>>(), vpPylonGrabber::saveUserSet(), vpPylonGrabber::setBlackLevel(), vpPylonGrabber::setCameraIndex(), vpPylonGrabber::setCameraSerial(), vpPylonGrabber::setExposure(), vpPylonGrabber::setFrameRate(), vpPylonGrabber::setGain(), vpPylonGrabber::setGamma(), vpPylonGrabber::setUserSetDefault(), vpPylonGrabber::startCapture(), and vpPylonGrabber::stopCapture().

isConnected()

bool vpPylonGrabberUsb::isConnected ( ) const

inlinevirtual

Return true if the camera is connected.

Implements vpPylonGrabber.

Definition at line 93 of file vpPylonGrabberUsb.h.

loadUserSet()

bool vpPylonGrabberUsb::loadUserSet ( UserSetName  user_set )

virtual

Loads the selected configuration into the camera's volatile memory and makes it the active configuration set.

Parameters

user_set

See vpPylonGrabber::UserSetName for valid values.

Returns

true for finished, false otherwise.

See also

saveUserSet()

Implements vpPylonGrabber.

Definition at line 246 of file vpPylonGrabberUsb.cpp.

References connect(), selectUserSet(), and vpTime::wait().

open() [1/3]

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

virtual

Connect to the active camera, start capture and retrieve an image.

Parameters

I	: Captured image.

Implements vpPylonGrabber.

Definition at line 704 of file vpPylonGrabberUsb.cpp.

References acquire(), and open().

open() [2/3]

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

virtual

Connect to the active camera, start capture and retrieve an image.

Parameters

I	: Captured image.

Implements vpPylonGrabber.

Definition at line 714 of file vpPylonGrabberUsb.cpp.

References acquire(), and open().

open() [3/3]

void vpPylonGrabberUsb::open ( )

protected

Connect to the active camera and start capture.

Similar then calling:

vpPylonGrabberUsb g;
...
g.connect();
g.startCapture();

Definition at line 731 of file vpPylonGrabberUsb.cpp.

References connect(), and startCapture().

Referenced by acquire(), and open().

operator>>() [1/2]

vpPylonGrabber & vpPylonGrabberUsb::operator>> ( vpImage< unsigned char > &  I )

virtual

Operator that allows to capture a grey level image.

Parameters

I	: The captured image.

Implements vpPylonGrabber.

Definition at line 775 of file vpPylonGrabberUsb.cpp.

References acquire().

operator>>() [2/2]

vpPylonGrabber & vpPylonGrabberUsb::operator>> ( vpImage< vpRGBa > &  I )

virtual

Operator that allows to capture a color image.

Parameters

I	: The captured image.

Implements vpPylonGrabber.

Definition at line 785 of file vpPylonGrabberUsb.cpp.

References acquire().

saveUserSet()

bool vpPylonGrabberUsb::saveUserSet ( UserSetName  user_set, bool  set_default = false  )

virtual

Saves the current active configuration set into the selected user set.

Parameters

user_set	See vpPylonGrabber::UserSetName for valid values.
set_default	Whether to set the configuration set to be used as the default startup set.

Returns

true for finished, false otherwise.

See also

loadUserSet()

Implements vpPylonGrabber.

Definition at line 480 of file vpPylonGrabberUsb.cpp.

References connect(), selectUserSet(), setUserSetDefault(), and vpTime::wait().

selectUserSet()

bool vpPylonGrabberUsb::selectUserSet ( UserSetName  user_set )

protected

Selects the configuration set to load, save, or configure.

Parameters

user_set

See vpPylonGrabber::UserSetName for valid values.

Returns

true for success, false for failure.

Default User Set is read-only and cannot be modified.

Definition at line 745 of file vpPylonGrabberUsb.cpp.

References connect(), vpPylonGrabber::USERSET_DEFAULT, vpPylonGrabber::USERSET_USERSET1, vpPylonGrabber::USERSET_USERSET2, and vpPylonGrabber::USERSET_USERSET3.

Referenced by loadUserSet(), and saveUserSet().

setBlackLevel()

float vpPylonGrabberUsb::setBlackLevel ( float  blacklevel_value = 0 )

virtual

Set camera blacklevel mode and parameter.

Parameters

blacklevel_value

: This is the level of black in an image. A high blacklevel will result in a low amount of black in the image.

Returns

The measured blacklevel after applying the new setting.

According to SFNC (standard feature naming convention) of GenICam standard, Black level is used instead of brightness.

See "Terminology Changes" section of the page: https://www.ptgrey.com/kb/11020?countryid=237

See also

getBlackLevel()

Implements vpPylonGrabber.

Definition at line 394 of file vpPylonGrabberUsb.cpp.

References connect(), and vpException::notImplementedError.

setCameraIndex()

void vpPylonGrabberUsb::setCameraIndex ( unsigned int  index )

virtual

If multiples cameras are connected on the bus, select the camera to dial with.

Parameters

index

: Current camera index, a value comprised between 0 (the first camera found on the bus) and the number of cameras found and returned by getNumCameras() minus 1.

If two cameras are connected on the bus, setting index to one allows to communicate with the second one. This identifier is not unique. That is why, it is also possible to select a camera by its serial number, which is unique using setCameraSerial().

Exceptions

vpException::badValue

: If the index is greater or equal to the number of cameras connected to the bus.

Implements vpPylonGrabber.

Definition at line 307 of file vpPylonGrabberUsb.cpp.

References vpException::badValue.

setCameraSerial()

void vpPylonGrabberUsb::setCameraSerial ( const std::string &  serial )

virtual

Set the current camera from its unique serial identifier.

Parameters

serial

: Camera serial string.

See also

getCameraSerial()

Implements vpPylonGrabber.

Definition at line 323 of file vpPylonGrabberUsb.cpp.

References vpException::badValue, getCameraSerial(), and getNumCameras().

setExposure()

float vpPylonGrabberUsb::setExposure ( bool  exposure_on, bool  exposure_auto, float  exposure_value = 0  )

virtual

Set camera exposure mode and parameter.

Parameters

exposure_on	: If true turn exposure on, otherwise turn off.
exposure_auto	: If true set auto exposure, if false set manual exposure applying exposure_value parameter.
exposure_value	: This is the exposure value in ms.

Returns

The measured exposure time in ms after applying the new setting.

According to SFNC (standard feature naming convention) of GenICam standard, Exposure is used and deprecates shutter.

See "Terminology Changes" section of the page: https://www.ptgrey.com/kb/11020?countryid=237

See also

getExposure()

Implements vpPylonGrabber.

Definition at line 422 of file vpPylonGrabberUsb.cpp.

References connect(), and vpException::notImplementedError.

setFrameRate()

float vpPylonGrabberUsb::setFrameRate ( float  frame_rate )

virtual

Set camera frame rate.

Parameters

frame_rate

: Camera frame rate (fps) to set.

Returns

The camera current framerate.

See also

getFramerate()

Implements vpPylonGrabber.

Definition at line 342 of file vpPylonGrabberUsb.cpp.

References connect().

setGain()

float vpPylonGrabberUsb::setGain ( bool  gain_auto, float  gain_value = 0  )

virtual

Set camera gain mode and value.

Parameters

gain_auto	: If true set auto gain, if false set manual gain applying gain_value parameter.
gain_value	: The amount of amplification that is applied to a pixel in manual mode. An increase in gain can result in an increase in noise.

Returns

The measured gain after applying the new setting.

See also

getGain()

Implements vpPylonGrabber.

Definition at line 364 of file vpPylonGrabberUsb.cpp.

References connect(), and vpException::notImplementedError.

setGamma()

float vpPylonGrabberUsb::setGamma ( bool  gamma_on, float  gamma_value = 1  )

virtual

Set camera gamma correction mode and parameter.

Parameters

gamma_on	: If true turn gamma correction on, otherwise turn off.
gamma_value	: Parameter used to perform gamma correction of pixel intensity.

Returns

The measured gamma correction value after applying the new setting.

See also

getGamma()

Implements vpPylonGrabber.

Definition at line 455 of file vpPylonGrabberUsb.cpp.

References connect(), and vpException::notImplementedError.

setUserSetDefault()

bool vpPylonGrabberUsb::setUserSetDefault ( UserSetName  user_set )

virtual

Sets the configuration set to be used as the default startup set.

Parameters

user_set

See vpPylonGrabber::UserSetName for valid values.

Returns

true for finished, false otherwise.

See also

getUserSetDefault()

Implements vpPylonGrabber.

Definition at line 507 of file vpPylonGrabberUsb.cpp.

References connect(), vpPylonGrabber::USERSET_DEFAULT, vpPylonGrabber::USERSET_USERSET1, vpPylonGrabber::USERSET_USERSET2, and vpPylonGrabber::USERSET_USERSET3.

Referenced by saveUserSet().

startCapture()

void vpPylonGrabberUsb::startCapture ( )

virtual

Start active camera capturing images.

See also

stopCapture()

Implements vpPylonGrabber.

Definition at line 538 of file vpPylonGrabberUsb.cpp.

References connect(), and vpFrameGrabber::init.

Referenced by open().

stopCapture()

void vpPylonGrabberUsb::stopCapture ( )

virtual

Stop active camera capturing images.

See also

startCapture()

Implements vpPylonGrabber.

Definition at line 556 of file vpPylonGrabberUsb.cpp.

References vpFrameGrabber::init.

Referenced by close().

Member Data Documentation

height

unsigned int vpFrameGrabber::height

protectedinherited

Number of rows in the image.

Definition at line 107 of file vpFrameGrabber.h.

Referenced by vpPylonGrabberGigE::acquire(), acquire(), vpDiskGrabber::acquire(), vpFlyCaptureGrabber::acquire(), vpV4l2Grabber::acquire(), vp1394TwoGrabber::acquire(), vpV4l2Grabber::close(), vp1394TwoGrabber::dequeue(), vpVideoReader::getFrame(), vp1394TwoGrabber::getHeight(), vpDiskGrabber::open(), vpV4l2Grabber::open(), vp1394CMUGrabber::open(), vp1394CMUGrabber::selectCamera(), vpVideoReader::setFileName(), vp1394TwoGrabber::setFormat7ROI(), vp1394CMUGrabber::setVideoMode(), vp1394TwoGrabber::setVideoMode(), vp1394CMUGrabber::vp1394CMUGrabber(), and vp1394TwoGrabber::vp1394TwoGrabber().

init

bool vpFrameGrabber::init

inherited

Set to true if the frame grabber has been initialized.

Definition at line 104 of file vpFrameGrabber.h.

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

width

unsigned int vpFrameGrabber::width

protectedinherited

Number of columns in the image.

Definition at line 108 of file vpFrameGrabber.h.

Referenced by vpPylonGrabberGigE::acquire(), acquire(), vpDiskGrabber::acquire(), vpFlyCaptureGrabber::acquire(), vpV4l2Grabber::acquire(), vp1394TwoGrabber::acquire(), vpV4l2Grabber::close(), vp1394TwoGrabber::dequeue(), vpVideoReader::getFrame(), vp1394TwoGrabber::getWidth(), vpDiskGrabber::open(), vpV4l2Grabber::open(), vp1394CMUGrabber::open(), vp1394CMUGrabber::selectCamera(), vpVideoReader::setFileName(), vp1394TwoGrabber::setFormat7ROI(), vp1394CMUGrabber::setVideoMode(), vp1394TwoGrabber::setVideoMode(), vp1394CMUGrabber::vp1394CMUGrabber(), and vp1394TwoGrabber::vp1394TwoGrabber().