Control interface for frame grabber devices. More...

#include <yarp/dev/IFrameGrabberControls.h>

Inheritance diagram for yarp::dev::IFrameGrabberControls:

Public Member Functions
virtual	~IFrameGrabberControls ()
	Destructor.

std::string	busType2String (BusType type)

FeatureMode	toFeatureMode (bool _auto)

virtual yarp::dev::ReturnValue	getCameraDescription (CameraDescriptor &camera)=0
	Get a basic description of the camera hw.

virtual yarp::dev::ReturnValue	hasFeature (cameraFeature_id_t, bool &hasFeature)=0
	Check if camera has the requested feature (saturation, brightness ... )

virtual yarp::dev::ReturnValue	setFeature (cameraFeature_id_t feature, double value)=0
	Set the requested feature to a value (saturation, brightness ... )

virtual yarp::dev::ReturnValue	getFeature (cameraFeature_id_t feature, double &value)=0
	Get the current value for the requested feature.

virtual yarp::dev::ReturnValue	setFeature (cameraFeature_id_t feature, double value1, double value2)=0
	Set the requested feature to a value using 2 params (like white balance)

virtual yarp::dev::ReturnValue	getFeature (cameraFeature_id_t feature, double &value1, double &value2)=0
	Get the current value for the requested feature.

virtual yarp::dev::ReturnValue	hasOnOff (cameraFeature_id_t feature, bool &HasOnOff)=0
	Check if the camera has the ability to turn on/off the requested feature.

virtual yarp::dev::ReturnValue	setActive (cameraFeature_id_t feature, bool onoff)=0
	Set the requested feature on or off.

virtual yarp::dev::ReturnValue	getActive (cameraFeature_id_t feature, bool &isActive)=0
	Get the current status of the feature, on or off.

virtual yarp::dev::ReturnValue	hasAuto (cameraFeature_id_t feature, bool &hasAuto)=0
	Check if the requested feature has the 'auto' mode.

virtual yarp::dev::ReturnValue	hasManual (cameraFeature_id_t feature, bool &hasManual)=0
	Check if the requested feature has the 'manual' mode.

virtual yarp::dev::ReturnValue	hasOnePush (cameraFeature_id_t feature, bool &hasOnePush)=0
	Check if the requested feature has the 'onePush' mode.

virtual yarp::dev::ReturnValue	setMode (cameraFeature_id_t feature, FeatureMode mode)=0
	Set the requested mode for the feature.

virtual yarp::dev::ReturnValue	getMode (cameraFeature_id_t feature, FeatureMode &mode)=0
	Get the current mode for the feature.

virtual yarp::dev::ReturnValue	setOnePush (cameraFeature_id_t feature)=0
	Set the requested feature to a value (saturation, brightness ... )

Detailed Description

Control interface for frame grabber devices.

Definition at line 71 of file IFrameGrabberControls.h.

Constructor & Destructor Documentation

◆ ~IFrameGrabberControls()

yarp::dev::IFrameGrabberControls::~IFrameGrabberControls ( )

virtualdefault

Destructor.

Member Function Documentation

◆ busType2String()

std::string yarp::dev::IFrameGrabberControls::busType2String ( BusType type )

inline

Definition at line 79 of file IFrameGrabberControls.h.

◆ getActive()

virtual yarp::dev::ReturnValue yarp::dev::IFrameGrabberControls::getActive	(	cameraFeature_id_t	feature,
		bool &	isActive
	)

pure virtual

Get the current status of the feature, on or off.

Parameters

feature	the identifier of the feature to check
isActive	flag true if the feature is active, false otherwise

Returns: returns true if success, false otherwise (e.g. the interface is not implemented)

Implemented in FakeDepthCameraDriver, FakeFrameGrabber, FrameGrabberCropper, FrameGrabber_nwc_yarp, RGBDSensor_nwc_yarp, USBCameraDriver, and V4L_camera.

◆ getCameraDescription()

virtual yarp::dev::ReturnValue yarp::dev::IFrameGrabberControls::getCameraDescription ( CameraDescriptor & camera )

pure virtual

Get a basic description of the camera hw.

This is mainly used to determine the HW bus type in order to choose the corresponding interface for advanced controls.

Parameters

device returns an identifier for the bus

Returns: returns true if success, false otherwise (e.g. the interface is not implemented)

Implemented in FakeDepthCameraDriver, FakeFrameGrabber, FrameGrabberCropper, FrameGrabber_nwc_yarp, RGBDSensor_nwc_yarp, USBCameraDriver, and V4L_camera.

◆ getFeature() [1/2]

virtual yarp::dev::ReturnValue yarp::dev::IFrameGrabberControls::getFeature	(	cameraFeature_id_t	feature,
		double &	value
	)

