eVision::ECameraCalibration Class Reference

Camera calibration. More...

#include <eVision/Easy/ECameraCalibration.h>

Collaboration diagram for eVision::ECameraCalibration:

Public Member Functions
	ECameraCalibration ()
	Constructs a raw camera calibration object.
	ECameraCalibration (const eVision::ECameraCalibration &other)
	Copy constructor.
virtual	~ECameraCalibration () throw ()
eVision::ECameraCalibration &	operator= (const eVision::ECameraCalibration &other)
	Copy operator.
void	CopyTo (eVision::ECameraCalibration &other) const
	Copy the content of this ECameraCalibration object to the other object.
void	SetSensor (int32_t sensorWidth, int32_t sensorHeight, float fieldWidth, float fieldHeight, float centerX, float centerY, float angle, float tiltXAngle, float tiltYAngle, float perspectiveStrength, float distortionStrength, float opticalCenterX, float opticalCenterY, uint32_t calibrationModes)
	Sensor characteristics.
void	SetSensor (int32_t sensorWidth, int32_t sensorHeight, float fieldWidth, float fieldHeight, float centerX, float centerY, float angle, float tiltXAngle, float tiltYAngle, float perspectiveStrength, float distortionStrength, float opticalCenterX, float opticalCenterY)
	Sensor characteristics.
void	SetSensor (int32_t sensorWidth, int32_t sensorHeight, float fieldWidth, float fieldHeight, float centerX, float centerY, float angle, float tiltXAngle, float tiltYAngle, float perspectiveStrength, float distortionStrength, float opticalCenterX)
	Sensor characteristics.
void	SetSensor (int32_t sensorWidth, int32_t sensorHeight, float fieldWidth, float fieldHeight, float centerX, float centerY, float angle, float tiltXAngle, float tiltYAngle, float perspectiveStrength, float distortionStrength)
	Sensor characteristics.
void	SetSensor (int32_t sensorWidth, int32_t sensorHeight, float fieldWidth, float fieldHeight, float centerX, float centerY, float angle, float tiltXAngle, float tiltYAngle, float perspectiveStrength)
	Sensor characteristics.
void	SetSensor (int32_t sensorWidth, int32_t sensorHeight, float fieldWidth, float fieldHeight, float centerX, float centerY, float angle, float tiltXAngle, float tiltYAngle)
	Sensor characteristics.
void	SetSensor (int32_t sensorWidth, int32_t sensorHeight, float fieldWidth, float fieldHeight, float centerX, float centerY, float angle, float tiltXAngle)
	Sensor characteristics.
void	SetSensor (int32_t sensorWidth, int32_t sensorHeight, float fieldWidth, float fieldHeight, float centerX, float centerY, float angle)
	Sensor characteristics.
void	SetSensor (int32_t sensorWidth, int32_t sensorHeight, float fieldWidth, float fieldHeight, float centerX, float centerY)
	Sensor characteristics.
void	SetSensor (int32_t sensorWidth, int32_t sensorHeight, float fieldWidth, float fieldHeight, float centerX)
	Sensor characteristics.
void	SetSensor (int32_t sensorWidth, int32_t sensorHeight, float fieldWidth, float fieldHeight)
	Sensor characteristics.
void	SetSensor (int32_t sensorWidth, int32_t sensorHeight, float fieldWidth)
	Sensor characteristics.
void	SetSensor (int32_t sensorWidth, int32_t sensorHeight)
	Sensor characteristics.
void	SetSensorUsingResolution (int32_t sensorWidth, int32_t sensorHeight, float resolutionX, float resolutionY, float centerX, float centerY, float angle, float tiltXAngle, float tiltYAngle, float perspectiveStrength, float distortionStrength, float opticalCenterX, float opticalCenterY, uint32_t calibrationModes)
	Sensor characteristics.
void	SetSensorUsingResolution (int32_t sensorWidth, int32_t sensorHeight, float resolutionX, float resolutionY, float centerX, float centerY, float angle, float tiltXAngle, float tiltYAngle, float perspectiveStrength, float distortionStrength, float opticalCenterX, float opticalCenterY)
	Sensor characteristics.
void	SetSensorUsingResolution (int32_t sensorWidth, int32_t sensorHeight, float resolutionX, float resolutionY, float centerX, float centerY, float angle, float tiltXAngle, float tiltYAngle, float perspectiveStrength, float distortionStrength, float opticalCenterX)
	Sensor characteristics.
void	SetSensorUsingResolution (int32_t sensorWidth, int32_t sensorHeight, float resolutionX, float resolutionY, float centerX, float centerY, float angle, float tiltXAngle, float tiltYAngle, float perspectiveStrength, float distortionStrength)
	Sensor characteristics.
void	SetSensorUsingResolution (int32_t sensorWidth, int32_t sensorHeight, float resolutionX, float resolutionY, float centerX, float centerY, float angle, float tiltXAngle, float tiltYAngle, float perspectiveStrength)
	Sensor characteristics.
void	SetSensorUsingResolution (int32_t sensorWidth, int32_t sensorHeight, float resolutionX, float resolutionY, float centerX, float centerY, float angle, float tiltXAngle, float tiltYAngle)
	Sensor characteristics.
void	SetSensorUsingResolution (int32_t sensorWidth, int32_t sensorHeight, float resolutionX, float resolutionY, float centerX, float centerY, float angle, float tiltXAngle)
	Sensor characteristics.
void	SetSensorUsingResolution (int32_t sensorWidth, int32_t sensorHeight, float resolutionX, float resolutionY, float centerX, float centerY, float angle)
	Sensor characteristics.
void	SetSensorUsingResolution (int32_t sensorWidth, int32_t sensorHeight, float resolutionX, float resolutionY, float centerX, float centerY)
	Sensor characteristics.
void	SetSensorUsingResolution (int32_t sensorWidth, int32_t sensorHeight, float resolutionX, float resolutionY, float centerX)
	Sensor characteristics.
void	SetSensorUsingResolution (int32_t sensorWidth, int32_t sensorHeight, float resolutionX, float resolutionY)
	Sensor characteristics.
void	SetSensorUsingResolution (int32_t sensorWidth, int32_t sensorHeight, float resolutionX)
	Sensor characteristics.
void	SetSensorUsingResolution (int32_t sensorWidth, int32_t sensorHeight)
	Sensor characteristics.
void	SetAffineCalibration (int32_t sensorWidth, int32_t sensorHeight, float resolutionX, float resolutionY, float centerX, float centerY, float angle)
	Sets an affine calibration, i.e. a calibration model without distortion or perspective.
void	SetAffineCalibration (int32_t sensorWidth, int32_t sensorHeight, float resolutionX, float resolutionY, float centerX, float centerY)
	Sets an affine calibration, i.e. a calibration model without distortion or perspective.
void	SetAffineCalibration (int32_t sensorWidth, int32_t sensorHeight, float resolutionX, float resolutionY, float centerX)
	Sets an affine calibration, i.e. a calibration model without distortion or perspective.
void	SetAffineCalibration (int32_t sensorWidth, int32_t sensorHeight, float resolutionX, float resolutionY)
	Sets an affine calibration, i.e. a calibration model without distortion or perspective.
void	SetSensorSize (int32_t sensorWidth, int32_t sensorHeight)
	Sets the logical image size, i.e. the number of pixels horizontally and vertically and sets the optical center to be at the center of the image.
float	GetFieldWidth () const
	Field-of-view width, in physical units.
float	GetFieldHeight () const
	Field-of-view height, in physical units.
float	GetAngle () const
	Angle of the principal direction of the world plane with respect to the x-axis of the image.
float	GetRatio () const
	XResolution/YResolution ratio.
float	GetScale () const
	Scale of the model (X resolution).
eVision::EPoint	GetCenter () const
	Pixel coordinates of the projection of the world center.
int32_t	GetSensorWidth () const
	Logical image width, that is the number of pixels horizontally.
int32_t	GetSensorHeight () const
	Logical image height, that is the number of pixels vertically.
float	GetXResolution () const
	Horizontal sensor resolution, in pixels per unit.
float	GetYResolution () const
	Vertical sensor resolution, in pixels per unit.
float	GetTiltXAngle () const
	Tilt X angle, that is the amplitude of the rotation applied around the X-axis of the sensor to bring the optical (Z) axis perpendicular to the field of view.
float	GetTiltYAngle () const
	Tilt Y angle, that is the amplitude of the rotation applied around the Y-axis of the sensor to bring the optical (Z) axis perpendicular to the field of view.
float	GetPerspectiveStrength () const
	Perspective strength. This is the inverse of the distance between the optical center of the camera and the center of the world coordinate frame (observation distance).
float	GetDistortionStrength () const
	Optical distortion strength (the ratio of the image diagonal length with and without optical distortion introduced by the lens).
float	GetOpticalCenterX () const
	X coordinate of the optical center of the sensor in the image (in pixels).
float	GetOpticalCenterY () const
	Y coordinate of the optical center of the sensor in the image (in pixels).
uint32_t	GetCalibrationModes () const
	Current calibration mode, made from a combination of values.
bool	GetHasCustomMinDotArea () const
	Returns if a custom minimum dot area has been previously set.
void	SetCustomMinDotArea (int32_t areaSize)
	Sets the custom minimum dot area. The minimum dot area is used after the segmentation of the dots present in the grid to filter noise to only keep the actual dots used in the calibration. By default, a heuristic based on the dimension of the input image is used to define this value. This heuristic assumes that the dot area (in pixels) are larger than 1/50000th of the image area. Smaller objects are considered as noise.
int32_t	GetCustomMinDotArea () const
	Gets the minimum dot area.
void	ResetCustomMinDotArea ()
	Resets the custom minimum dot area parameter. The heurestic described in SetMinDotArea is used again.
bool	IsCalibrationAffine () const
	Whether the calibration is an affine transformation or not.
eVision::EFrame	ToFrame () const
	Converts the calibration to a EFrame where the global coordinates are the world coordinates.
void	EmptyLandmarks ()
	Resets the landmark specification sequence.
void	AddPoint (const eVision::EPoint &sensorPoint)
	Adds a new point coordinates (in Sensor space) to the set of grid points used for calibration.
void	AddLandmark (const eVision::EPoint &sensorPoint, const eVision::EPoint &worldPoint)
	Adds a new pair of points coordinates (in Sensor and World spaces) to the set of landmarks used for calibration.
void	RemoveLandmark (uint32_t index)
	Removes a landmark.
uint32_t	GetNumLandmark () const
	Number of landmarks.
eVision::ELandmark	GetLandmark (uint32_t i) const
	Gets a landmark.
void	HitLandmarks (int32_t x, int32_t y, float zoomX, float zoomY, float panX, float panY)
	Checks if the cursor is placed over a landmark point.
void	HitLandmarks (int32_t x, int32_t y, float zoomX, float zoomY, float panX)
	Checks if the cursor is placed over a landmark point.
void	HitLandmarks (int32_t x, int32_t y, float zoomX, float zoomY)
	Checks if the cursor is placed over a landmark point.
void	HitLandmarks (int32_t x, int32_t y, float zoomX)
	Checks if the cursor is placed over a landmark point.
void	HitLandmarks (int32_t x, int32_t y)
	Checks if the cursor is placed over a landmark point.
uint32_t	GetHitLandmark ()
	Returns the landmark selected by ECameraCalibration::HitLandmarks or ~0 if no landmark is selected.
void	DragLandmark (int32_t x, int32_t y, float zoomX, float zoomY, float panX, float panY)
	Moves the landmark to a new position.
void	DragLandmark (int32_t x, int32_t y, float zoomX, float zoomY, float panX)
	Moves the landmark to a new position.
void	DragLandmark (int32_t x, int32_t y, float zoomX, float zoomY)
	Moves the landmark to a new position.
void	DragLandmark (int32_t x, int32_t y, float zoomX)
	Moves the landmark to a new position.
void	DragLandmark (int32_t x, int32_t y)
	Moves the landmark to a new position.
void	Calibrate (uint32_t calibrationModes)
	Performs a calibration according to the specified combination of calibration modes.
void	Calibrate ()
	Performs a calibration according to the specified combination of calibration modes.
uint32_t	AutoCalibrate (bool testEmpiricalModes)
	Returns the best calibration modes for the current calibration grid and calibrates the field of view accordingly.
uint32_t	AutoCalibrate ()
	Returns the best calibration modes for the current calibration grid and calibrates the field of view accordingly.
uint32_t	AutoCalibrate (uint32_t calibrationModes)
	Returns the best calibration modes for the current calibration grid and calibrates the field of view accordingly.
uint32_t	AutoCalibrateLandmarks (bool testEmpiricalModes)
	Returns the best calibration modes for the current landmark set and calibrates the field of view accordingly.
uint32_t	AutoCalibrateLandmarks ()
	Returns the best calibration modes for the current landmark set and calibrates the field of view accordingly.
uint32_t	AutoCalibrateLandmarks (uint32_t calibrationModes)
	Returns the best calibration modes for the current landmark set and calibrates the field of view accordingly.
uint32_t	AutoCalibrateDotGrid (const eVision::EROIBW8 *sourceImage, float columnPitch, float rowPitch, bool testEmpiricalModes, bool testAdvancedCalibrationMode)
	Performs an automatic calibration based on a dot grid image.
uint32_t	AutoCalibrateDotGrid (const eVision::EROIBW8 *sourceImage, float columnPitch, float rowPitch, bool testEmpiricalModes)
	Performs an automatic calibration based on a dot grid image.
uint32_t	AutoCalibrateDotGrid (const eVision::EROIBW8 *sourceImage, float columnPitch, float rowPitch)
	Performs an automatic calibration based on a dot grid image.
uint32_t	AutoCalibrateDotGrid (const eVision::EROIBW8 *sourceImage, float columnPitch, float rowPitch, uint32_t enabledCalibrationModes)
	Performs an automatic calibration based on a dot grid image.
float	GetReprojectionScore () const
	Reproject score (average squared distance between a landmark and its projection in the image using the calibrated model).
float	GetMeanWorldToSensorError () const
	Mean WorldToSensor error over all valid landmarks (root mean square error, RMSE).
float	GetMaxWorldToSensorError () const
	Maximum WorldToSensor error over all valid landmarks (maximum distance between a landmark and its projection in the image using the calibrated model).
float	GetMeanSensorToWorldError () const
	Mean SensorToWorld error over all valid landmarks (root mean square error, RMSE).
float	GetMaxSensorToWorldError () const
	Maximum SensorToWorld error over all valid landmarks (maximum distance between a landmark and its projection in world space using the calibrated model).
bool	CalibrationSucceeded ()
	Getter method for the CalibrationSucceeded property. This property is the flag indicating if the calibration has succeeded (true), that is whether the mean variation of grid points (distance between computed grid points and ideal grid points in world space) and the maximum variation of grid points are between given tolerances.
float	GetGridPointsMeanVariation () const
	Mean variation of grid points (mean distance between computed grid points and ideal grid points in world space), normalized using the pitch values, after a call to ECameraCalibration::CalibrationSucceeded.
float	GetGridPointsMaxVariation () const
	Maximum variation of grid points (maximum distance between computed grid points and ideal grid points in world space), normalized using the pitch values, after a call to ECameraCalibration::CalibrationSucceeded.
float	GetGridPointsMeanVariationThreshold () const
	Grid points mean variation threshold, that is the value above which the mean variation of grid points (mean distance between computed grid points and ideal grid points in world space) is considered too high, and thus marks the calibration as a failure when using ECameraCalibration::CalibrationSucceeded.
void	SetGridPointsMeanVariationThreshold (float meanVariationThreshold)
	Grid points mean variation threshold, that is the value above which the mean variation of grid points (mean distance between computed grid points and ideal grid points in world space) is considered too high, and thus marks the calibration as a failure when using ECameraCalibration::CalibrationSucceeded.
float	GetGridPointsMaxVariationThreshold () const
	Grid points maximum variation threshold, that is the value above which the maximum variation of grid points (maximum distance between computed grid points and ideal grid points in world space) is considered too high, and thus marks the calibration as a failure when using ECameraCalibration::CalibrationSucceeded.
void	SetGridPointsMaxVariationThreshold (float maxVariationThreshold)
	Grid points maximum variation threshold, that is the value above which the maximum variation of grid points (maximum distance between computed grid points and ideal grid points in world space) is considered too high, and thus marks the calibration as a failure when using ECameraCalibration::CalibrationSucceeded.
uint32_t	RebuildGrid (float colPitch, float rowPitch, uint32_t centerIndex, bool direct)
	Reconstructs the grid of points from the given dot centers, to compute the World coordinates of the points.
uint32_t	RebuildGrid (float colPitch, float rowPitch, uint32_t centerIndex)
	Reconstructs the grid of points from the given dot centers, to compute the World coordinates of the points.
uint32_t	RebuildGrid (float colPitch, float rowPitch)
	Reconstructs the grid of points from the given dot centers, to compute the World coordinates of the points.
uint32_t	RebuildGrid (float colPitch, float rowPitch, const eVision::EPoint &worldCenter, uint32_t centerIndex, bool direct)
	Reconstructs the grid of points from the given dot centers, to compute the World coordinates of the points.
