Ocean::IO::CameraCalibrationManager Class Reference

This class implements a camera calibration manager as singleton. More...

#include <CameraCalibrationManager.h>

Inheritance diagram for Ocean::IO::CameraCalibrationManager:

Data Structures
class	Device
	Device calibration object. More...

Public Types
enum	Priority { PRIORITY_LOW , PRIORITY_MEDIUM , PRIORITY_HIGH , PRIORITY_EXPLICIT }
	Definition of different priority values for the camera calibrations. More...
enum	Quality { QUALITY_EXACT , QUALITY_INTERPOLATED , QUALITY_DEFAULT }
	Definition of different calibration qualities. More...

Public Member Functions
bool	registerCalibration (const std::string &camera, const unsigned int width, const unsigned int height, const Scalar fovX)
	Registers a new camera calibration.
bool	registerCalibrationFile (const std::string &url)
	Registers a new camera calibration file.
bool	registerCalibration (const std::string &camera, const PinholeCamera &calibration)
	Registers a new camera calibration.
bool	registerAlias (const std::string &camera, const std::string &alias)
	Registers an alias camera name.
PinholeCamera	camera (const std::string &device, const unsigned int width, const unsigned int height, Quality *quality=nullptr, const Scalar defaultFovX=Numeric::deg2rad(45)) const
	Returns a calibration for a specific device with a specific frame resolution.
bool	hasCalibration (const std::string &device) const
	Returns whether this manager holds a valid camera profile for a specified device.

Protected Types
typedef std::map< std::string, Device >	DeviceMap
	Definition of a map mapping device names to device objects.
typedef std::map< std::string, std::string >	AliasMap
	Definition of a map mapping alias device names to device names.

Protected Member Functions
	CameraCalibrationManager ()
	Creates a new manager.
	~CameraCalibrationManager ()
	Destructs the manager.
Protected Member Functions inherited from Ocean::Singleton< CameraCalibrationManager >
	Singleton ()=default
	Default constructor.

Protected Attributes
DeviceMap	deviceMap_
	Map holding all registered devices.
AliasMap	aliasMap_
	Map holding alias names.
Lock	lock_
	The lock of this manager.

Friends
class	Singleton< CameraCalibrationManager >

Additional Inherited Members
Static Public Member Functions inherited from Ocean::Singleton< CameraCalibrationManager >
static CameraCalibrationManager &	get ()
	Returns a reference to the unique object.

Detailed Description

This class implements a camera calibration manager as singleton.

The manager organizes camera calibrations with different dimensions.

Member Typedef Documentation

AliasMap

typedef std::map<std::string, std::string> Ocean::IO::CameraCalibrationManager::AliasMap

protected

Definition of a map mapping alias device names to device names.

DeviceMap

typedef std::map<std::string, Device> Ocean::IO::CameraCalibrationManager::DeviceMap

protected

Definition of a map mapping device names to device objects.

Member Enumeration Documentation

Priority

enum Ocean::IO::CameraCalibrationManager::Priority

Definition of different priority values for the camera calibrations.

Enumerator
PRIORITY_LOW	Low priority.
PRIORITY_MEDIUM	Medium priority.
PRIORITY_HIGH	High priority.
PRIORITY_EXPLICIT	Explicit use priority.

Quality

enum Ocean::IO::CameraCalibrationManager::Quality

Definition of different calibration qualities.

Enumerator
QUALITY_EXACT	Exact calibration.
QUALITY_INTERPOLATED	Interpolated calibration.
QUALITY_DEFAULT	Default calibration.

Constructor & Destructor Documentation

CameraCalibrationManager()

Ocean::IO::CameraCalibrationManager::CameraCalibrationManager ( )

protected

Creates a new manager.

~CameraCalibrationManager()

Ocean::IO::CameraCalibrationManager::~CameraCalibrationManager ( )

protected

Destructs the manager.

Member Function Documentation

camera()

PinholeCamera Ocean::IO::CameraCalibrationManager::camera	(	const std::string &	device,
		const unsigned int	width,
		const unsigned int	height,
		Quality *	quality = nullptr,
		const Scalar	defaultFovX = Numeric::deg2rad(45)
	)		const

Returns a calibration for a specific device with a specific frame resolution.

Parameters

device	Name of the device
width	The width of the frame in pixel, with range [1, infinity)
height	The height of the frame in pixel, with range [1, infinity)
quality	Optional resulting quality of the calibration
defaultFovX	The default horizontal field of view the resulting camera profile will provide if no camera calibration exists for the specified device, with range (0, PI)

Returns

The camera profile for the given resolution

hasCalibration()

bool Ocean::IO::CameraCalibrationManager::hasCalibration

(

const std::string &

device

)

const

Returns whether this manager holds a valid camera profile for a specified device.

Parameters

device

The name of the device to check

Returns

True, if so

registerAlias()

bool Ocean::IO::CameraCalibrationManager::registerAlias	(	const std::string &	camera,
		const std::string &	alias
	)

Registers an alias camera name.

Parameters

camera	Original camera name
alias	Alias camera name

Returns

True, if succeeded

registerCalibration() [1/2]

bool Ocean::IO::CameraCalibrationManager::registerCalibration	(	const std::string &	camera,
		const PinholeCamera &	calibration
	)

Registers a new camera calibration.

This explicit calibration will receive the highest priority.

Parameters

camera	Name of the device or camera
calibration	The camera calibration profile

Returns

True, if succeeded

registerCalibration() [2/2]

bool Ocean::IO::CameraCalibrationManager::registerCalibration	(	const std::string &	camera,
		const unsigned int	width,
		const unsigned int	height,
		const Scalar	fovX
	)

Registers a new camera calibration.

Parameters

camera	Name or url of the camera to register
width	The width of the camera resolution in pixel, with range [1, infinity)
height	The height of the camera resolution in pixel, with range [1, infinity)
fovX	Horizontal field of view in radian, with range (0, PI)

Returns

True, if succeeded

registerCalibrationFile()

bool Ocean::IO::CameraCalibrationManager::registerCalibrationFile

(

const std::string &

url

)

Registers a new camera calibration file.

The file must have a specific file format.

Parameters

url	Url of the calibration file

Returns

True, if succeeded

Friends And Related Symbol Documentation

Singleton< CameraCalibrationManager >

friend class Singleton< CameraCalibrationManager >

friend

Field Documentation

aliasMap_

AliasMap Ocean::IO::CameraCalibrationManager::aliasMap_

protected

Map holding alias names.

deviceMap_

DeviceMap Ocean::IO::CameraCalibrationManager::deviceMap_

protected

Map holding all registered devices.

lock_

Lock Ocean::IO::CameraCalibrationManager::lock_

mutableprotected

The lock of this manager.

---

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

• CameraCalibrationManager.h