pure virtual

Get the current value for the requested feature.

Parameters

feature	the identifier of the feature to read
value	pointer to current value of the feature, from 0 to 1 expressed as a percentage

Returns: returns true on success, false on failure.

Implemented in FakeDepthCameraDriver, FakeFrameGrabber, FrameGrabberCropper, FrameGrabber_nwc_yarp, RGBDSensor_nwc_yarp, USBCameraDriver, and V4L_camera.

◆ getFeature() [2/2]

virtual yarp::dev::ReturnValue yarp::dev::IFrameGrabberControls::getFeature	(	cameraFeature_id_t	feature,
		double &	value1,
		double &	value2
	)

pure virtual

Get the current value for the requested feature.

Parameters

feature	the identifier of the feature to read
value1	returns the current value of the feature, from 0 to 1 expressed as a percentage
value2	returns the current value of the feature, from 0 to 1 expressed as a percentage

Returns: returns true on success, false on failure.

Implemented in FakeDepthCameraDriver, FakeFrameGrabber, FrameGrabberCropper, FrameGrabber_nwc_yarp, RGBDSensor_nwc_yarp, USBCameraDriver, and V4L_camera.

◆ getMode()

virtual yarp::dev::ReturnValue yarp::dev::IFrameGrabberControls::getMode	(	cameraFeature_id_t	feature,
		FeatureMode &	mode
	)

pure virtual

Get the current mode for the feature.

Parameters

feature	the identifier of the feature to change
hasAuto	flag true if the feature is has 'auto' mode, false otherwise

Returns: returns true if success, false otherwise (e.g. the interface is not implemented)

Implemented in FakeDepthCameraDriver, FakeFrameGrabber, FrameGrabberCropper, FrameGrabber_nwc_yarp, RGBDSensor_nwc_yarp, USBCameraDriver, and V4L_camera.

◆ hasAuto()

virtual yarp::dev::ReturnValue yarp::dev::IFrameGrabberControls::hasAuto	(	cameraFeature_id_t	feature,
		bool &	hasAuto
	)

pure virtual

Check if the requested feature has the 'auto' mode.

Parameters

feature	the identifier of the feature to check
hasAuto	flag true if the feature is has 'auto' mode, false otherwise

Returns: returns true if success, false otherwise (e.g. the interface is not implemented)

Implemented in FakeDepthCameraDriver, FakeFrameGrabber, FrameGrabberCropper, FrameGrabber_nwc_yarp, RGBDSensor_nwc_yarp, USBCameraDriver, and V4L_camera.

◆ hasFeature()

virtual yarp::dev::ReturnValue yarp::dev::IFrameGrabberControls::hasFeature	(	cameraFeature_id_t	,
		bool &	hasFeature
	)

pure virtual

Check if camera has the requested feature (saturation, brightness ... )

Parameters

feature	the identifier of the feature to check
hasFeature	flag value: true if the feature is present, false otherwise

Returns: returns true if success, false otherwise (e.g. the interface is not implemented)

Implemented in FakeDepthCameraDriver, FakeFrameGrabber, FrameGrabberCropper, FrameGrabber_nwc_yarp, RGBDSensor_nwc_yarp, USBCameraDriver, and V4L_camera.

◆ hasManual()

virtual yarp::dev::ReturnValue yarp::dev::IFrameGrabberControls::hasManual	(	cameraFeature_id_t	feature,
		bool &	hasManual
	)

pure virtual

Check if the requested feature has the 'manual' mode.

Parameters

feature	the identifier of the feature to check
hasAuto	flag true if the feature is has 'manual' mode, false otherwise

Returns: returns true if success, false otherwise (e.g. the interface is not implemented)

Implemented in FakeDepthCameraDriver, FakeFrameGrabber, FrameGrabberCropper, FrameGrabber_nwc_yarp, RGBDSensor_nwc_yarp, USBCameraDriver, and V4L_camera.

◆ hasOnePush()

virtual yarp::dev::ReturnValue yarp::dev::IFrameGrabberControls::hasOnePush	(	cameraFeature_id_t	feature,
		bool &	hasOnePush
	)

pure virtual

Check if the requested feature has the 'onePush' mode.

Parameters

feature	the identifier of the feature to check
hasAuto	flag true if the feature is has 'onePush' mode, false otherwise

Returns: returns true if success, false otherwise (e.g. the interface is not implemented)

Implemented in FakeDepthCameraDriver, FakeFrameGrabber, FrameGrabberCropper, FrameGrabber_nwc_yarp, RGBDSensor_nwc_yarp, USBCameraDriver, and V4L_camera.

◆ hasOnOff()

virtual yarp::dev::ReturnValue yarp::dev::IFrameGrabberControls::hasOnOff	(	cameraFeature_id_t	feature,
		bool &	HasOnOff
	)