uint32_t	RebuildGrid (float colPitch, float rowPitch, const eVision::EPoint &worldCenter, uint32_t centerIndex)
	Reconstructs the grid of points from the given dot centers, to compute the World coordinates of the points.
uint32_t	RebuildGrid (float colPitch, float rowPitch, const eVision::EPoint &worldCenter)
	Reconstructs the grid of points from the given dot centers, to compute the World coordinates of the points.
void	SetupUnwarp (eVision::EUnwarpingLut *lookupTable, const eVision::EROIBW8 *sourceImage, bool interpolate, bool resizeDestination) const
	Prepares a lookup table for fast image unwarping.
void	SetupUnwarp (eVision::EUnwarpingLut *lookupTable, const eVision::EROIBW8 *sourceImage, bool interpolate) const
	Prepares a lookup table for fast image unwarping.
void	SetupUnwarp (eVision::EUnwarpingLut *lookupTable, const eVision::EROIBW8 *sourceImage) const
	Prepares a lookup table for fast image unwarping.
void	SetupUnwarp (eVision::EUnwarpingLut *lookupTable, const eVision::EROIC24 *sourceImage, bool interpolate, bool resizeDestination) const
	Prepares a lookup table for fast image unwarping.
void	SetupUnwarp (eVision::EUnwarpingLut *lookupTable, const eVision::EROIC24 *sourceImage, bool interpolate) const
	Prepares a lookup table for fast image unwarping.
void	SetupUnwarp (eVision::EUnwarpingLut *lookupTable, const eVision::EROIC24 *sourceImage) const
	Prepares a lookup table for fast image unwarping.
void	Unwarp (const eVision::EROIBW8 *sourceImage, eVision::EROIBW8 *destinationImage, bool interpolate, bool resizeDestination) const
	Unwarps a distorted image using the current calibration model.
void	Unwarp (const eVision::EROIBW8 *sourceImage, eVision::EROIBW8 *destinationImage, bool interpolate) const
	Unwarps a distorted image using the current calibration model.
void	Unwarp (const eVision::EROIBW8 *sourceImage, eVision::EROIBW8 *destinationImage) const
	Unwarps a distorted image using the current calibration model.
void	Unwarp (const eVision::EROIC24 *sourceImage, eVision::EROIC24 *destinationImage, bool interpolate, bool resizeDestination) const
	Unwarps a distorted image using the current calibration model.
void	Unwarp (const eVision::EROIC24 *sourceImage, eVision::EROIC24 *destinationImage, bool interpolate) const
	Unwarps a distorted image using the current calibration model.
void	Unwarp (const eVision::EROIC24 *sourceImage, eVision::EROIC24 *destinationImage) const
	Unwarps a distorted image using the current calibration model.
void	Unwarp (const eVision::EROIBW8 *sourceImage, eVision::EROIBW8 *destinationImage, eVision::ERegion &region, bool interpolate, bool resizeDestination) const
	Unwarps a distorted image using the current calibration model.
void	Unwarp (const eVision::EROIBW8 *sourceImage, eVision::EROIBW8 *destinationImage, eVision::ERegion &region, bool interpolate) const
	Unwarps a distorted image using the current calibration model.
void	Unwarp (const eVision::EROIBW8 *sourceImage, eVision::EROIBW8 *destinationImage, eVision::ERegion &region) const
	Unwarps a distorted image using the current calibration model.
void	Unwarp (const eVision::EROIC24 *sourceImage, eVision::EROIC24 *destinationImage, eVision::ERegion &region, bool interpolate, bool resizeDestination) const
	Unwarps a distorted image using the current calibration model.
void	Unwarp (const eVision::EROIC24 *sourceImage, eVision::EROIC24 *destinationImage, eVision::ERegion &region, bool interpolate) const
	Unwarps a distorted image using the current calibration model.
void	Unwarp (const eVision::EROIC24 *sourceImage, eVision::EROIC24 *destinationImage, eVision::ERegion &region) const
	Unwarps a distorted image using the current calibration model.
void	Unwarp (const eVision::EUnwarpingLut *lookupTable, const eVision::EROIBW8 *sourceImage, eVision::EROIBW8 *destinationImage, bool interpolate) const
	Unwarps a distorted image using the current calibration model.
void	Unwarp (const eVision::EUnwarpingLut *lookupTable, const eVision::EROIBW8 *sourceImage, eVision::EROIBW8 *destinationImage) const
	Unwarps a distorted image using the current calibration model.
void	Unwarp (const eVision::EUnwarpingLut *lookupTable, const eVision::EROIC24 *sourceImage, eVision::EROIC24 *destinationImage, bool interpolate) const
	Unwarps a distorted image using the current calibration model.
void	Unwarp (const eVision::EUnwarpingLut *lookupTable, const eVision::EROIC24 *sourceImage, eVision::EROIC24 *destinationImage) const
	Unwarps a distorted image using the current calibration model.
void	Unwarp (const eVision::EUnwarpingLut *lookupTable, const eVision::EROIBW8 *sourceImage, eVision::EROIBW8 *destinationImage, eVision::ERegion &region, bool interpolate) const
	Unwarps a distorted image using the current calibration model.
void	Unwarp (const eVision::EUnwarpingLut *lookupTable, const eVision::EROIBW8 *sourceImage, eVision::EROIBW8 *destinationImage, eVision::ERegion &region) const
	Unwarps a distorted image using the current calibration model.
void	Unwarp (const eVision::EUnwarpingLut *lookupTable, const eVision::EROIC24 *sourceImage, eVision::EROIC24 *destinationImage, eVision::ERegion &region, bool interpolate) const
	Unwarps a distorted image using the current calibration model.
void	Unwarp (const eVision::EUnwarpingLut *lookupTable, const eVision::EROIC24 *sourceImage, eVision::EROIC24 *destinationImage, eVision::ERegion &region) const
	Unwarps a distorted image using the current calibration model.
eVision::ECameraCalibration	GetUnwarpedCalibration (const eVision::EBaseROI *sourceImage, bool resizeDestination) const
	Gets a ECameraCalibration instance representing the transformation of image to world coordinates for the result of ECameraCalibration::Unwarp.
eVision::ECameraCalibration	GetUnwarpedCalibration (const eVision::EBaseROI *sourceImage) const
	Gets a ECameraCalibration instance representing the transformation of image to world coordinates for the result of ECameraCalibration::Unwarp.
eVision::ECameraCalibration	GetUnwarpedCalibration (int32_t sourceWidth, int32_t sourceHeight, bool resizeDestination) const
	Gets a ECameraCalibration instance representing the transformation of image to world coordinates for the result of ECameraCalibration::Unwarp.
eVision::ECameraCalibration	GetUnwarpedCalibration (int32_t sourceWidth, int32_t sourceHeight) const
	Gets a ECameraCalibration instance representing the transformation of image to world coordinates for the result of ECameraCalibration::Unwarp.
eVision::EPoint	SensorToWorld (const eVision::EPoint &sensorPoint) const
	Performs coordinate transform for arbitrary points from Sensor space to World space.
eVision::EPoint	WorldToSensor (const eVision::EPoint &worldPoint) const
	Performs coordinate transform for arbitrary points from World space to Sensor space.
float	GetDefaultAxisSize () const
	The default size of axis when drawing with ECameraCalibration::Draw.
void	Draw (eVision::EDrawAdapter *graphicContext, float zoomX, float zoomY, float panX, float panY) const
	Draws the world coordinate axis.
void	Draw (eVision::EDrawAdapter *graphicContext, float zoomX, float zoomY, float panX) const
	Draws the world coordinate axis.
void	Draw (eVision::EDrawAdapter *graphicContext, float zoomX, float zoomY) const
	Draws the world coordinate axis.
void	Draw (eVision::EDrawAdapter *graphicContext, float zoomX) const
	Draws the world coordinate axis.
void	Draw (eVision::EDrawAdapter *graphicContext) const
	Draws the world coordinate axis.
void	Draw (eVision::EDrawAdapter *graphicContext, float xAxisSize, float yAxisSize, float zoomX, float zoomY, float panX, float panY) const
	Draws the world coordinate axis.
void	DrawCrossGrid (eVision::EDrawAdapter *graphicContext, float minimumX, float maximumX, float minimumY, float maximumY, uint32_t numberOfIntervalsX, uint32_t numberOfIntervalsY, float zoomX, float zoomY, float panX, float panY) const
	Draws a regular grid of crosses in world coordinates.
void	DrawCrossGrid (eVision::EDrawAdapter *graphicContext, float minimumX, float maximumX, float minimumY, float maximumY, uint32_t numberOfIntervalsX, uint32_t numberOfIntervalsY, float zoomX, float zoomY, float panX) const
	Draws a regular grid of crosses in world coordinates.
void	DrawCrossGrid (eVision::EDrawAdapter *graphicContext, float minimumX, float maximumX, float minimumY, float maximumY, uint32_t numberOfIntervalsX, uint32_t numberOfIntervalsY, float zoomX, float zoomY) const
	Draws a regular grid of crosses in world coordinates.
void	DrawCrossGrid (eVision::EDrawAdapter *graphicContext, float minimumX, float maximumX, float minimumY, float maximumY, uint32_t numberOfIntervalsX, uint32_t numberOfIntervalsY, float zoomX) const
	Draws a regular grid of crosses in world coordinates.
void	DrawCrossGrid (eVision::EDrawAdapter *graphicContext, float minimumX, float maximumX, float minimumY, float maximumY, uint32_t numberOfIntervalsX, uint32_t numberOfIntervalsY) const
	Draws a regular grid of crosses in world coordinates.
void	DrawCrossGrid (eVision::EDrawAdapter *graphicContext, float minimumX, float maximumX, float minimumY, float maximumY, uint32_t numberOfIntervalsX) const
	Draws a regular grid of crosses in world coordinates.
void	DrawCrossGrid (eVision::EDrawAdapter *graphicContext, float minimumX, float maximumX, float minimumY, float maximumY) const
	Draws a regular grid of crosses in world coordinates.
void	DrawCrossGrid (eVision::EDrawAdapter *graphicContext, float minimumX, float maximumX, float minimumY) const
	Draws a regular grid of crosses in world coordinates.
void	DrawCrossGrid (eVision::EDrawAdapter *graphicContext, float minimumX, float maximumX) const
	Draws a regular grid of crosses in world coordinates.
void	DrawCrossGrid (eVision::EDrawAdapter *graphicContext, float minimumX) const
	Draws a regular grid of crosses in world coordinates.
void	DrawCrossGrid (eVision::EDrawAdapter *graphicContext) const
	Draws a regular grid of crosses in world coordinates.
void	DrawGrid (eVision::EDrawAdapter *graphicContext, float zoomX, float zoomY, float panX, float panY) const
	Draws the reconstructed grid to be used for grid calibration.
void	DrawGrid (eVision::EDrawAdapter *graphicContext, float zoomX, float zoomY, float panX) const
	Draws the reconstructed grid to be used for grid calibration.
void	DrawGrid (eVision::EDrawAdapter *graphicContext, float zoomX, float zoomY) const
	Draws the reconstructed grid to be used for grid calibration.
void	DrawGrid (eVision::EDrawAdapter *graphicContext, float zoomX) const
	Draws the reconstructed grid to be used for grid calibration.
void	DrawGrid (eVision::EDrawAdapter *graphicContext) const
	Draws the reconstructed grid to be used for grid calibration.
void	DrawLandmarks (eVision::EDrawAdapter *graphicContext, float zoomX, float zoomY, float panX, float panY) const
	Draws the landmarks to be used for landmark calibration.
void	DrawLandmarks (eVision::EDrawAdapter *graphicContext, float zoomX, float zoomY, float panX) const
	Draws the landmarks to be used for landmark calibration.
void	DrawLandmarks (eVision::EDrawAdapter *graphicContext, float zoomX, float zoomY) const
	Draws the landmarks to be used for landmark calibration.
void	DrawLandmarks (eVision::EDrawAdapter *graphicContext, float zoomX) const
	Draws the landmarks to be used for landmark calibration.
void	DrawLandmarks (eVision::EDrawAdapter *graphicContext) const
	Draws the landmarks to be used for landmark calibration.
eVision::AdvancedCalibrationParameters	GetAdvancedCalibrationParameters () const
	Get the advanced calibration parameters. Throws if the calibration mode is not advanced.
virtual void	Load (const std::string &path)
	Loads the ECameraCalibration. The given ESerializer must have been created for reading.
virtual void	Load (eVision::ESerializer *serializer)
	Loads the ECameraCalibration. The given ESerializer must have been created for reading.
virtual void	Save (const std::string &path)
	Saves the ECameraCalibration. The given ESerializer must have been created for writing.
virtual void	Save (eVision::ESerializer *serializer)
	Saves the ECameraCalibration. The given ESerializer must have been created for writing.
	ECameraCalibration (CppWrapperInternal::InternalConstructor)

Public Attributes
CppWrapperInternal::WrappedClass	wrappedClass_

Detailed Description

Camera calibration.

The camera calibration represents the transformation from the image to a world plane of reference.

License(s): BasicTypes

Constructor & Destructor Documentation

ECameraCalibration() [1/3]

eVision::ECameraCalibration::ECameraCalibration

(

)

Constructs a raw camera calibration object.

ECameraCalibration() [2/3]

eVision::ECameraCalibration::ECameraCalibration

(

const eVision::ECameraCalibration &

other

)

Copy constructor.

Parameters

other

Other ECameraCalibration object.

~ECameraCalibration()

eVision::ECameraCalibration::~ECameraCalibration ( ) throw (  )

virtual

ECameraCalibration() [3/3]

eVision::ECameraCalibration::ECameraCalibration

(

CppWrapperInternal::InternalConstructor

)

Member Function Documentation

AddLandmark()

void eVision::ECameraCalibration::AddLandmark	(	const eVision::EPoint &	sensorPoint,
		const eVision::EPoint &	worldPoint )

Adds a new pair of points coordinates (in Sensor and World spaces) to the set of landmarks used for calibration.

Parameters

sensorPoint	Sensor point coordinates.
worldPoint	Corresponding World point coordinates.

Landmark calibration is the process of computing the calibration parameters by means of a set of known points for which the coordinates are available in both World and Sensor spaces. Usually, such points are chosen as salient features on the part or target in view. They must be such that appropriate image processing techniques allow measuring their positions from the image (directly or indirectly by geometric constructions), while at the same time their coordinates in a reference frame are known.

AddPoint()

void eVision::ECameraCalibration::AddPoint

(

const eVision::EPoint &

sensorPoint

)

Adds a new point coordinates (in Sensor space) to the set of grid points used for calibration.

Parameters

sensorPoint

Sensor point coordinates.

Grid calibration is the process of computing the calibration parameters by means of a set of points known to lie on a rectangular grid. If the grid pitch is known and one of the points is chosen as the origin point, the points can be used as landmarks. By contrast with the landmark calibration functions, the World coordinates of the grid points need not be specified, nor do they have to be given in any specific order. The calibration algorithm is capable of sorting out the points to reconstruct the grid topology.

Typically, this function is used in conjunction with blob analysis to extract the dot centers from a grid of dots. Anyway, any other scheme can be used. The grid of points need not be complete, i.e. some of the nodes may be missing, and the points need not completely fill a rectangular area.

Landmark calibration is simply achieved by providing a series of point coordinates (in Sensor space only) and then calling the grid reconstruction function followed by the calibration function.

AutoCalibrate() [1/3]

uint32_t eVision::ECameraCalibration::AutoCalibrate

(

)

Returns the best calibration modes for the current calibration grid and calibrates the field of view accordingly.

To ensure a successful calibration, the perspective angle of the view should not exceed 45 degrees.

By default, only combination of the calibration modes ECalibrationMode::ECalibrationMode_Scaled, ECalibrationMode::ECalibrationMode_Skewed, ECalibrationMode::ECalibrationMode_Radial, ECalibrationMode::ECalibrationMode_Tilted, and ECalibrationMode::ECalibrationMode_Anisotropic are considered. The ECalibrationMode::ECalibrationMode_Advanced calibration mode must be explicitly selected to be considered.

AutoCalibrate() [2/3]

uint32_t eVision::ECameraCalibration::AutoCalibrate

(

bool

testEmpiricalModes

)

Returns the best calibration modes for the current calibration grid and calibrates the field of view accordingly.

Parameters

testEmpiricalModes

Boolean indicating whether empirical quadratic calibration mode (ECalibrationMode::ECalibrationMode_Quadratic) should be considered when determining the best calibration modes.

To ensure a successful calibration, the perspective angle of the view should not exceed 45 degrees.

By default, only combination of the calibration modes ECalibrationMode::ECalibrationMode_Scaled, ECalibrationMode::ECalibrationMode_Skewed, ECalibrationMode::ECalibrationMode_Radial, ECalibrationMode::ECalibrationMode_Tilted, and ECalibrationMode::ECalibrationMode_Anisotropic are considered. The ECalibrationMode::ECalibrationMode_Advanced calibration mode must be explicitly selected to be considered.

AutoCalibrate() [3/3]

uint32_t eVision::ECameraCalibration::AutoCalibrate

(

uint32_t

calibrationModes

)

Returns the best calibration modes for the current calibration grid and calibrates the field of view accordingly.

Parameters

calibrationModes

Calibration modes that should be considered when determining the best calibration model

To ensure a successful calibration, the perspective angle of the view should not exceed 45 degrees.

By default, only combination of the calibration modes ECalibrationMode::ECalibrationMode_Scaled, ECalibrationMode::ECalibrationMode_Skewed, ECalibrationMode::ECalibrationMode_Radial, ECalibrationMode::ECalibrationMode_Tilted, and ECalibrationMode::ECalibrationMode_Anisotropic are considered. The ECalibrationMode::ECalibrationMode_Advanced calibration mode must be explicitly selected to be considered.

AutoCalibrateDotGrid() [1/4]

uint32_t eVision::ECameraCalibration::AutoCalibrateDotGrid	(	const eVision::EROIBW8 *	sourceImage,
		float	columnPitch,
		float	rowPitch )

Performs an automatic calibration based on a dot grid image.

Parameters

sourceImage	Pointer to the source image/ROI.
columnPitch	Actual pitches of the grid, i.e. distances between vertical and horizontal rows of the grid.
rowPitch	Actual pitches of the grid, i.e. distances between vertical and horizontal rows of the grid.

Returns the best calibration mode for the current dot grid.

This method will first do an automatic blob analysis in order to extract all dots. All blobs whose area is smaller than 5 pixels or 1/50000th of the whole image area will be considered as noise and rejected. This criteria can be overrided with the method ECameraCalibration::SetCustomMinDotArea. The dot gravity centers are used as the grid reference points. Then, this method will select and compute the best calibration mode by reducing the fitting error. To ensure a successful calibration, the perspective angle of the dot grid should not exceed 45 degrees.

By default, only combination of the calibration modes ECalibrationMode::ECalibrationMode_Scaled, ECalibrationMode::ECalibrationMode_Skewed, ECalibrationMode::ECalibrationMode_Radial, ECalibrationMode::ECalibrationMode_Tilted, and ECalibrationMode::ECalibrationMode_Anisotropic are considered. The ECalibrationMode::ECalibrationMode_Advanced calibration mode must be explicitly selected to be considered.

AutoCalibrateDotGrid() [2/4]

uint32_t eVision::ECameraCalibration::AutoCalibrateDotGrid	(	const eVision::EROIBW8 *	sourceImage,
		float	columnPitch,
		float	rowPitch,
		bool	testEmpiricalModes )

Performs an automatic calibration based on a dot grid image.

Parameters

sourceImage	Pointer to the source image/ROI.
columnPitch	Actual pitches of the grid, i.e. distances between vertical and horizontal rows of the grid.
rowPitch	Actual pitches of the grid, i.e. distances between vertical and horizontal rows of the grid.
testEmpiricalModes	Boolean indicating whether the empirical quadratic calibration mode (ECalibrationMode::ECalibrationMode_Quadratic) should be considered when determining the best calibration modes. Default value is false.

Returns the best calibration mode for the current dot grid.

This method will first do an automatic blob analysis in order to extract all dots. All blobs whose area is smaller than 5 pixels or 1/50000th of the whole image area will be considered as noise and rejected. This criteria can be overrided with the method ECameraCalibration::SetCustomMinDotArea. The dot gravity centers are used as the grid reference points. Then, this method will select and compute the best calibration mode by reducing the fitting error. To ensure a successful calibration, the perspective angle of the dot grid should not exceed 45 degrees.

By default, only combination of the calibration modes ECalibrationMode::ECalibrationMode_Scaled, ECalibrationMode::ECalibrationMode_Skewed, ECalibrationMode::ECalibrationMode_Radial, ECalibrationMode::ECalibrationMode_Tilted, and ECalibrationMode::ECalibrationMode_Anisotropic are considered. The ECalibrationMode::ECalibrationMode_Advanced calibration mode must be explicitly selected to be considered.

AutoCalibrateDotGrid() [3/4]

uint32_t eVision::ECameraCalibration::AutoCalibrateDotGrid	(	const eVision::EROIBW8 *	sourceImage,
		float	columnPitch,
		float	rowPitch,
		bool	testEmpiricalModes,
		bool	testAdvancedCalibrationMode )

Performs an automatic calibration based on a dot grid image.

Parameters

sourceImage	Pointer to the source image/ROI.
columnPitch	Actual pitches of the grid, i.e. distances between vertical and horizontal rows of the grid.
rowPitch	Actual pitches of the grid, i.e. distances between vertical and horizontal rows of the grid.
testEmpiricalModes	Boolean indicating whether the empirical quadratic calibration mode (ECalibrationMode::ECalibrationMode_Quadratic) should be considered when determining the best calibration modes. Default value is false.
testAdvancedCalibrationMode	Boolean indicating whether the advanced calibration mode (ECalibrationMode::ECalibrationMode_Advanced) should be considered when determining the best calibration modes. Default value is false.

Returns the best calibration mode for the current dot grid.

This method will first do an automatic blob analysis in order to extract all dots. All blobs whose area is smaller than 5 pixels or 1/50000th of the whole image area will be considered as noise and rejected. This criteria can be overrided with the method ECameraCalibration::SetCustomMinDotArea. The dot gravity centers are used as the grid reference points. Then, this method will select and compute the best calibration mode by reducing the fitting error. To ensure a successful calibration, the perspective angle of the dot grid should not exceed 45 degrees.

By default, only combination of the calibration modes ECalibrationMode::ECalibrationMode_Scaled, ECalibrationMode::ECalibrationMode_Skewed, ECalibrationMode::ECalibrationMode_Radial, ECalibrationMode::ECalibrationMode_Tilted, and ECalibrationMode::ECalibrationMode_Anisotropic are considered. The ECalibrationMode::ECalibrationMode_Advanced calibration mode must be explicitly selected to be considered.

AutoCalibrateDotGrid() [4/4]

uint32_t eVision::ECameraCalibration::AutoCalibrateDotGrid	(	const eVision::EROIBW8 *	sourceImage,
		float	columnPitch,
		float	rowPitch,
		uint32_t	enabledCalibrationModes )

Performs an automatic calibration based on a dot grid image.

Parameters

sourceImage	Pointer to the source image/ROI.
columnPitch	Actual pitches of the grid, i.e. distances between vertical and horizontal rows of the grid.
rowPitch	Actual pitches of the grid, i.e. distances between vertical and horizontal rows of the grid.
enabledCalibrationModes	Calibration modes that should be considered when determining the best calibration model

Returns the best calibration mode for the current dot grid.

This method will first do an automatic blob analysis in order to extract all dots. All blobs whose area is smaller than 5 pixels or 1/50000th of the whole image area will be considered as noise and rejected. This criteria can be overrided with the method ECameraCalibration::SetCustomMinDotArea. The dot gravity centers are used as the grid reference points. Then, this method will select and compute the best calibration mode by reducing the fitting error. To ensure a successful calibration, the perspective angle of the dot grid should not exceed 45 degrees.

By default, only combination of the calibration modes ECalibrationMode::ECalibrationMode_Scaled, ECalibrationMode::ECalibrationMode_Skewed, ECalibrationMode::ECalibrationMode_Radial, ECalibrationMode::ECalibrationMode_Tilted, and ECalibrationMode::ECalibrationMode_Anisotropic are considered. The ECalibrationMode::ECalibrationMode_Advanced calibration mode must be explicitly selected to be considered.

AutoCalibrateLandmarks() [1/3]

uint32_t eVision::ECameraCalibration::AutoCalibrateLandmarks

(

)

Returns the best calibration modes for the current landmark set and calibrates the field of view accordingly.

Landmark calibration is the process of computing the calibration parameters by means of a set of known points for which the coordinates are available in both World and Sensor spaces. Usually, such points are chosen as salient features on the part or target in view. They must be such that appropriate image processing techniques allow measuring their positions from the image (directly or indirectly by geometric constructions), while at the same time their coordinates in a reference frame are known.

You must specify the image size with ECameraCalibration::SetSensorSize before doing a landmark calibration.

To ensure a successful calibration, the perspective angle of the view should not exceed 45 degrees.

This method is meant to be used with landmark calibration only. To calibrate automatically your field of view using a dot grid, use the ECameraCalibration::AutoCalibrate method instead.

By default, only combination of the calibration modes ECalibrationMode::ECalibrationMode_Scaled, ECalibrationMode::ECalibrationMode_Skewed, ECalibrationMode::ECalibrationMode_Radial, ECalibrationMode::ECalibrationMode_Tilted, and ECalibrationMode::ECalibrationMode_Anisotropic are considered. The ECalibrationMode::ECalibrationMode_Advanced calibration mode must be explicitly selected to be considered.

AutoCalibrateLandmarks() [2/3]

uint32_t eVision::ECameraCalibration::AutoCalibrateLandmarks

(

bool

testEmpiricalModes

)

Returns the best calibration modes for the current landmark set and calibrates the field of view accordingly.

Parameters

testEmpiricalModes

Boolean indicating whether the empirical quadratic calibration mode (ECalibrationMode::ECalibrationMode_Quadratic) should be considered when determining the best calibration modes. Default value is false.

Landmark calibration is the process of computing the calibration parameters by means of a set of known points for which the coordinates are available in both World and Sensor spaces. Usually, such points are chosen as salient features on the part or target in view. They must be such that appropriate image processing techniques allow measuring their positions from the image (directly or indirectly by geometric constructions), while at the same time their coordinates in a reference frame are known.

You must specify the image size with ECameraCalibration::SetSensorSize before doing a landmark calibration.

To ensure a successful calibration, the perspective angle of the view should not exceed 45 degrees.

This method is meant to be used with landmark calibration only. To calibrate automatically your field of view using a dot grid, use the ECameraCalibration::AutoCalibrate method instead.

By default, only combination of the calibration modes ECalibrationMode::ECalibrationMode_Scaled, ECalibrationMode::ECalibrationMode_Skewed, ECalibrationMode::ECalibrationMode_Radial, ECalibrationMode::ECalibrationMode_Tilted, and ECalibrationMode::ECalibrationMode_Anisotropic are considered. The ECalibrationMode::ECalibrationMode_Advanced calibration mode must be explicitly selected to be considered.

AutoCalibrateLandmarks() [3/3]

uint32_t eVision::ECameraCalibration::AutoCalibrateLandmarks

(

uint32_t

calibrationModes

)

Returns the best calibration modes for the current landmark set and calibrates the field of view accordingly.

Parameters

calibrationModes

Calibration modes that should be considered when determining the best calibration model

Landmark calibration is the process of computing the calibration parameters by means of a set of known points for which the coordinates are available in both World and Sensor spaces. Usually, such points are chosen as salient features on the part or target in view. They must be such that appropriate image processing techniques allow measuring their positions from the image (directly or indirectly by geometric constructions), while at the same time their coordinates in a reference frame are known.

You must specify the image size with ECameraCalibration::SetSensorSize before doing a landmark calibration.

To ensure a successful calibration, the perspective angle of the view should not exceed 45 degrees.

This method is meant to be used with landmark calibration only. To calibrate automatically your field of view using a dot grid, use the ECameraCalibration::AutoCalibrate method instead.

By default, only combination of the calibration modes ECalibrationMode::ECalibrationMode_Scaled, ECalibrationMode::ECalibrationMode_Skewed, ECalibrationMode::ECalibrationMode_Radial, ECalibrationMode::ECalibrationMode_Tilted, and ECalibrationMode::ECalibrationMode_Anisotropic are considered. The ECalibrationMode::ECalibrationMode_Advanced calibration mode must be explicitly selected to be considered.

Calibrate() [1/2]

void eVision::ECameraCalibration::Calibrate

(

)

Performs a calibration according to the specified combination of calibration modes.

Landmark calibration is the process of computing the calibration parameters by means of a set of known points for which the coordinates are available in both World and Sensor spaces. Usually, such points are chosen as salient features on the part or target in view. They must be such that appropriate image processing techniques allow measuring their positions from the image (directly or indirectly by geometric constructions), while at the same time their coordinates in a reference frame are known.

In some cases, not all requested calibration modes are honored. After calibration, ECameraCalibration::GetCalibrationModes returns the actual combination of modes in effect.

To ensure a successful calibration, the perspective angle of the view should not exceed 45 degrees.

Calibrate() [2/2]

void eVision::ECameraCalibration::Calibrate

(

uint32_t

calibrationModes

)

Performs a calibration according to the specified combination of calibration modes.

Parameters

calibrationModes

Calibration modes, as defined by a combination of values from ECalibrationMode.

Landmark calibration is the process of computing the calibration parameters by means of a set of known points for which the coordinates are available in both World and Sensor spaces. Usually, such points are chosen as salient features on the part or target in view. They must be such that appropriate image processing techniques allow measuring their positions from the image (directly or indirectly by geometric constructions), while at the same time their coordinates in a reference frame are known.

In some cases, not all requested calibration modes are honored. After calibration, ECameraCalibration::GetCalibrationModes returns the actual combination of modes in effect.

To ensure a successful calibration, the perspective angle of the view should not exceed 45 degrees.

CalibrationSucceeded()

bool eVision::ECameraCalibration::CalibrationSucceeded

(

)

Getter method for the CalibrationSucceeded property. This property is the flag indicating if the calibration has succeeded (true), that is whether the mean variation of grid points (distance between computed grid points and ideal grid points in world space) and the maximum variation of grid points are between given tolerances.

The mean and maximum grid point variations are normalized using the pitch values. By default, tolerances are set to 0.05 (5 %) for the mean, and 0.1 (10 %) for the maximum grid point variation. You can get and set these tolerances using the ECameraCalibration::GetGridPointsMeanVariationThreshold and ECameraCalibration::GetGridPointsMaxVariationThreshold properties.

CopyTo()

void eVision::ECameraCalibration::CopyTo

(

eVision::ECameraCalibration &

other

)

const

Copy the content of this ECameraCalibration object to the other object.

Parameters

other

Object to copy to.

DragLandmark() [1/5]

void eVision::ECameraCalibration::DragLandmark	(	int32_t	x,
		int32_t	y )

Moves the landmark to a new position.

Parameters

x	Current cursor coordinates.
y	Current cursor coordinates.

DragLandmark() [2/5]

void eVision::ECameraCalibration::DragLandmark	(	int32_t	x,
		int32_t	y,
		float	zoomX )

Moves the landmark to a new position.

Parameters

x	Current cursor coordinates.
y	Current cursor coordinates.
zoomX	Horizontal zooming factor. By default, true scale is used.

DragLandmark() [3/5]

void eVision::ECameraCalibration::DragLandmark	(	int32_t	x,
		int32_t	y,
		float	zoomX,
		float	zoomY )

Moves the landmark to a new position.

Parameters

x	Current cursor coordinates.
y	Current cursor coordinates.
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, to provide isotropic zooming.

DragLandmark() [4/5]

void eVision::ECameraCalibration::DragLandmark	(	int32_t	x,
		int32_t	y,
		float	zoomX,
		float	zoomY,
		float	panX )

Moves the landmark to a new position.

Parameters

x	Current cursor coordinates.
y	Current cursor coordinates.
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

DragLandmark() [5/5]

void eVision::ECameraCalibration::DragLandmark	(	int32_t	x,
		int32_t	y,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY )

Moves the landmark to a new position.

Parameters

x	Current cursor coordinates.
y	Current cursor coordinates.
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

Draw() [1/6]

void eVision::ECameraCalibration::Draw

(

eVision::EDrawAdapter *

graphicContext

)

const

Draws the world coordinate axis.

Parameters

graphicContext

Handle of the device context on which to draw.

Draw() [2/6]

void eVision::ECameraCalibration::Draw	(	eVision::EDrawAdapter *	graphicContext,
		float	xAxisSize,
		float	yAxisSize,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY ) const

Draws the world coordinate axis.

Parameters

graphicContext	Handle of the device context on which to draw.
xAxisSize	Size of the X axis to draw in metric unit
yAxisSize	Size of the Y axis to draw in metric unit
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

Draw() [3/6]

void eVision::ECameraCalibration::Draw	(	eVision::EDrawAdapter *	graphicContext,
		float	zoomX ) const

Draws the world coordinate axis.

Parameters

graphicContext	Handle of the device context on which to draw.
zoomX	Horizontal zooming factor. By default, true scale is used.

Draw() [4/6]

void eVision::ECameraCalibration::Draw	(	eVision::EDrawAdapter *	graphicContext,
		float	zoomX,
		float	zoomY ) const

Draws the world coordinate axis.

Parameters

graphicContext	Handle of the device context on which to draw.
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, to provide isotropic zooming.

Draw() [5/6]

void eVision::ECameraCalibration::Draw	(	eVision::EDrawAdapter *	graphicContext,
		float	zoomX,
		float	zoomY,
		float	panX ) const

Draws the world coordinate axis.

Parameters

graphicContext	Handle of the device context on which to draw.
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