pure virtual

Check if the camera has the ability to turn on/off the requested feature.

Parameters

feature	the identifier of the feature to change
hasOnOff	flag true if this feature can be turned on/off, false otherwise.

Returns: returns true if success, false otherwise (e.g. the interface is not implemented)

Implemented in FakeDepthCameraDriver, FakeFrameGrabber, FrameGrabberCropper, FrameGrabber_nwc_yarp, RGBDSensor_nwc_yarp, USBCameraDriver, and V4L_camera.

◆ setActive()

virtual yarp::dev::ReturnValue yarp::dev::IFrameGrabberControls::setActive	(	cameraFeature_id_t	feature,
		bool	onoff
	)

pure virtual

Set the requested feature on or off.

Parameters

feature	the identifier of the feature to change
onoff	true to activate, off to deactivate the feature

Returns: returns true on success, false on failure.

Implemented in FakeDepthCameraDriver, FakeFrameGrabber, FrameGrabberCropper, FrameGrabber_nwc_yarp, RGBDSensor_nwc_yarp, USBCameraDriver, and V4L_camera.

◆ setFeature() [1/2]

virtual yarp::dev::ReturnValue yarp::dev::IFrameGrabberControls::setFeature	(	cameraFeature_id_t	feature,
		double	value
	)

pure virtual

Set the requested feature to a value (saturation, brightness ... )

Parameters

feature	the identifier of the feature to change
value	new value of the feature, range from 0 to 1 expressed as a percentage

Returns: returns true if success, false otherwise (e.g. the interface is not implemented)

Implemented in FakeDepthCameraDriver, FakeFrameGrabber, FrameGrabberCropper, FrameGrabber_nwc_yarp, RGBDSensor_nwc_yarp, USBCameraDriver, and V4L_camera.

◆ setFeature() [2/2]

virtual yarp::dev::ReturnValue yarp::dev::IFrameGrabberControls::setFeature	(	cameraFeature_id_t	feature,
		double	value1,
		double	value2
	)

pure virtual

Set the requested feature to a value using 2 params (like white balance)

Parameters

feature	the identifier of the feature to change
value1	first param, from 0 to 1 expressed as a percentage
value2	second param, from 0 to 1 expressed as a percentage

Returns: returns true if success, false otherwise (e.g. the interface is not implemented)

Implemented in FakeDepthCameraDriver, FakeFrameGrabber, FrameGrabberCropper, FrameGrabber_nwc_yarp, RGBDSensor_nwc_yarp, USBCameraDriver, and V4L_camera.

◆ setMode()

virtual yarp::dev::ReturnValue yarp::dev::IFrameGrabberControls::setMode	(	cameraFeature_id_t	feature,
		FeatureMode	mode
	)

pure virtual

Set the requested mode for the feature.

Parameters

feature	the identifier of the feature to change
auto_onoff	true to activate 'auto' mode, false to activate 'manual' mode

Returns: returns true on success, false on failure.

Implemented in FakeDepthCameraDriver, FakeFrameGrabber, FrameGrabberCropper, FrameGrabber_nwc_yarp, RGBDSensor_nwc_yarp, USBCameraDriver, and V4L_camera.

◆ setOnePush()

virtual yarp::dev::ReturnValue yarp::dev::IFrameGrabberControls::setOnePush ( cameraFeature_id_t feature )

pure virtual

Set the requested feature to a value (saturation, brightness ... )

Parameters

feature	the identifier of the feature to change
value	new value of the feature, from 0 to 1 as a percentage of param range

Returns: returns true on success, false on failure.

Implemented in FakeDepthCameraDriver, FakeFrameGrabber, FrameGrabberCropper, FrameGrabber_nwc_yarp, RGBDSensor_nwc_yarp, USBCameraDriver, and V4L_camera.

◆ toFeatureMode()

FeatureMode yarp::dev::IFrameGrabberControls::toFeatureMode ( bool _auto )

inline

Definition at line 96 of file IFrameGrabberControls.h.

The documentation for this class was generated from the following files:

src/libYARP_dev/src/yarp/dev/IFrameGrabberControls.h
src/libYARP_dev/src/yarp/dev/IFrameGrabberControls.cpp

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ ~IFrameGrabberControls()

Member Function Documentation

◆ busType2String()

◆ getActive()

◆ getCameraDescription()

◆ getFeature() [1/2]

◆ getFeature() [2/2]

◆ getMode()

◆ hasAuto()

◆ hasFeature()

◆ hasManual()

◆ hasOnePush()

◆ hasOnOff()

◆ setActive()

◆ setFeature() [1/2]

◆ setFeature() [2/2]

◆ setMode()

◆ setOnePush()

◆ toFeatureMode()