Draw() [6/6]

void eVision::ECameraCalibration::Draw	(	eVision::EDrawAdapter *	graphicContext,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY ) const

Draws the world coordinate axis.

Parameters

graphicContext	Handle of the device context on which to draw.
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

DrawCrossGrid() [1/11]

void eVision::ECameraCalibration::DrawCrossGrid

(

eVision::EDrawAdapter *

graphicContext

)

const

Draws a regular grid of crosses in world coordinates.

Parameters

graphicContext

Handle of the device context on which to draw.

DrawCrossGrid() [2/11]

void eVision::ECameraCalibration::DrawCrossGrid	(	eVision::EDrawAdapter *	graphicContext,
		float	minimumX ) const

Draws a regular grid of crosses in world coordinates.

Parameters

graphicContext	Handle of the device context on which to draw.
minimumX	Abscissa of the leftmost crosses, in world coordinates.

DrawCrossGrid() [3/11]

void eVision::ECameraCalibration::DrawCrossGrid	(	eVision::EDrawAdapter *	graphicContext,
		float	minimumX,
		float	maximumX ) const

Draws a regular grid of crosses in world coordinates.

Parameters

graphicContext	Handle of the device context on which to draw.
minimumX	Abscissa of the leftmost crosses, in world coordinates.
maximumX	Abscissa of the rightmost crosses, in world coordinates.

DrawCrossGrid() [4/11]

void eVision::ECameraCalibration::DrawCrossGrid	(	eVision::EDrawAdapter *	graphicContext,
		float	minimumX,
		float	maximumX,
		float	minimumY ) const

Draws a regular grid of crosses in world coordinates.

Parameters

graphicContext	Handle of the device context on which to draw.
minimumX	Abscissa of the leftmost crosses, in world coordinates.
maximumX	Abscissa of the rightmost crosses, in world coordinates.
minimumY	Ordinate of the leftmost crosses, in world coordinates.

DrawCrossGrid() [5/11]

void eVision::ECameraCalibration::DrawCrossGrid	(	eVision::EDrawAdapter *	graphicContext,
		float	minimumX,
		float	maximumX,
		float	minimumY,
		float	maximumY ) const

Draws a regular grid of crosses in world coordinates.

Parameters

graphicContext	Handle of the device context on which to draw.
minimumX	Abscissa of the leftmost crosses, in world coordinates.
maximumX	Abscissa of the rightmost crosses, in world coordinates.
minimumY	Ordinate of the leftmost crosses, in world coordinates.
maximumY	Ordinate of the rightmost crosses, in world coordinates.

DrawCrossGrid() [6/11]

void eVision::ECameraCalibration::DrawCrossGrid	(	eVision::EDrawAdapter *	graphicContext,
		float	minimumX,
		float	maximumX,
		float	minimumY,
		float	maximumY,
		uint32_t	numberOfIntervalsX ) const

Draws a regular grid of crosses in world coordinates.

Parameters

graphicContext	Handle of the device context on which to draw.
minimumX	Abscissa of the leftmost crosses, in world coordinates.
maximumX	Abscissa of the rightmost crosses, in world coordinates.
minimumY	Ordinate of the leftmost crosses, in world coordinates.
maximumY	Ordinate of the rightmost crosses, in world coordinates.
numberOfIntervalsX	Number of intervals between crosses along the horizontal direction.

DrawCrossGrid() [7/11]

void eVision::ECameraCalibration::DrawCrossGrid	(	eVision::EDrawAdapter *	graphicContext,
		float	minimumX,
		float	maximumX,
		float	minimumY,
		float	maximumY,
		uint32_t	numberOfIntervalsX,
		uint32_t	numberOfIntervalsY ) const

Draws a regular grid of crosses in world coordinates.

Parameters

graphicContext	Handle of the device context on which to draw.
minimumX	Abscissa of the leftmost crosses, in world coordinates.
maximumX	Abscissa of the rightmost crosses, in world coordinates.
minimumY	Ordinate of the leftmost crosses, in world coordinates.
maximumY	Ordinate of the rightmost crosses, in world coordinates.
numberOfIntervalsX	Number of intervals between crosses along the horizontal direction.
numberOfIntervalsY	Number of intervals between crosses along the vertical direction.

DrawCrossGrid() [8/11]

void eVision::ECameraCalibration::DrawCrossGrid	(	eVision::EDrawAdapter *	graphicContext,
		float	minimumX,
		float	maximumX,
		float	minimumY,
		float	maximumY,
		uint32_t	numberOfIntervalsX,
		uint32_t	numberOfIntervalsY,
		float	zoomX ) const

Draws a regular grid of crosses in world coordinates.

Parameters

graphicContext	Handle of the device context on which to draw.
minimumX	Abscissa of the leftmost crosses, in world coordinates.
maximumX	Abscissa of the rightmost crosses, in world coordinates.
minimumY	Ordinate of the leftmost crosses, in world coordinates.
maximumY	Ordinate of the rightmost crosses, in world coordinates.
numberOfIntervalsX	Number of intervals between crosses along the horizontal direction.
numberOfIntervalsY	Number of intervals between crosses along the vertical direction.
zoomX	Horizontal zooming factor. By default, true scale is used.

DrawCrossGrid() [9/11]

void eVision::ECameraCalibration::DrawCrossGrid	(	eVision::EDrawAdapter *	graphicContext,
		float	minimumX,
		float	maximumX,
		float	minimumY,
		float	maximumY,
		uint32_t	numberOfIntervalsX,
		uint32_t	numberOfIntervalsY,
		float	zoomX,
		float	zoomY ) const

Draws a regular grid of crosses in world coordinates.

Parameters

graphicContext	Handle of the device context on which to draw.
minimumX	Abscissa of the leftmost crosses, in world coordinates.
maximumX	Abscissa of the rightmost crosses, in world coordinates.
minimumY	Ordinate of the leftmost crosses, in world coordinates.
maximumY	Ordinate of the rightmost crosses, in world coordinates.
numberOfIntervalsX	Number of intervals between crosses along the horizontal direction.
numberOfIntervalsY	Number of intervals between crosses along the vertical direction.
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, to provide isotropic zooming.

DrawCrossGrid() [10/11]

void eVision::ECameraCalibration::DrawCrossGrid	(	eVision::EDrawAdapter *	graphicContext,
		float	minimumX,
		float	maximumX,
		float	minimumY,
		float	maximumY,
		uint32_t	numberOfIntervalsX,
		uint32_t	numberOfIntervalsY,
		float	zoomX,
		float	zoomY,
		float	panX ) const

Draws a regular grid of crosses in world coordinates.

Parameters

graphicContext	Handle of the device context on which to draw.
minimumX	Abscissa of the leftmost crosses, in world coordinates.
maximumX	Abscissa of the rightmost crosses, in world coordinates.
minimumY	Ordinate of the leftmost crosses, in world coordinates.
maximumY	Ordinate of the rightmost crosses, in world coordinates.
numberOfIntervalsX	Number of intervals between crosses along the horizontal direction.
numberOfIntervalsY	Number of intervals between crosses along the vertical direction.
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

DrawCrossGrid() [11/11]

void eVision::ECameraCalibration::DrawCrossGrid	(	eVision::EDrawAdapter *	graphicContext,
		float	minimumX,
		float	maximumX,
		float	minimumY,
		float	maximumY,
		uint32_t	numberOfIntervalsX,
		uint32_t	numberOfIntervalsY,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY ) const

Draws a regular grid of crosses in world coordinates.

Parameters

graphicContext	Handle of the device context on which to draw.
minimumX	Abscissa of the leftmost crosses, in world coordinates.
maximumX	Abscissa of the rightmost crosses, in world coordinates.
minimumY	Ordinate of the leftmost crosses, in world coordinates.
maximumY	Ordinate of the rightmost crosses, in world coordinates.
numberOfIntervalsX	Number of intervals between crosses along the horizontal direction.
numberOfIntervalsY	Number of intervals between crosses along the vertical direction.
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

DrawGrid() [1/5]

void eVision::ECameraCalibration::DrawGrid

(

eVision::EDrawAdapter *

graphicContext

)

const

Draws the reconstructed grid to be used for grid calibration.

Parameters

graphicContext

Handle of the device context on which to draw.

DrawGrid() [2/5]

void eVision::ECameraCalibration::DrawGrid	(	eVision::EDrawAdapter *	graphicContext,
		float	zoomX ) const

Draws the reconstructed grid to be used for grid calibration.

Parameters

graphicContext	Handle of the device context on which to draw.
zoomX	Horizontal zooming factor. By default, true scale is used.

DrawGrid() [3/5]

void eVision::ECameraCalibration::DrawGrid	(	eVision::EDrawAdapter *	graphicContext,
		float	zoomX,
		float	zoomY ) const

Draws the reconstructed grid to be used for grid calibration.

Parameters

graphicContext	Handle of the device context on which to draw.
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, to provide isotropic zooming.

DrawGrid() [4/5]

void eVision::ECameraCalibration::DrawGrid	(	eVision::EDrawAdapter *	graphicContext,
		float	zoomX,
		float	zoomY,
		float	panX ) const

Draws the reconstructed grid to be used for grid calibration.

Parameters

graphicContext	Handle of the device context on which to draw.
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

DrawGrid() [5/5]

void eVision::ECameraCalibration::DrawGrid	(	eVision::EDrawAdapter *	graphicContext,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY ) const

Draws the reconstructed grid to be used for grid calibration.

Parameters

graphicContext	Handle of the device context on which to draw.
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

DrawLandmarks() [1/5]

void eVision::ECameraCalibration::DrawLandmarks

(

eVision::EDrawAdapter *

graphicContext

)

const

Draws the landmarks to be used for landmark calibration.

Parameters

graphicContext

Handle of the device context on which to draw.

DrawLandmarks() [2/5]

void eVision::ECameraCalibration::DrawLandmarks	(	eVision::EDrawAdapter *	graphicContext,
		float	zoomX ) const

Draws the landmarks to be used for landmark calibration.

Parameters

graphicContext	Handle of the device context on which to draw.
zoomX	Horizontal zooming factor. By default, true scale is used.

DrawLandmarks() [3/5]

void eVision::ECameraCalibration::DrawLandmarks	(	eVision::EDrawAdapter *	graphicContext,
		float	zoomX,
		float	zoomY ) const

Draws the landmarks to be used for landmark calibration.

Parameters

graphicContext	Handle of the device context on which to draw.
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, to provide isotropic zooming.

DrawLandmarks() [4/5]

void eVision::ECameraCalibration::DrawLandmarks	(	eVision::EDrawAdapter *	graphicContext,
		float	zoomX,
		float	zoomY,
		float	panX ) const

Draws the landmarks to be used for landmark calibration.

Parameters

graphicContext	Handle of the device context on which to draw.
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

DrawLandmarks() [5/5]

void eVision::ECameraCalibration::DrawLandmarks	(	eVision::EDrawAdapter *	graphicContext,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY ) const

Draws the landmarks to be used for landmark calibration.

Parameters

graphicContext	Handle of the device context on which to draw.
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

EmptyLandmarks()

void eVision::ECameraCalibration::EmptyLandmarks

(

)

Resets the landmark specification sequence.

Landmark calibration is the process of computing the calibration parameters by means of a set of known points for which the coordinates are available in both World and Sensor spaces. Usually, such points are chosen as salient features on the part or target in view. They must be such that appropriate image processing techniques allow measuring their positions from the image (directly or indirectly by geometric constructions), while at the same time their coordinates in a reference frame are known.

GetAdvancedCalibrationParameters()

eVision::AdvancedCalibrationParameters eVision::ECameraCalibration::GetAdvancedCalibrationParameters

(

)

const

Get the advanced calibration parameters. Throws if the calibration mode is not advanced.

GetAngle()

float eVision::ECameraCalibration::GetAngle

(

)

const

Angle of the principal direction of the world plane with respect to the x-axis of the image.

GetCalibrationModes()

uint32_t eVision::ECameraCalibration::GetCalibrationModes

(

)

const

Current calibration mode, made from a combination of values.

The supported calibration modes can be set to ECalibrationMode::ECalibrationMode_Raw, meaning that no calibration at all is performed (the World coordinates are pixel indices), or to the logical sum of other values from ECalibrationMode.

GetCenter()

eVision::EPoint eVision::ECameraCalibration::GetCenter

(

)

const

Pixel coordinates of the projection of the world center.

GetCustomMinDotArea()

int32_t eVision::ECameraCalibration::GetCustomMinDotArea

(

)

const

Gets the minimum dot area.

GetDefaultAxisSize()

float eVision::ECameraCalibration::GetDefaultAxisSize

(

)

const

The default size of axis when drawing with ECameraCalibration::Draw.

GetDistortionStrength()

float eVision::ECameraCalibration::GetDistortionStrength

(

)

const

Optical distortion strength (the ratio of the image diagonal length with and without optical distortion introduced by the lens).

GetFieldHeight()

float eVision::ECameraCalibration::GetFieldHeight

(

)

const

Field-of-view height, in physical units.

Field size not matching the sensor size results in non-square pixels.

Pixels having non-square aspect ratio. Beware there is a restriction pertaining to the allowed image anisotropy. The resulting pixels aspect ratio (XResolution/YResolution) should be in the range [-4/3, -3/4] (or [3/4, 4/3]), otherwise the calibration process could fail.

GetFieldWidth()

float eVision::ECameraCalibration::GetFieldWidth

(

)

const

Field-of-view width, in physical units.

Field size not matching the sensor size results in non-square pixels.

Pixels having non-square aspect ratio. Beware there is a restriction pertaining to the allowed image anisotropy. The resulting pixels aspect ratio (XResolution/YResolution) should be in the range [-4/3, -3/4] (or [3/4, 4/3]), otherwise the calibration process could fail.

GetGridPointsMaxVariation()

float eVision::ECameraCalibration::GetGridPointsMaxVariation

(

)

const

Maximum variation of grid points (maximum distance between computed grid points and ideal grid points in world space), normalized using the pitch values, after a call to ECameraCalibration::CalibrationSucceeded.

The maximum grid point variation is normalized using the pitch values.

GetGridPointsMaxVariationThreshold()

float eVision::ECameraCalibration::GetGridPointsMaxVariationThreshold

(

)

const

Grid points maximum variation threshold, that is the value above which the maximum variation of grid points (maximum distance between computed grid points and ideal grid points in world space) is considered too high, and thus marks the calibration as a failure when using ECameraCalibration::CalibrationSucceeded.

The maximum grid point variation is normalized using the pitch values.

GetGridPointsMeanVariation()

float eVision::ECameraCalibration::GetGridPointsMeanVariation

(

)

const

Mean variation of grid points (mean distance between computed grid points and ideal grid points in world space), normalized using the pitch values, after a call to ECameraCalibration::CalibrationSucceeded.

The mean grid point variation is normalized using the pitch values.

GetGridPointsMeanVariationThreshold()

float eVision::ECameraCalibration::GetGridPointsMeanVariationThreshold

(

)

const

Grid points mean variation threshold, that is the value above which the mean variation of grid points (mean distance between computed grid points and ideal grid points in world space) is considered too high, and thus marks the calibration as a failure when using ECameraCalibration::CalibrationSucceeded.

The mean grid point variation is normalized using the pitch values.

GetHasCustomMinDotArea()

bool eVision::ECameraCalibration::GetHasCustomMinDotArea

(

)

const

Returns if a custom minimum dot area has been previously set.

GetHitLandmark()

uint32_t eVision::ECameraCalibration::GetHitLandmark

(

)

Returns the landmark selected by ECameraCalibration::HitLandmarks or ~0 if no landmark is selected.

GetLandmark()

eVision::ELandmark eVision::ECameraCalibration::GetLandmark

(

uint32_t

i

)

const

Gets a landmark.

Parameters

i	Index of the landmark between 0 and ECameraCalibration::GetNumLandmark - 1

GetMaxSensorToWorldError()

float eVision::ECameraCalibration::GetMaxSensorToWorldError

(

)

const

Maximum SensorToWorld error over all valid landmarks (maximum distance between a landmark and its projection in world space using the calibrated model).

GetMaxWorldToSensorError()

float eVision::ECameraCalibration::GetMaxWorldToSensorError

(

)

const

Maximum WorldToSensor error over all valid landmarks (maximum distance between a landmark and its projection in the image using the calibrated model).

GetMeanSensorToWorldError()

float eVision::ECameraCalibration::GetMeanSensorToWorldError

(

)

const

Mean SensorToWorld error over all valid landmarks (root mean square error, RMSE).

GetMeanWorldToSensorError()

float eVision::ECameraCalibration::GetMeanWorldToSensorError

(

)

const

Mean WorldToSensor error over all valid landmarks (root mean square error, RMSE).

GetNumLandmark()

uint32_t eVision::ECameraCalibration::GetNumLandmark

(

)

const

Number of landmarks.

GetOpticalCenterX()

float eVision::ECameraCalibration::GetOpticalCenterX

(

)

const

X coordinate of the optical center of the sensor in the image (in pixels).

GetOpticalCenterY()

float eVision::ECameraCalibration::GetOpticalCenterY

(

)

const

Y coordinate of the optical center of the sensor in the image (in pixels).

GetPerspectiveStrength()

float eVision::ECameraCalibration::GetPerspectiveStrength

(

)

const

Perspective strength. This is the inverse of the distance between the optical center of the camera and the center of the world coordinate frame (observation distance).

GetRatio()

float eVision::ECameraCalibration::GetRatio

(

)

const

XResolution/YResolution ratio.

If Ratio equals -1 (or 1), pixels are square. Beware there is a restriction pertaining to the allowed image anisotropy. The resulting pixels aspect ratio (XResolution/YResolution) should be in the range [-4/3, -3/4] (or [3/4, 4/3]), otherwise the calibration process could fail.

GetReprojectionScore()

float eVision::ECameraCalibration::GetReprojectionScore

(

)

const

Reproject score (average squared distance between a landmark and its projection in the image using the calibrated model).

This score is the mean squared error (MSE) for the world to sensor transformation.

GetScale()

float eVision::ECameraCalibration::GetScale

(

)

const

Scale of the model (X resolution).

GetSensorHeight()

int32_t eVision::ECameraCalibration::GetSensorHeight

(

)

const

Logical image height, that is the number of pixels vertically.

GetSensorWidth()

int32_t eVision::ECameraCalibration::GetSensorWidth

(

)

const

Logical image width, that is the number of pixels horizontally.

GetTiltXAngle()

float eVision::ECameraCalibration::GetTiltXAngle

(

)

const

Tilt X angle, that is the amplitude of the rotation applied around the X-axis of the sensor to bring the optical (Z) axis perpendicular to the field of view.

Tilt X Angle and Tilt Y Angle

GetTiltYAngle()

float eVision::ECameraCalibration::GetTiltYAngle

(

)

const

Tilt Y angle, that is the amplitude of the rotation applied around the Y-axis of the sensor to bring the optical (Z) axis perpendicular to the field of view.

Tilt X Angle and Tilt Y Angle

GetUnwarpedCalibration() [1/4]

eVision::ECameraCalibration eVision::ECameraCalibration::GetUnwarpedCalibration

(

const eVision::EBaseROI *

sourceImage

)

const

Gets a ECameraCalibration instance representing the transformation of image to world coordinates for the result of ECameraCalibration::Unwarp.

Parameters

sourceImage

Image to unwarp.

GetUnwarpedCalibration() [2/4]

eVision::ECameraCalibration eVision::ECameraCalibration::GetUnwarpedCalibration	(	const eVision::EBaseROI *	sourceImage,
		bool	resizeDestination ) const

Gets a ECameraCalibration instance representing the transformation of image to world coordinates for the result of ECameraCalibration::Unwarp.

Parameters

sourceImage	Image to unwarp.
resizeDestination	Resize the destination image to match the unwarped image size. Default value is false.

GetUnwarpedCalibration() [3/4]

eVision::ECameraCalibration eVision::ECameraCalibration::GetUnwarpedCalibration	(	int32_t	sourceWidth,
		int32_t	sourceHeight ) const

Gets a ECameraCalibration instance representing the transformation of image to world coordinates for the result of ECameraCalibration::Unwarp.

Parameters

sourceWidth	Width of the image to unwarp.
sourceHeight	Height of the image to unwarp.

GetUnwarpedCalibration() [4/4]

eVision::ECameraCalibration eVision::ECameraCalibration::GetUnwarpedCalibration	(	int32_t	sourceWidth,
		int32_t	sourceHeight,
		bool	resizeDestination ) const

Gets a ECameraCalibration instance representing the transformation of image to world coordinates for the result of ECameraCalibration::Unwarp.

Parameters

sourceWidth	Width of the image to unwarp.
sourceHeight	Height of the image to unwarp.
resizeDestination	Resize the destination image to match the unwarped image size. Default value is false.

GetXResolution()

float eVision::ECameraCalibration::GetXResolution

(

)

const

Horizontal sensor resolution, in pixels per unit.

GetYResolution()

float eVision::ECameraCalibration::GetYResolution

(

)

const

Vertical sensor resolution, in pixels per unit.

HitLandmarks() [1/5]

void eVision::ECameraCalibration::HitLandmarks	(	int32_t	x,
		int32_t	y )

Checks if the cursor is placed over a landmark point.

Parameters

x	Current cursor coordinates.
y	Current cursor coordinates.

Landmark calibration is the process of computing the calibration parameters by means of a set of known points for which the coordinates are available in both World and Sensor spaces. Usually, such points are chosen as salient features on the part or target in view. They must be such that appropriate image processing techniques allow measuring their positions from the image (directly or indirectly by geometric constructions), while at the same time their coordinates in a reference frame are known.

HitLandmarks() [2/5]

void eVision::ECameraCalibration::HitLandmarks	(	int32_t	x,
		int32_t	y,
		float	zoomX )

Checks if the cursor is placed over a landmark point.

Parameters

x	Current cursor coordinates.
y	Current cursor coordinates.
zoomX	Horizontal zooming factor. By default, true scale is used.

Landmark calibration is the process of computing the calibration parameters by means of a set of known points for which the coordinates are available in both World and Sensor spaces. Usually, such points are chosen as salient features on the part or target in view. They must be such that appropriate image processing techniques allow measuring their positions from the image (directly or indirectly by geometric constructions), while at the same time their coordinates in a reference frame are known.

HitLandmarks() [3/5]

void eVision::ECameraCalibration::HitLandmarks	(	int32_t	x,
		int32_t	y,
		float	zoomX,
		float	zoomY )

Checks if the cursor is placed over a landmark point.

Parameters

x	Current cursor coordinates.
y	Current cursor coordinates.
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, to provide isotropic zooming.

Landmark calibration is the process of computing the calibration parameters by means of a set of known points for which the coordinates are available in both World and Sensor spaces. Usually, such points are chosen as salient features on the part or target in view. They must be such that appropriate image processing techniques allow measuring their positions from the image (directly or indirectly by geometric constructions), while at the same time their coordinates in a reference frame are known.

HitLandmarks() [4/5]

void eVision::ECameraCalibration::HitLandmarks	(	int32_t	x,
		int32_t	y,
		float	zoomX,
		float	zoomY,
		float	panX )

Checks if the cursor is placed over a landmark point.

Parameters

x	Current cursor coordinates.
y	Current cursor coordinates.
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

Landmark calibration is the process of computing the calibration parameters by means of a set of known points for which the coordinates are available in both World and Sensor spaces. Usually, such points are chosen as salient features on the part or target in view. They must be such that appropriate image processing techniques allow measuring their positions from the image (directly or indirectly by geometric constructions), while at the same time their coordinates in a reference frame are known.

HitLandmarks() [5/5]

void eVision::ECameraCalibration::HitLandmarks	(	int32_t	x,
		int32_t	y,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY )

Checks if the cursor is placed over a landmark point.

Parameters

x	Current cursor coordinates.
y	Current cursor coordinates.
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

Landmark calibration is the process of computing the calibration parameters by means of a set of known points for which the coordinates are available in both World and Sensor spaces. Usually, such points are chosen as salient features on the part or target in view. They must be such that appropriate image processing techniques allow measuring their positions from the image (directly or indirectly by geometric constructions), while at the same time their coordinates in a reference frame are known.

IsCalibrationAffine()

bool eVision::ECameraCalibration::IsCalibrationAffine

(

)

const

Whether the calibration is an affine transformation or not.

A calibration is affine when the ECameraCalibration::GetCalibrationModes do not include either ECalibrationMode::ECalibrationMode_Skewed, ECalibrationMode::ECalibrationMode_Radial, ECalibrationMode::ECalibrationMode_Advanced, or ECalibrationMode::ECalibrationMode_Quadratic.

Load() [1/2]

void eVision::ECameraCalibration::Load ( const std::string & path )

virtual

Loads the ECameraCalibration. The given ESerializer must have been created for reading.

Parameters

path	The file path.

Load() [2/2]

void eVision::ECameraCalibration::Load ( eVision::ESerializer * serializer )

virtual

Loads the ECameraCalibration. The given ESerializer must have been created for reading.

Parameters

serializer

The serializer.

operator=()

eVision::ECameraCalibration & eVision::ECameraCalibration::operator=

(

const eVision::ECameraCalibration &

other

)

Copy operator.

Parameters

other

Object from which to copy.

RebuildGrid() [1/6]

uint32_t eVision::ECameraCalibration::RebuildGrid	(	float	colPitch,
		float	rowPitch )

Reconstructs the grid of points from the given dot centers, to compute the World coordinates of the points.

Parameters

colPitch	Actual pitches of the grid, that are distances between vertical and horizontal rows of the grid.
rowPitch	Actual pitches of the grid, that are distances between vertical and horizontal rows of the grid.

This member function also returns the number of grid points that were connected. This prepares the calibration using landmarks (for use by member ECameraCalibration::Calibrate). Landmark calibration is the process of computing the calibration parameters by means of a set of known points for which the coordinates are available in both World and Sensor spaces. Usually, such points are chosen as salient features on the part or target in view. They must be such that appropriate image processing techniques allow measuring their positions from the image (directly or indirectly by geometric constructions), while at the same time their coordinates in a reference frame are known. See also Dot-Grid-Based Calibration for the grid construction algorithm.

RebuildGrid() [2/6]

uint32_t eVision::ECameraCalibration::RebuildGrid	(	float	colPitch,
		float	rowPitch,
		const eVision::EPoint &	worldCenter )

Reconstructs the grid of points from the given dot centers, to compute the World coordinates of the points.

Parameters

colPitch	Actual pitches of the grid, that are distances between vertical and horizontal rows of the grid.
rowPitch	Actual pitches of the grid, that are distances between vertical and horizontal rows of the grid.
worldCenter	World coordinates of the starting grid point.

This member function also returns the number of grid points that were connected. This prepares the calibration using landmarks (for use by member ECameraCalibration::Calibrate). Landmark calibration is the process of computing the calibration parameters by means of a set of known points for which the coordinates are available in both World and Sensor spaces. Usually, such points are chosen as salient features on the part or target in view. They must be such that appropriate image processing techniques allow measuring their positions from the image (directly or indirectly by geometric constructions), while at the same time their coordinates in a reference frame are known. See also Dot-Grid-Based Calibration for the grid construction algorithm.

RebuildGrid() [3/6]

uint32_t eVision::ECameraCalibration::RebuildGrid	(	float	colPitch,
		float	rowPitch,
		const eVision::EPoint &	worldCenter,
		uint32_t	centerIndex )

Reconstructs the grid of points from the given dot centers, to compute the World coordinates of the points.

Parameters

colPitch	Actual pitches of the grid, that are distances between vertical and horizontal rows of the grid.
rowPitch	Actual pitches of the grid, that are distances between vertical and horizontal rows of the grid.
worldCenter	World coordinates of the starting grid point.
centerIndex	Index of the grid point chosen as coordinate origin point. By default, the most central grid point.

This member function also returns the number of grid points that were connected. This prepares the calibration using landmarks (for use by member ECameraCalibration::Calibrate). Landmark calibration is the process of computing the calibration parameters by means of a set of known points for which the coordinates are available in both World and Sensor spaces. Usually, such points are chosen as salient features on the part or target in view. They must be such that appropriate image processing techniques allow measuring their positions from the image (directly or indirectly by geometric constructions), while at the same time their coordinates in a reference frame are known. See also Dot-Grid-Based Calibration for the grid construction algorithm.

RebuildGrid() [4/6]

uint32_t eVision::ECameraCalibration::RebuildGrid	(	float	colPitch,
		float	rowPitch,
		const eVision::EPoint &	worldCenter,
		uint32_t	centerIndex,
		bool	direct )

Reconstructs the grid of points from the given dot centers, to compute the World coordinates of the points.

Parameters

colPitch	Actual pitches of the grid, that are distances between vertical and horizontal rows of the grid.
rowPitch	Actual pitches of the grid, that are distances between vertical and horizontal rows of the grid.
worldCenter	World coordinates of the starting grid point.
centerIndex	Index of the grid point chosen as coordinate origin point. By default, the most central grid point.
direct	true if the world reference frame points upwards.

This member function also returns the number of grid points that were connected. This prepares the calibration using landmarks (for use by member ECameraCalibration::Calibrate). Landmark calibration is the process of computing the calibration parameters by means of a set of known points for which the coordinates are available in both World and Sensor spaces. Usually, such points are chosen as salient features on the part or target in view. They must be such that appropriate image processing techniques allow measuring their positions from the image (directly or indirectly by geometric constructions), while at the same time their coordinates in a reference frame are known. See also Dot-Grid-Based Calibration for the grid construction algorithm.

RebuildGrid() [5/6]

uint32_t eVision::ECameraCalibration::RebuildGrid	(	float	colPitch,
		float	rowPitch,
		uint32_t	centerIndex )

Reconstructs the grid of points from the given dot centers, to compute the World coordinates of the points.

Parameters

colPitch	Actual pitches of the grid, that are distances between vertical and horizontal rows of the grid.
rowPitch	Actual pitches of the grid, that are distances between vertical and horizontal rows of the grid.
centerIndex	Index of the grid point chosen as coordinate origin point. By default, the most central grid point.

This member function also returns the number of grid points that were connected. This prepares the calibration using landmarks (for use by member ECameraCalibration::Calibrate). Landmark calibration is the process of computing the calibration parameters by means of a set of known points for which the coordinates are available in both World and Sensor spaces. Usually, such points are chosen as salient features on the part or target in view. They must be such that appropriate image processing techniques allow measuring their positions from the image (directly or indirectly by geometric constructions), while at the same time their coordinates in a reference frame are known. See also Dot-Grid-Based Calibration for the grid construction algorithm.

RebuildGrid() [6/6]

uint32_t eVision::ECameraCalibration::RebuildGrid	(	float	colPitch,
		float	rowPitch,
		uint32_t	centerIndex,
		bool	direct )

Reconstructs the grid of points from the given dot centers, to compute the World coordinates of the points.

Parameters

colPitch	Actual pitches of the grid, that are distances between vertical and horizontal rows of the grid.
rowPitch	Actual pitches of the grid, that are distances between vertical and horizontal rows of the grid.
centerIndex	Index of the grid point chosen as coordinate origin point. By default, the most central grid point.
direct	true if the world reference frame points upwards.

This member function also returns the number of grid points that were connected. This prepares the calibration using landmarks (for use by member ECameraCalibration::Calibrate). Landmark calibration is the process of computing the calibration parameters by means of a set of known points for which the coordinates are available in both World and Sensor spaces. Usually, such points are chosen as salient features on the part or target in view. They must be such that appropriate image processing techniques allow measuring their positions from the image (directly or indirectly by geometric constructions), while at the same time their coordinates in a reference frame are known. See also Dot-Grid-Based Calibration for the grid construction algorithm.

RemoveLandmark()

void eVision::ECameraCalibration::RemoveLandmark

(

uint32_t

index

)

Removes a landmark.

Parameters

index

Index of the landmark to be removed.

ResetCustomMinDotArea()

void eVision::ECameraCalibration::ResetCustomMinDotArea

(

)

Resets the custom minimum dot area parameter. The heurestic described in SetMinDotArea is used again.

Save() [1/2]

void eVision::ECameraCalibration::Save ( const std::string & path )

virtual

Saves the ECameraCalibration. The given ESerializer must have been created for writing.

Parameters

path	The file path.

Save() [2/2]

void eVision::ECameraCalibration::Save ( eVision::ESerializer * serializer )

virtual

Saves the ECameraCalibration. The given ESerializer must have been created for writing.

Parameters

serializer

The ESerializer object that is written to.

SensorToWorld()

eVision::EPoint eVision::ECameraCalibration::SensorToWorld

(

const eVision::EPoint &

sensorPoint

)

const

Performs coordinate transform for arbitrary points from Sensor space to World space.

Parameters

sensorPoint

Sensor point.

For cameras with large distortions, reverting the distortion model for eccentric pixels (i.e. pixels near the border of the image) may not converge properly and may yield inaccurate results.

SetAffineCalibration() [1/4]

void eVision::ECameraCalibration::SetAffineCalibration	(	int32_t	sensorWidth,
		int32_t	sensorHeight,
		float	resolutionX,
		float	resolutionY )

Sets an affine calibration, i.e. a calibration model without distortion or perspective.

The ECameraCalibration::GetCalibrationModes will include ECalibrationMode::ECalibrationMode_Scaled and according to the arguments ECalibrationMode::ECalibrationMode_Anisotropic, ECalibrationMode::ECalibrationMode_Inverse, or ECalibrationMode::ECalibrationMode_Skewed.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.
resolutionX	Horizontal sensor resolution, in pixels per unit.
resolutionY	Vertical sensor resolution, in pixels per unit.

SetAffineCalibration() [2/4]

void eVision::ECameraCalibration::SetAffineCalibration	(	int32_t	sensorWidth,
		int32_t	sensorHeight,
		float	resolutionX,
		float	resolutionY,
		float	centerX )

Sets an affine calibration, i.e. a calibration model without distortion or perspective.

The ECameraCalibration::GetCalibrationModes will include ECalibrationMode::ECalibrationMode_Scaled and according to the arguments ECalibrationMode::ECalibrationMode_Anisotropic, ECalibrationMode::ECalibrationMode_Inverse, or ECalibrationMode::ECalibrationMode_Skewed.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.
resolutionX	Horizontal sensor resolution, in pixels per unit.
resolutionY	Vertical sensor resolution, in pixels per unit.
centerX	Pixel X coordinates of the projection of the world center.

SetAffineCalibration() [3/4]

void eVision::ECameraCalibration::SetAffineCalibration	(	int32_t	sensorWidth,
		int32_t	sensorHeight,
		float	resolutionX,
		float	resolutionY,
		float	centerX,
		float	centerY )

Sets an affine calibration, i.e. a calibration model without distortion or perspective.

The ECameraCalibration::GetCalibrationModes will include ECalibrationMode::ECalibrationMode_Scaled and according to the arguments ECalibrationMode::ECalibrationMode_Anisotropic, ECalibrationMode::ECalibrationMode_Inverse, or ECalibrationMode::ECalibrationMode_Skewed.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.
resolutionX	Horizontal sensor resolution, in pixels per unit.
resolutionY	Vertical sensor resolution, in pixels per unit.
centerX	Pixel X coordinates of the projection of the world center.
centerY	Pixel Y coordinates of the projection of the world center.

SetAffineCalibration() [4/4]

void eVision::ECameraCalibration::SetAffineCalibration	(	int32_t	sensorWidth,
		int32_t	sensorHeight,
		float	resolutionX,
		float	resolutionY,
		float	centerX,
		float	centerY,
		float	angle )

Sets an affine calibration, i.e. a calibration model without distortion or perspective.

The ECameraCalibration::GetCalibrationModes will include ECalibrationMode::ECalibrationMode_Scaled and according to the arguments ECalibrationMode::ECalibrationMode_Anisotropic, ECalibrationMode::ECalibrationMode_Inverse, or ECalibrationMode::ECalibrationMode_Skewed.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.
resolutionX	Horizontal sensor resolution, in pixels per unit.
resolutionY	Vertical sensor resolution, in pixels per unit.
centerX	Pixel X coordinates of the projection of the world center.
centerY	Pixel Y coordinates of the projection of the world center.
angle	Skew angle, i.e. angle formed by the axis of reference and the image edges. By default (argument omitted), no skewing effect is assumed.

SetCustomMinDotArea()

void eVision::ECameraCalibration::SetCustomMinDotArea

(

int32_t

areaSize

)

Sets the custom minimum dot area. The minimum dot area is used after the segmentation of the dots present in the grid to filter noise to only keep the actual dots used in the calibration. By default, a heuristic based on the dimension of the input image is used to define this value. This heuristic assumes that the dot area (in pixels) are larger than 1/50000th of the image area. Smaller objects are considered as noise.

Parameters

areaSize

Custom minimum dot area to us for filtering.

SetGridPointsMaxVariationThreshold()

void eVision::ECameraCalibration::SetGridPointsMaxVariationThreshold

(

float

maxVariationThreshold

)

Grid points maximum variation threshold, that is the value above which the maximum variation of grid points (maximum distance between computed grid points and ideal grid points in world space) is considered too high, and thus marks the calibration as a failure when using ECameraCalibration::CalibrationSucceeded.

The maximum grid point variation is normalized using the pitch values.

SetGridPointsMeanVariationThreshold()

void eVision::ECameraCalibration::SetGridPointsMeanVariationThreshold

(

float

meanVariationThreshold

)

Grid points mean variation threshold, that is the value above which the mean variation of grid points (mean distance between computed grid points and ideal grid points in world space) is considered too high, and thus marks the calibration as a failure when using ECameraCalibration::CalibrationSucceeded.

The mean grid point variation is normalized using the pitch values.

SetSensor() [1/13]

void eVision::ECameraCalibration::SetSensor	(	int32_t	sensorWidth,
		int32_t	sensorHeight )

Sensor characteristics.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.

The function automatically selects the appropriate calibration model by checking the parameters. The use of a more complex calibration mode can be enforced by means of parameter ECameraCalibration::GetCalibrationModes, not a simpler one.

SetSensor() [2/13]

void eVision::ECameraCalibration::SetSensor	(	int32_t	sensorWidth,
		int32_t	sensorHeight,
		float	fieldWidth )

Sensor characteristics.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.
fieldWidth	Physical size of the field of view. By default (argument omitted), the pixels are square.

The function automatically selects the appropriate calibration model by checking the parameters. The use of a more complex calibration mode can be enforced by means of parameter ECameraCalibration::GetCalibrationModes, not a simpler one.

SetSensor() [3/13]

void eVision::ECameraCalibration::SetSensor	(	int32_t	sensorWidth,
		int32_t	sensorHeight,
		float	fieldWidth,
		float	fieldHeight )

Sensor characteristics.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.
fieldWidth	Physical size of the field of view. By default (argument omitted), the pixels are square.
fieldHeight	Physical size of the field of view. By default (argument omitted), the pixels are square.

The function automatically selects the appropriate calibration model by checking the parameters. The use of a more complex calibration mode can be enforced by means of parameter ECameraCalibration::GetCalibrationModes, not a simpler one.

SetSensor() [4/13]

void eVision::ECameraCalibration::SetSensor	(	int32_t	sensorWidth,
		int32_t	sensorHeight,
		float	fieldWidth,
		float	fieldHeight,
		float	centerX )

Sensor characteristics.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.
fieldWidth	Physical size of the field of view. By default (argument omitted), the pixels are square.
fieldHeight	Physical size of the field of view. By default (argument omitted), the pixels are square.
centerX	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0. Otherwise, it is set to the image center.

The function automatically selects the appropriate calibration model by checking the parameters. The use of a more complex calibration mode can be enforced by means of parameter ECameraCalibration::GetCalibrationModes, not a simpler one.

SetSensor() [5/13]

void eVision::ECameraCalibration::SetSensor	(	int32_t	sensorWidth,
		int32_t	sensorHeight,
		float	fieldWidth,
		float	fieldHeight,
		float	centerX,
		float	centerY )

Sensor characteristics.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.
fieldWidth	Physical size of the field of view. By default (argument omitted), the pixels are square.
fieldHeight	Physical size of the field of view. By default (argument omitted), the pixels are square.
centerX	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0. Otherwise, it is set to the image center.
centerY	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain ECalibrationMode::ECalibrationMode_Inverse). Otherwise, it is set to the image center.

The function automatically selects the appropriate calibration model by checking the parameters. The use of a more complex calibration mode can be enforced by means of parameter ECameraCalibration::GetCalibrationModes, not a simpler one.

SetSensor() [6/13]

void eVision::ECameraCalibration::SetSensor	(	int32_t	sensorWidth,
		int32_t	sensorHeight,
		float	fieldWidth,
		float	fieldHeight,
		float	centerX,
		float	centerY,
		float	angle )

Sensor characteristics.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.
fieldWidth	Physical size of the field of view. By default (argument omitted), the pixels are square.
fieldHeight	Physical size of the field of view. By default (argument omitted), the pixels are square.
centerX	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0. Otherwise, it is set to the image center.
centerY	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain ECalibrationMode::ECalibrationMode_Inverse). Otherwise, it is set to the image center.
angle	Skew angle, i.e. angle formed by the axis of reference and the image edges. By default (argument omitted), no skewing effect is assumed.

The function automatically selects the appropriate calibration model by checking the parameters. The use of a more complex calibration mode can be enforced by means of parameter ECameraCalibration::GetCalibrationModes, not a simpler one.

SetSensor() [7/13]

void eVision::ECameraCalibration::SetSensor	(	int32_t	sensorWidth,
		int32_t	sensorHeight,
		float	fieldWidth,
		float	fieldHeight,
		float	centerX,
		float	centerY,
		float	angle,
		float	tiltXAngle )

Sensor characteristics.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.
fieldWidth	Physical size of the field of view. By default (argument omitted), the pixels are square.
fieldHeight	Physical size of the field of view. By default (argument omitted), the pixels are square.
centerX	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0. Otherwise, it is set to the image center.
centerY	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain ECalibrationMode::ECalibrationMode_Inverse). Otherwise, it is set to the image center.
angle	Skew angle, i.e. angle formed by the axis of reference and the image edges. By default (argument omitted), no skewing effect is assumed.
tiltXAngle	Rotation angles on the X axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.

The function automatically selects the appropriate calibration model by checking the parameters. The use of a more complex calibration mode can be enforced by means of parameter ECameraCalibration::GetCalibrationModes, not a simpler one.

SetSensor() [8/13]

void eVision::ECameraCalibration::SetSensor	(	int32_t	sensorWidth,
		int32_t	sensorHeight,
		float	fieldWidth,
		float	fieldHeight,
		float	centerX,
		float	centerY,
		float	angle,
		float	tiltXAngle,
		float	tiltYAngle )

Sensor characteristics.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.
fieldWidth	Physical size of the field of view. By default (argument omitted), the pixels are square.
fieldHeight	Physical size of the field of view. By default (argument omitted), the pixels are square.
centerX	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0. Otherwise, it is set to the image center.
centerY	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain ECalibrationMode::ECalibrationMode_Inverse). Otherwise, it is set to the image center.
angle	Skew angle, i.e. angle formed by the axis of reference and the image edges. By default (argument omitted), no skewing effect is assumed.
tiltXAngle	Rotation angles on the X axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.
tiltYAngle	Rotation angles on the Y axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.

The function automatically selects the appropriate calibration model by checking the parameters. The use of a more complex calibration mode can be enforced by means of parameter ECameraCalibration::GetCalibrationModes, not a simpler one.

SetSensor() [9/13]

void eVision::ECameraCalibration::SetSensor	(	int32_t	sensorWidth,
		int32_t	sensorHeight,
		float	fieldWidth,
		float	fieldHeight,
		float	centerX,
		float	centerY,
		float	angle,
		float	tiltXAngle,
		float	tiltYAngle,
		float	perspectiveStrength )

Sensor characteristics.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.
fieldWidth	Physical size of the field of view. By default (argument omitted), the pixels are square.
fieldHeight	Physical size of the field of view. By default (argument omitted), the pixels are square.
centerX	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0. Otherwise, it is set to the image center.
centerY	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain ECalibrationMode::ECalibrationMode_Inverse). Otherwise, it is set to the image center.
angle	Skew angle, i.e. angle formed by the axis of reference and the image edges. By default (argument omitted), no skewing effect is assumed.
tiltXAngle	Rotation angles on the X axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.
tiltYAngle	Rotation angles on the Y axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.
perspectiveStrength	Relative importance of the perspective effect. By default, no perspective effect is assumed, as if the lens was telecentric.

The function automatically selects the appropriate calibration model by checking the parameters. The use of a more complex calibration mode can be enforced by means of parameter ECameraCalibration::GetCalibrationModes, not a simpler one.

SetSensor() [10/13]

void eVision::ECameraCalibration::SetSensor	(	int32_t	sensorWidth,
		int32_t	sensorHeight,
		float	fieldWidth,
		float	fieldHeight,
		float	centerX,
		float	centerY,
		float	angle,
		float	tiltXAngle,
		float	tiltYAngle,
		float	perspectiveStrength,
		float	distortionStrength )

Sensor characteristics.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.
fieldWidth	Physical size of the field of view. By default (argument omitted), the pixels are square.
fieldHeight	Physical size of the field of view. By default (argument omitted), the pixels are square.
centerX	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0. Otherwise, it is set to the image center.
centerY	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain ECalibrationMode::ECalibrationMode_Inverse). Otherwise, it is set to the image center.
angle	Skew angle, i.e. angle formed by the axis of reference and the image edges. By default (argument omitted), no skewing effect is assumed.
tiltXAngle	Rotation angles on the X axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.
tiltYAngle	Rotation angles on the Y axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.
perspectiveStrength	Relative importance of the perspective effect. By default, no perspective effect is assumed, as if the lens was telecentric.
distortionStrength	Relative importance of the lens radial distortion. Positive for barrel, negative for cushion. By default (argument omitted), no optical distortion is assumed.

The function automatically selects the appropriate calibration model by checking the parameters. The use of a more complex calibration mode can be enforced by means of parameter ECameraCalibration::GetCalibrationModes, not a simpler one.

SetSensor() [11/13]

void eVision::ECameraCalibration::SetSensor	(	int32_t	sensorWidth,
		int32_t	sensorHeight,
		float	fieldWidth,
		float	fieldHeight,
		float	centerX,
		float	centerY,
		float	angle,
		float	tiltXAngle,
		float	tiltYAngle,
		float	perspectiveStrength,
		float	distortionStrength,
		float	opticalCenterX )

Sensor characteristics.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.
fieldWidth	Physical size of the field of view. By default (argument omitted), the pixels are square.
fieldHeight	Physical size of the field of view. By default (argument omitted), the pixels are square.
centerX	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0. Otherwise, it is set to the image center.
centerY	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain ECalibrationMode::ECalibrationMode_Inverse). Otherwise, it is set to the image center.
angle	Skew angle, i.e. angle formed by the axis of reference and the image edges. By default (argument omitted), no skewing effect is assumed.
tiltXAngle	Rotation angles on the X axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.
tiltYAngle	Rotation angles on the Y axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.
perspectiveStrength	Relative importance of the perspective effect. By default, no perspective effect is assumed, as if the lens was telecentric.
distortionStrength	Relative importance of the lens radial distortion. Positive for barrel, negative for cushion. By default (argument omitted), no optical distortion is assumed.
opticalCenterX	X Position of the "intersection" between the optical axis and the field of view in the image. By default (argument omitted) the image center.

The function automatically selects the appropriate calibration model by checking the parameters. The use of a more complex calibration mode can be enforced by means of parameter ECameraCalibration::GetCalibrationModes, not a simpler one.

SetSensor() [12/13]

void eVision::ECameraCalibration::SetSensor	(	int32_t	sensorWidth,
		int32_t	sensorHeight,
		float	fieldWidth,
		float	fieldHeight,
		float	centerX,
		float	centerY,
		float	angle,
		float	tiltXAngle,
		float	tiltYAngle,
		float	perspectiveStrength,
		float	distortionStrength,
		float	opticalCenterX,
		float	opticalCenterY )

Sensor characteristics.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.
fieldWidth	Physical size of the field of view. By default (argument omitted), the pixels are square.
fieldHeight	Physical size of the field of view. By default (argument omitted), the pixels are square.
centerX	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0. Otherwise, it is set to the image center.
centerY	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain ECalibrationMode::ECalibrationMode_Inverse). Otherwise, it is set to the image center.
angle	Skew angle, i.e. angle formed by the axis of reference and the image edges. By default (argument omitted), no skewing effect is assumed.
tiltXAngle	Rotation angles on the X axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.
tiltYAngle	Rotation angles on the Y axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.
perspectiveStrength	Relative importance of the perspective effect. By default, no perspective effect is assumed, as if the lens was telecentric.
distortionStrength	Relative importance of the lens radial distortion. Positive for barrel, negative for cushion. By default (argument omitted), no optical distortion is assumed.
opticalCenterX	X Position of the "intersection" between the optical axis and the field of view in the image. By default (argument omitted) the image center.
opticalCenterY	Y Position of the "intersection" between the optical axis and the field of view in the image. By default (argument omitted) the image center.

The function automatically selects the appropriate calibration model by checking the parameters. The use of a more complex calibration mode can be enforced by means of parameter ECameraCalibration::GetCalibrationModes, not a simpler one.

SetSensor() [13/13]

void eVision::ECameraCalibration::SetSensor	(	int32_t	sensorWidth,
		int32_t	sensorHeight,
		float	fieldWidth,
		float	fieldHeight,
		float	centerX,
		float	centerY,
		float	angle,
		float	tiltXAngle,
		float	tiltYAngle,
		float	perspectiveStrength,
		float	distortionStrength,
		float	opticalCenterX,
		float	opticalCenterY,
		uint32_t	calibrationModes )

Sensor characteristics.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.
fieldWidth	Physical size of the field of view. By default (argument omitted), the pixels are square.
fieldHeight	Physical size of the field of view. By default (argument omitted), the pixels are square.
centerX	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0. Otherwise, it is set to the image center.
centerY	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain ECalibrationMode::ECalibrationMode_Inverse). Otherwise, it is set to the image center.
angle	Skew angle, i.e. angle formed by the axis of reference and the image edges. By default (argument omitted), no skewing effect is assumed.
tiltXAngle	Rotation angles on the X axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.
tiltYAngle	Rotation angles on the Y axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.
perspectiveStrength	Relative importance of the perspective effect. By default, no perspective effect is assumed, as if the lens was telecentric.
distortionStrength	Relative importance of the lens radial distortion. Positive for barrel, negative for cushion. By default (argument omitted), no optical distortion is assumed.
opticalCenterX	X Position of the "intersection" between the optical axis and the field of view in the image. By default (argument omitted) the image center.
opticalCenterY	Y Position of the "intersection" between the optical axis and the field of view in the image. By default (argument omitted) the image center.
calibrationModes	Desired calibration mode effects to be combined, as defined by ECalibrationMode. By default (argument omitted), the simplest model compatible with the given parameters is chosen.

The function automatically selects the appropriate calibration model by checking the parameters. The use of a more complex calibration mode can be enforced by means of parameter ECameraCalibration::GetCalibrationModes, not a simpler one.

SetSensorSize()

void eVision::ECameraCalibration::SetSensorSize	(	int32_t	sensorWidth,
		int32_t	sensorHeight )

Sets the logical image size, i.e. the number of pixels horizontally and vertically and sets the optical center to be at the center of the image.

Parameters

sensorWidth	Full image logical sizes, in pixels.
sensorHeight	Full image logical sizes, in pixels.

SetSensorUsingResolution() [1/13]

void eVision::ECameraCalibration::SetSensorUsingResolution	(	int32_t	sensorWidth,
		int32_t	sensorHeight )

Sensor characteristics.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.

The function automatically selects the appropriate calibration model by checking the parameters. The use of a more complex calibration mode can be enforced by means of parameter ECameraCalibration::GetCalibrationModes, not a simpler one.

SetSensorUsingResolution() [2/13]

void eVision::ECameraCalibration::SetSensorUsingResolution	(	int32_t	sensorWidth,
		int32_t	sensorHeight,
		float	resolutionX )

Sensor characteristics.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.
resolutionX	Horizontal sensor resolution, in pixels per unit.

The function automatically selects the appropriate calibration model by checking the parameters. The use of a more complex calibration mode can be enforced by means of parameter ECameraCalibration::GetCalibrationModes, not a simpler one.

SetSensorUsingResolution() [3/13]

void eVision::ECameraCalibration::SetSensorUsingResolution	(	int32_t	sensorWidth,
		int32_t	sensorHeight,
		float	resolutionX,
		float	resolutionY )

Sensor characteristics.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.
resolutionX	Horizontal sensor resolution, in pixels per unit.
resolutionY	Vertical sensor resolution, in pixels per unit.

The function automatically selects the appropriate calibration model by checking the parameters. The use of a more complex calibration mode can be enforced by means of parameter ECameraCalibration::GetCalibrationModes, not a simpler one.

SetSensorUsingResolution() [4/13]

void eVision::ECameraCalibration::SetSensorUsingResolution	(	int32_t	sensorWidth,
		int32_t	sensorHeight,
		float	resolutionX,
		float	resolutionY,
		float	centerX )

Sensor characteristics.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.
resolutionX	Horizontal sensor resolution, in pixels per unit.
resolutionY	Vertical sensor resolution, in pixels per unit.
centerX	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0. Otherwise, it is set to the image center.

The function automatically selects the appropriate calibration model by checking the parameters. The use of a more complex calibration mode can be enforced by means of parameter ECameraCalibration::GetCalibrationModes, not a simpler one.

SetSensorUsingResolution() [5/13]

void eVision::ECameraCalibration::SetSensorUsingResolution	(	int32_t	sensorWidth,
		int32_t	sensorHeight,
		float	resolutionX,
		float	resolutionY,
		float	centerX,
		float	centerY )

Sensor characteristics.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.
resolutionX	Horizontal sensor resolution, in pixels per unit.
resolutionY	Vertical sensor resolution, in pixels per unit.
centerX	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0. Otherwise, it is set to the image center.
centerY	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain ECalibrationMode::ECalibrationMode_Inverse). Otherwise, it is set to the image center.

The function automatically selects the appropriate calibration model by checking the parameters. The use of a more complex calibration mode can be enforced by means of parameter ECameraCalibration::GetCalibrationModes, not a simpler one.

SetSensorUsingResolution() [6/13]

void eVision::ECameraCalibration::SetSensorUsingResolution	(	int32_t	sensorWidth,
		int32_t	sensorHeight,
		float	resolutionX,
		float	resolutionY,
		float	centerX,
		float	centerY,
		float	angle )

Sensor characteristics.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.
resolutionX	Horizontal sensor resolution, in pixels per unit.
resolutionY	Vertical sensor resolution, in pixels per unit.
centerX	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0. Otherwise, it is set to the image center.
centerY	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain ECalibrationMode::ECalibrationMode_Inverse). Otherwise, it is set to the image center.
angle	Skew angle, i.e. angle formed by the axis of reference and the image edges. By default (argument omitted), no skewing effect is assumed.

The function automatically selects the appropriate calibration model by checking the parameters. The use of a more complex calibration mode can be enforced by means of parameter ECameraCalibration::GetCalibrationModes, not a simpler one.

SetSensorUsingResolution() [7/13]

void eVision::ECameraCalibration::SetSensorUsingResolution	(	int32_t	sensorWidth,
		int32_t	sensorHeight,
		float	resolutionX,
		float	resolutionY,
		float	centerX,
		float	centerY,
		float	angle,
		float	tiltXAngle )

Sensor characteristics.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.
resolutionX	Horizontal sensor resolution, in pixels per unit.
resolutionY	Vertical sensor resolution, in pixels per unit.
centerX	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0. Otherwise, it is set to the image center.
centerY	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain ECalibrationMode::ECalibrationMode_Inverse). Otherwise, it is set to the image center.
angle	Skew angle, i.e. angle formed by the axis of reference and the image edges. By default (argument omitted), no skewing effect is assumed.
tiltXAngle	Rotation angles on the X axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.

The function automatically selects the appropriate calibration model by checking the parameters. The use of a more complex calibration mode can be enforced by means of parameter ECameraCalibration::GetCalibrationModes, not a simpler one.

SetSensorUsingResolution() [8/13]

void eVision::ECameraCalibration::SetSensorUsingResolution	(	int32_t	sensorWidth,
		int32_t	sensorHeight,
		float	resolutionX,
		float	resolutionY,
		float	centerX,
		float	centerY,
		float	angle,
		float	tiltXAngle,
		float	tiltYAngle )

Sensor characteristics.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.
resolutionX	Horizontal sensor resolution, in pixels per unit.
resolutionY	Vertical sensor resolution, in pixels per unit.
centerX	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0. Otherwise, it is set to the image center.
centerY	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain ECalibrationMode::ECalibrationMode_Inverse). Otherwise, it is set to the image center.
angle	Skew angle, i.e. angle formed by the axis of reference and the image edges. By default (argument omitted), no skewing effect is assumed.
tiltXAngle	Rotation angles on the X axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.
tiltYAngle	Rotation angles on the Y axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.

The function automatically selects the appropriate calibration model by checking the parameters. The use of a more complex calibration mode can be enforced by means of parameter ECameraCalibration::GetCalibrationModes, not a simpler one.

SetSensorUsingResolution() [9/13]

void eVision::ECameraCalibration::SetSensorUsingResolution	(	int32_t	sensorWidth,
		int32_t	sensorHeight,
		float	resolutionX,
		float	resolutionY,
		float	centerX,
		float	centerY,
		float	angle,
		float	tiltXAngle,
		float	tiltYAngle,
		float	perspectiveStrength )

Sensor characteristics.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.
resolutionX	Horizontal sensor resolution, in pixels per unit.
resolutionY	Vertical sensor resolution, in pixels per unit.
centerX	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0. Otherwise, it is set to the image center.
centerY	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain ECalibrationMode::ECalibrationMode_Inverse). Otherwise, it is set to the image center.
angle	Skew angle, i.e. angle formed by the axis of reference and the image edges. By default (argument omitted), no skewing effect is assumed.
tiltXAngle	Rotation angles on the X axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.
tiltYAngle	Rotation angles on the Y axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.
perspectiveStrength	Relative importance of the perspective effect. By default, no perspective effect is assumed, as if the lens was telecentric.

The function automatically selects the appropriate calibration model by checking the parameters. The use of a more complex calibration mode can be enforced by means of parameter ECameraCalibration::GetCalibrationModes, not a simpler one.

SetSensorUsingResolution() [10/13]

void eVision::ECameraCalibration::SetSensorUsingResolution	(	int32_t	sensorWidth,
		int32_t	sensorHeight,
		float	resolutionX,
		float	resolutionY,
		float	centerX,
		float	centerY,
		float	angle,
		float	tiltXAngle,
		float	tiltYAngle,
		float	perspectiveStrength,
		float	distortionStrength )

Sensor characteristics.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.
resolutionX	Horizontal sensor resolution, in pixels per unit.
resolutionY	Vertical sensor resolution, in pixels per unit.
centerX	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0. Otherwise, it is set to the image center.
centerY	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain ECalibrationMode::ECalibrationMode_Inverse). Otherwise, it is set to the image center.
angle	Skew angle, i.e. angle formed by the axis of reference and the image edges. By default (argument omitted), no skewing effect is assumed.
tiltXAngle	Rotation angles on the X axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.
tiltYAngle	Rotation angles on the Y axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.
perspectiveStrength	Relative importance of the perspective effect. By default, no perspective effect is assumed, as if the lens was telecentric.
distortionStrength	Relative importance of the lens radial distortion. Positive for barrel, negative for cushion. By default (argument omitted), no optical distortion is assumed.

The function automatically selects the appropriate calibration model by checking the parameters. The use of a more complex calibration mode can be enforced by means of parameter ECameraCalibration::GetCalibrationModes, not a simpler one.

SetSensorUsingResolution() [11/13]

void eVision::ECameraCalibration::SetSensorUsingResolution	(	int32_t	sensorWidth,
		int32_t	sensorHeight,
		float	resolutionX,
		float	resolutionY,
		float	centerX,
		float	centerY,
		float	angle,
		float	tiltXAngle,
		float	tiltYAngle,
		float	perspectiveStrength,
		float	distortionStrength,
		float	opticalCenterX )

Sensor characteristics.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.
resolutionX	Horizontal sensor resolution, in pixels per unit.
resolutionY	Vertical sensor resolution, in pixels per unit.
centerX	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0. Otherwise, it is set to the image center.
centerY	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain ECalibrationMode::ECalibrationMode_Inverse). Otherwise, it is set to the image center.
angle	Skew angle, i.e. angle formed by the axis of reference and the image edges. By default (argument omitted), no skewing effect is assumed.
tiltXAngle	Rotation angles on the X axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.
tiltYAngle	Rotation angles on the Y axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.
perspectiveStrength	Relative importance of the perspective effect. By default, no perspective effect is assumed, as if the lens was telecentric.
distortionStrength	Relative importance of the lens radial distortion. Positive for barrel, negative for cushion. By default (argument omitted), no optical distortion is assumed.
opticalCenterX	X Position of the "intersection" between the optical axis and the field of view in the image. By default (argument omitted) the image center.

The function automatically selects the appropriate calibration model by checking the parameters. The use of a more complex calibration mode can be enforced by means of parameter ECameraCalibration::GetCalibrationModes, not a simpler one.

SetSensorUsingResolution() [12/13]

void eVision::ECameraCalibration::SetSensorUsingResolution	(	int32_t	sensorWidth,
		int32_t	sensorHeight,
		float	resolutionX,
		float	resolutionY,
		float	centerX,
		float	centerY,
		float	angle,
		float	tiltXAngle,
		float	tiltYAngle,
		float	perspectiveStrength,
		float	distortionStrength,
		float	opticalCenterX,
		float	opticalCenterY )

Sensor characteristics.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.
resolutionX	Horizontal sensor resolution, in pixels per unit.
resolutionY	Vertical sensor resolution, in pixels per unit.
centerX	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0. Otherwise, it is set to the image center.
centerY	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain ECalibrationMode::ECalibrationMode_Inverse). Otherwise, it is set to the image center.
angle	Skew angle, i.e. angle formed by the axis of reference and the image edges. By default (argument omitted), no skewing effect is assumed.
tiltXAngle	Rotation angles on the X axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.
tiltYAngle	Rotation angles on the Y axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.
perspectiveStrength	Relative importance of the perspective effect. By default, no perspective effect is assumed, as if the lens was telecentric.
distortionStrength	Relative importance of the lens radial distortion. Positive for barrel, negative for cushion. By default (argument omitted), no optical distortion is assumed.
opticalCenterX	X Position of the "intersection" between the optical axis and the field of view in the image. By default (argument omitted) the image center.
opticalCenterY	Y Position of the "intersection" between the optical axis and the field of view in the image. By default (argument omitted) the image center.

The function automatically selects the appropriate calibration model by checking the parameters. The use of a more complex calibration mode can be enforced by means of parameter ECameraCalibration::GetCalibrationModes, not a simpler one.

SetSensorUsingResolution() [13/13]

void eVision::ECameraCalibration::SetSensorUsingResolution	(	int32_t	sensorWidth,
		int32_t	sensorHeight,
		float	resolutionX,
		float	resolutionY,
		float	centerX,
		float	centerY,
		float	angle,
		float	tiltXAngle,
		float	tiltYAngle,
		float	perspectiveStrength,
		float	distortionStrength,
		float	opticalCenterX,
		float	opticalCenterY,
		uint32_t	calibrationModes )

Sensor characteristics.

Parameters

sensorWidth	Logical size of the field of view, i.e. image size, in pixels.
sensorHeight	Logical size of the field of view, i.e. image size, in pixels.
resolutionX	Horizontal sensor resolution, in pixels per unit.
resolutionY	Vertical sensor resolution, in pixels per unit.
centerX	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0. Otherwise, it is set to the image center.
centerY	Position of the "intersection" between the optical axis and the field of view in the image. By default, if the calibration modes contain ECalibrationMode::ECalibrationMode_Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain ECalibrationMode::ECalibrationMode_Inverse). Otherwise, it is set to the image center.
angle	Skew angle, i.e. angle formed by the axis of reference and the image edges. By default (argument omitted), no skewing effect is assumed.
tiltXAngle	Rotation angles on the X axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.
tiltYAngle	Rotation angles on the Y axis to bring the optical axis perpendicular to the image plane. By default (argument omitted), no perspective effect is assumed.
perspectiveStrength	Relative importance of the perspective effect. By default, no perspective effect is assumed, as if the lens was telecentric.
distortionStrength	Relative importance of the lens radial distortion. Positive for barrel, negative for cushion. By default (argument omitted), no optical distortion is assumed.
opticalCenterX	X Position of the "intersection" between the optical axis and the field of view in the image. By default (argument omitted) the image center.
opticalCenterY	Y Position of the "intersection" between the optical axis and the field of view in the image. By default (argument omitted) the image center.
calibrationModes	Desired calibration mode effects to be combined, as defined by ECalibrationMode. By default (argument omitted), the simplest model compatible with the given parameters is chosen.

The function automatically selects the appropriate calibration model by checking the parameters. The use of a more complex calibration mode can be enforced by means of parameter ECameraCalibration::GetCalibrationModes, not a simpler one.

SetupUnwarp() [1/6]

void eVision::ECameraCalibration::SetupUnwarp	(	eVision::EUnwarpingLut *	lookupTable,
		const eVision::EROIBW8 *	sourceImage ) const

Prepares a lookup table for fast image unwarping.

Parameters

lookupTable	Pointer to the lookup table.
sourceImage	Pointer to the source image/ROI.

The function should be called each time the system is re-calibrated (after the optical setup has been changed, for instance).

A sample source image has to be supplied to this method, and its row pitch is recorded in order to speed up the unwarping process. This implies that the following calls to ECameraCalibration::Unwarp are not allowed to use images with row pitches different from the source image initially supplied to this method.

SetupUnwarp() [2/6]

void eVision::ECameraCalibration::SetupUnwarp	(	eVision::EUnwarpingLut *	lookupTable,
		const eVision::EROIBW8 *	sourceImage,
		bool	interpolate ) const

Prepares a lookup table for fast image unwarping.

Parameters

lookupTable	Pointer to the lookup table.
sourceImage	Pointer to the source image/ROI.
interpolate	Interpolation mode. Default value is true.

The function should be called each time the system is re-calibrated (after the optical setup has been changed, for instance).

A sample source image has to be supplied to this method, and its row pitch is recorded in order to speed up the unwarping process. This implies that the following calls to ECameraCalibration::Unwarp are not allowed to use images with row pitches different from the source image initially supplied to this method.

SetupUnwarp() [3/6]

void eVision::ECameraCalibration::SetupUnwarp	(	eVision::EUnwarpingLut *	lookupTable,
		const eVision::EROIBW8 *	sourceImage,
		bool	interpolate,
		bool	resizeDestination ) const

Prepares a lookup table for fast image unwarping.

Parameters

lookupTable	Pointer to the lookup table.
sourceImage	Pointer to the source image/ROI.
interpolate	Interpolation mode. Default value is true.
resizeDestination	Resize the destination image to match the unwarped image size. Default value is false.

The function should be called each time the system is re-calibrated (after the optical setup has been changed, for instance).

A sample source image has to be supplied to this method, and its row pitch is recorded in order to speed up the unwarping process. This implies that the following calls to ECameraCalibration::Unwarp are not allowed to use images with row pitches different from the source image initially supplied to this method.

SetupUnwarp() [4/6]

void eVision::ECameraCalibration::SetupUnwarp	(	eVision::EUnwarpingLut *	lookupTable,
		const eVision::EROIC24 *	sourceImage ) const

Prepares a lookup table for fast image unwarping.

Parameters

lookupTable	Pointer to the lookup table.
sourceImage	Pointer to the source image/ROI.

The function should be called each time the system is re-calibrated (after the optical setup has been changed, for instance).

A sample source image has to be supplied to this method, and its row pitch is recorded in order to speed up the unwarping process. This implies that the following calls to ECameraCalibration::Unwarp are not allowed to use images with row pitches different from the source image initially supplied to this method.

SetupUnwarp() [5/6]

void eVision::ECameraCalibration::SetupUnwarp	(	eVision::EUnwarpingLut *	lookupTable,
		const eVision::EROIC24 *	sourceImage,
		bool	interpolate ) const

Prepares a lookup table for fast image unwarping.

Parameters

lookupTable	Pointer to the lookup table.
sourceImage	Pointer to the source image/ROI.
interpolate	Interpolation mode. Default value is true.

The function should be called each time the system is re-calibrated (after the optical setup has been changed, for instance).

A sample source image has to be supplied to this method, and its row pitch is recorded in order to speed up the unwarping process. This implies that the following calls to ECameraCalibration::Unwarp are not allowed to use images with row pitches different from the source image initially supplied to this method.

SetupUnwarp() [6/6]

void eVision::ECameraCalibration::SetupUnwarp	(	eVision::EUnwarpingLut *	lookupTable,
		const eVision::EROIC24 *	sourceImage,
		bool	interpolate,
		bool	resizeDestination ) const

Prepares a lookup table for fast image unwarping.

Parameters

lookupTable	Pointer to the lookup table.
sourceImage	Pointer to the source image/ROI.
interpolate	Interpolation mode. Default value is true.
resizeDestination	Resize the destination image to match the unwarped image size. Default value is false.

The function should be called each time the system is re-calibrated (after the optical setup has been changed, for instance).

A sample source image has to be supplied to this method, and its row pitch is recorded in order to speed up the unwarping process. This implies that the following calls to ECameraCalibration::Unwarp are not allowed to use images with row pitches different from the source image initially supplied to this method.

ToFrame()

eVision::EFrame eVision::ECameraCalibration::ToFrame

(

)

const

Converts the calibration to a EFrame where the global coordinates are the world coordinates.

This is equivalent to constructing a EFrame with the calibration object as parameter.

Unwarp() [1/20]

void eVision::ECameraCalibration::Unwarp	(	const eVision::EROIBW8 *	sourceImage,
		eVision::EROIBW8 *	destinationImage ) const

Unwarps a distorted image using the current calibration model.

Parameters

sourceImage	Pointer to the source image/ROI.
destinationImage	Pointer to the destination unwarped image. If optional parameter resizeDestination is false (default value) then the source and destination images must have the same size.

Using a precomputed lookup table allows speeding up the unwarping process. The lookup table is initialized by means of the ECameraCalibration::SetupUnwarp function.

Unwarp() [2/20]

void eVision::ECameraCalibration::Unwarp	(	const eVision::EROIBW8 *	sourceImage,
		eVision::EROIBW8 *	destinationImage,
		bool	interpolate ) const

Unwarps a distorted image using the current calibration model.

Parameters

sourceImage	Pointer to the source image/ROI.
destinationImage	Pointer to the destination unwarped image. If optional parameter resizeDestination is false (default value) then the source and destination images must have the same size.
interpolate	Interpolation mode. Default value is true.

Using a precomputed lookup table allows speeding up the unwarping process. The lookup table is initialized by means of the ECameraCalibration::SetupUnwarp function.

Unwarp() [3/20]

void eVision::ECameraCalibration::Unwarp	(	const eVision::EROIBW8 *	sourceImage,
		eVision::EROIBW8 *	destinationImage,
		bool	interpolate,
		bool	resizeDestination ) const

Unwarps a distorted image using the current calibration model.

Parameters

sourceImage	Pointer to the source image/ROI.
destinationImage	Pointer to the destination unwarped image. If optional parameter resizeDestination is false (default value) then the source and destination images must have the same size.
interpolate	Interpolation mode. Default value is true.
resizeDestination	Resize the destination image to match the unwarped image size. Default value is false.

Using a precomputed lookup table allows speeding up the unwarping process. The lookup table is initialized by means of the ECameraCalibration::SetupUnwarp function.

Unwarp() [4/20]

void eVision::ECameraCalibration::Unwarp	(	const eVision::EROIBW8 *	sourceImage,
		eVision::EROIBW8 *	destinationImage,
		eVision::ERegion &	region ) const

Unwarps a distorted image using the current calibration model.

Parameters

sourceImage	Pointer to the source image/ROI.
destinationImage	Pointer to the destination unwarped image. If optional parameter resizeDestination is false (default value) then the source and destination images must have the same size.
region	Output region.

Using a precomputed lookup table allows speeding up the unwarping process. The lookup table is initialized by means of the ECameraCalibration::SetupUnwarp function.

Unwarp() [5/20]

void eVision::ECameraCalibration::Unwarp	(	const eVision::EROIBW8 *	sourceImage,
		eVision::EROIBW8 *	destinationImage,
		eVision::ERegion &	region,
		bool	interpolate ) const

Unwarps a distorted image using the current calibration model.

Parameters

sourceImage	Pointer to the source image/ROI.
destinationImage	Pointer to the destination unwarped image. If optional parameter resizeDestination is false (default value) then the source and destination images must have the same size.
region	Output region.
interpolate	Interpolation mode. Default value is true.

Using a precomputed lookup table allows speeding up the unwarping process. The lookup table is initialized by means of the ECameraCalibration::SetupUnwarp function.

Unwarp() [6/20]

void eVision::ECameraCalibration::Unwarp	(	const eVision::EROIBW8 *	sourceImage,
		eVision::EROIBW8 *	destinationImage,
		eVision::ERegion &	region,
		bool	interpolate,
		bool	resizeDestination ) const

Unwarps a distorted image using the current calibration model.

Parameters

sourceImage	Pointer to the source image/ROI.
destinationImage	Pointer to the destination unwarped image. If optional parameter resizeDestination is false (default value) then the source and destination images must have the same size.
region	Output region.
interpolate	Interpolation mode. Default value is true.
resizeDestination	Resize the destination image to match the unwarped image size. Default value is false.

Using a precomputed lookup table allows speeding up the unwarping process. The lookup table is initialized by means of the ECameraCalibration::SetupUnwarp function.

Unwarp() [7/20]

void eVision::ECameraCalibration::Unwarp	(	const eVision::EROIC24 *	sourceImage,
		eVision::EROIC24 *	destinationImage ) const

Unwarps a distorted image using the current calibration model.

Parameters

sourceImage	Pointer to the source image/ROI.
destinationImage	Pointer to the destination unwarped image. If optional parameter resizeDestination is false (default value) then the source and destination images must have the same size.

Using a precomputed lookup table allows speeding up the unwarping process. The lookup table is initialized by means of the ECameraCalibration::SetupUnwarp function.

Unwarp() [8/20]

void eVision::ECameraCalibration::Unwarp	(	const eVision::EROIC24 *	sourceImage,
		eVision::EROIC24 *	destinationImage,
		bool	interpolate ) const

Unwarps a distorted image using the current calibration model.

Parameters

sourceImage	Pointer to the source image/ROI.
destinationImage	Pointer to the destination unwarped image. If optional parameter resizeDestination is false (default value) then the source and destination images must have the same size.
interpolate	Interpolation mode. Default value is true.

Using a precomputed lookup table allows speeding up the unwarping process. The lookup table is initialized by means of the ECameraCalibration::SetupUnwarp function.

Unwarp() [9/20]

void eVision::ECameraCalibration::Unwarp	(	const eVision::EROIC24 *	sourceImage,
		eVision::EROIC24 *	destinationImage,
		bool	interpolate,
		bool	resizeDestination ) const

Unwarps a distorted image using the current calibration model.

Parameters

sourceImage	Pointer to the source image/ROI.
destinationImage	Pointer to the destination unwarped image. If optional parameter resizeDestination is false (default value) then the source and destination images must have the same size.
interpolate	Interpolation mode. Default value is true.
resizeDestination	Resize the destination image to match the unwarped image size. Default value is false.

Using a precomputed lookup table allows speeding up the unwarping process. The lookup table is initialized by means of the ECameraCalibration::SetupUnwarp function.

Unwarp() [10/20]

void eVision::ECameraCalibration::Unwarp	(	const eVision::EROIC24 *	sourceImage,
		eVision::EROIC24 *	destinationImage,
		eVision::ERegion &	region ) const

Unwarps a distorted image using the current calibration model.

Parameters

sourceImage	Pointer to the source image/ROI.
destinationImage	Pointer to the destination unwarped image. If optional parameter resizeDestination is false (default value) then the source and destination images must have the same size.
region	Output region.

Using a precomputed lookup table allows speeding up the unwarping process. The lookup table is initialized by means of the ECameraCalibration::SetupUnwarp function.

Unwarp() [11/20]

void eVision::ECameraCalibration::Unwarp	(	const eVision::EROIC24 *	sourceImage,
		eVision::EROIC24 *	destinationImage,
		eVision::ERegion &	region,
		bool	interpolate ) const

Unwarps a distorted image using the current calibration model.

Parameters

sourceImage	Pointer to the source image/ROI.
destinationImage	Pointer to the destination unwarped image. If optional parameter resizeDestination is false (default value) then the source and destination images must have the same size.
region	Output region.
interpolate	Interpolation mode. Default value is true.

Using a precomputed lookup table allows speeding up the unwarping process. The lookup table is initialized by means of the ECameraCalibration::SetupUnwarp function.

Unwarp() [12/20]

void eVision::ECameraCalibration::Unwarp	(	const eVision::EROIC24 *	sourceImage,
		eVision::EROIC24 *	destinationImage,
		eVision::ERegion &	region,
		bool	interpolate,
		bool	resizeDestination ) const

Unwarps a distorted image using the current calibration model.

Parameters

sourceImage	Pointer to the source image/ROI.
destinationImage	Pointer to the destination unwarped image. If optional parameter resizeDestination is false (default value) then the source and destination images must have the same size.
region	Output region.
interpolate	Interpolation mode. Default value is true.
resizeDestination	Resize the destination image to match the unwarped image size. Default value is false.

Using a precomputed lookup table allows speeding up the unwarping process. The lookup table is initialized by means of the ECameraCalibration::SetupUnwarp function.

Unwarp() [13/20]

void eVision::ECameraCalibration::Unwarp	(	const eVision::EUnwarpingLut *	lookupTable,
		const eVision::EROIBW8 *	sourceImage,
		eVision::EROIBW8 *	destinationImage ) const

Unwarps a distorted image using the current calibration model.

Parameters

lookupTable	Pointer to the lookup table.
sourceImage	Pointer to the source image/ROI.
destinationImage	Pointer to the destination unwarped image. If optional parameter resizeDestination is false (default value) then the source and destination images must have the same size.

Using a precomputed lookup table allows speeding up the unwarping process. The lookup table is initialized by means of the ECameraCalibration::SetupUnwarp function.

Unwarp() [14/20]

void eVision::ECameraCalibration::Unwarp	(	const eVision::EUnwarpingLut *	lookupTable,
		const eVision::EROIBW8 *	sourceImage,
		eVision::EROIBW8 *	destinationImage,
		bool	interpolate ) const

Unwarps a distorted image using the current calibration model.

Parameters

lookupTable	Pointer to the lookup table.
sourceImage	Pointer to the source image/ROI.
destinationImage	Pointer to the destination unwarped image. If optional parameter resizeDestination is false (default value) then the source and destination images must have the same size.
interpolate	Interpolation mode. Default value is true.

Using a precomputed lookup table allows speeding up the unwarping process. The lookup table is initialized by means of the ECameraCalibration::SetupUnwarp function.

Unwarp() [15/20]

void eVision::ECameraCalibration::Unwarp	(	const eVision::EUnwarpingLut *	lookupTable,
		const eVision::EROIBW8 *	sourceImage,
		eVision::EROIBW8 *	destinationImage,
		eVision::ERegion &	region ) const

Unwarps a distorted image using the current calibration model.

Parameters

lookupTable	Pointer to the lookup table.
sourceImage	Pointer to the source image/ROI.
destinationImage	Pointer to the destination unwarped image. If optional parameter resizeDestination is false (default value) then the source and destination images must have the same size.
region	Output region.

Using a precomputed lookup table allows speeding up the unwarping process. The lookup table is initialized by means of the ECameraCalibration::SetupUnwarp function.

Unwarp() [16/20]

void eVision::ECameraCalibration::Unwarp	(	const eVision::EUnwarpingLut *	lookupTable,
		const eVision::EROIBW8 *	sourceImage,
		eVision::EROIBW8 *	destinationImage,
		eVision::ERegion &	region,
		bool	interpolate ) const

Unwarps a distorted image using the current calibration model.

Parameters

lookupTable	Pointer to the lookup table.
sourceImage	Pointer to the source image/ROI.
destinationImage	Pointer to the destination unwarped image. If optional parameter resizeDestination is false (default value) then the source and destination images must have the same size.
region	Output region.
interpolate	Interpolation mode. Default value is true.

Using a precomputed lookup table allows speeding up the unwarping process. The lookup table is initialized by means of the ECameraCalibration::SetupUnwarp function.

Unwarp() [17/20]

void eVision::ECameraCalibration::Unwarp	(	const eVision::EUnwarpingLut *	lookupTable,
		const eVision::EROIC24 *	sourceImage,
		eVision::EROIC24 *	destinationImage ) const

Unwarps a distorted image using the current calibration model.

Parameters

lookupTable	Pointer to the lookup table.
sourceImage	Pointer to the source image/ROI.
destinationImage	Pointer to the destination unwarped image. If optional parameter resizeDestination is false (default value) then the source and destination images must have the same size.

Using a precomputed lookup table allows speeding up the unwarping process. The lookup table is initialized by means of the ECameraCalibration::SetupUnwarp function.

Unwarp() [18/20]

void eVision::ECameraCalibration::Unwarp	(	const eVision::EUnwarpingLut *	lookupTable,
		const eVision::EROIC24 *	sourceImage,
		eVision::EROIC24 *	destinationImage,
		bool	interpolate ) const

Unwarps a distorted image using the current calibration model.

Parameters

lookupTable	Pointer to the lookup table.
sourceImage	Pointer to the source image/ROI.
destinationImage	Pointer to the destination unwarped image. If optional parameter resizeDestination is false (default value) then the source and destination images must have the same size.
interpolate	Interpolation mode. Default value is true.

Using a precomputed lookup table allows speeding up the unwarping process. The lookup table is initialized by means of the ECameraCalibration::SetupUnwarp function.

Unwarp() [19/20]

void eVision::ECameraCalibration::Unwarp	(	const eVision::EUnwarpingLut *	lookupTable,
		const eVision::EROIC24 *	sourceImage,
		eVision::EROIC24 *	destinationImage,
		eVision::ERegion &	region ) const

Unwarps a distorted image using the current calibration model.

Parameters

lookupTable	Pointer to the lookup table.
sourceImage	Pointer to the source image/ROI.
destinationImage	Pointer to the destination unwarped image. If optional parameter resizeDestination is false (default value) then the source and destination images must have the same size.
region	Output region.

Using a precomputed lookup table allows speeding up the unwarping process. The lookup table is initialized by means of the ECameraCalibration::SetupUnwarp function.

Unwarp() [20/20]

void eVision::ECameraCalibration::Unwarp	(	const eVision::EUnwarpingLut *	lookupTable,
		const eVision::EROIC24 *	sourceImage,
		eVision::EROIC24 *	destinationImage,
		eVision::ERegion &	region,
		bool	interpolate ) const

Unwarps a distorted image using the current calibration model.

Parameters

lookupTable	Pointer to the lookup table.
sourceImage	Pointer to the source image/ROI.
destinationImage	Pointer to the destination unwarped image. If optional parameter resizeDestination is false (default value) then the source and destination images must have the same size.
region	Output region.
interpolate	Interpolation mode. Default value is true.

Using a precomputed lookup table allows speeding up the unwarping process. The lookup table is initialized by means of the ECameraCalibration::SetupUnwarp function.

WorldToSensor()

eVision::EPoint eVision::ECameraCalibration::WorldToSensor

(

const eVision::EPoint &

worldPoint

)

const

Performs coordinate transform for arbitrary points from World space to Sensor space.

Parameters

worldPoint

World point.

This transformation is impossible when the world point is located on the principal plane of the camera (the plane parallel to the camera sensor containing the center of projection of the camera). In this case, the returned point will contain infinity values. This usually happens when the calibration plane was highly tilted with respect to the camera.

Member Data Documentation

wrappedClass_

CppWrapperInternal::WrappedClass eVision::ECameraCalibration::wrappedClass_