eVision.ECameraCalibration Class Reference

Camera calibration. More...

Inheritance diagram for eVision.ECameraCalibration:

Collaboration diagram for eVision.ECameraCalibration:

Public Member Functions
	ECameraCalibration ()
	Constructs a raw camera calibration object.
	ECameraCalibration (eVision.ECameraCalibration other)
	Copy constructor.
void	CopyTo (eVision.ECameraCalibration other)
	Copy the content of this ECameraCalibration object to the other object.
void	SetSensor (int sensorWidth, int sensorHeight, float fieldWidth, float fieldHeight, float centerX, float centerY, float angle, float tiltXAngle, float tiltYAngle, float perspectiveStrength, float distortionStrength, float opticalCenterX, float opticalCenterY, uint calibrationModes)
	Sensor characteristics.
void	SetSensor (int sensorWidth, int 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 (int sensorWidth, int 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 (int sensorWidth, int sensorHeight, float fieldWidth, float fieldHeight, float centerX, float centerY, float angle, float tiltXAngle, float tiltYAngle, float perspectiveStrength, float distortionStrength)
	Sensor characteristics.
void	SetSensor (int sensorWidth, int sensorHeight, float fieldWidth, float fieldHeight, float centerX, float centerY, float angle, float tiltXAngle, float tiltYAngle, float perspectiveStrength)
	Sensor characteristics.
void	SetSensor (int sensorWidth, int sensorHeight, float fieldWidth, float fieldHeight, float centerX, float centerY, float angle, float tiltXAngle, float tiltYAngle)
	Sensor characteristics.
void	SetSensor (int sensorWidth, int sensorHeight, float fieldWidth, float fieldHeight, float centerX, float centerY, float angle, float tiltXAngle)
	Sensor characteristics.
void	SetSensor (int sensorWidth, int sensorHeight, float fieldWidth, float fieldHeight, float centerX, float centerY, float angle)
	Sensor characteristics.
void	SetSensor (int sensorWidth, int sensorHeight, float fieldWidth, float fieldHeight, float centerX, float centerY)
	Sensor characteristics.
void	SetSensor (int sensorWidth, int sensorHeight, float fieldWidth, float fieldHeight, float centerX)
	Sensor characteristics.
void	SetSensor (int sensorWidth, int sensorHeight, float fieldWidth, float fieldHeight)
	Sensor characteristics.
void	SetSensor (int sensorWidth, int sensorHeight, float fieldWidth)
	Sensor characteristics.
void	SetSensor (int sensorWidth, int sensorHeight)
	Sensor characteristics.
void	SetSensorUsingResolution (int sensorWidth, int sensorHeight, float resolutionX, float resolutionY, float centerX, float centerY, float angle, float tiltXAngle, float tiltYAngle, float perspectiveStrength, float distortionStrength, float opticalCenterX, float opticalCenterY, uint calibrationModes)
	Sensor characteristics.
void	SetSensorUsingResolution (int sensorWidth, int 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 (int sensorWidth, int 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 (int sensorWidth, int sensorHeight, float resolutionX, float resolutionY, float centerX, float centerY, float angle, float tiltXAngle, float tiltYAngle, float perspectiveStrength, float distortionStrength)
	Sensor characteristics.
void	SetSensorUsingResolution (int sensorWidth, int sensorHeight, float resolutionX, float resolutionY, float centerX, float centerY, float angle, float tiltXAngle, float tiltYAngle, float perspectiveStrength)
	Sensor characteristics.
void	SetSensorUsingResolution (int sensorWidth, int sensorHeight, float resolutionX, float resolutionY, float centerX, float centerY, float angle, float tiltXAngle, float tiltYAngle)
	Sensor characteristics.
void	SetSensorUsingResolution (int sensorWidth, int sensorHeight, float resolutionX, float resolutionY, float centerX, float centerY, float angle, float tiltXAngle)
	Sensor characteristics.
void	SetSensorUsingResolution (int sensorWidth, int sensorHeight, float resolutionX, float resolutionY, float centerX, float centerY, float angle)
	Sensor characteristics.
void	SetSensorUsingResolution (int sensorWidth, int sensorHeight, float resolutionX, float resolutionY, float centerX, float centerY)
	Sensor characteristics.
void	SetSensorUsingResolution (int sensorWidth, int sensorHeight, float resolutionX, float resolutionY, float centerX)
	Sensor characteristics.
void	SetSensorUsingResolution (int sensorWidth, int sensorHeight, float resolutionX, float resolutionY)
	Sensor characteristics.
void	SetSensorUsingResolution (int sensorWidth, int sensorHeight, float resolutionX)
	Sensor characteristics.
void	SetSensorUsingResolution (int sensorWidth, int sensorHeight)
	Sensor characteristics.
void	SetAffineCalibration (int sensorWidth, int 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 (int sensorWidth, int sensorHeight, float resolutionX, float resolutionY, float centerX, float centerY)
	Sets an affine calibration, i.e. a calibration model without distortion or perspective.
void	SetAffineCalibration (int sensorWidth, int sensorHeight, float resolutionX, float resolutionY, float centerX)
	Sets an affine calibration, i.e. a calibration model without distortion or perspective.
void	SetAffineCalibration (int sensorWidth, int sensorHeight, float resolutionX, float resolutionY)
	Sets an affine calibration, i.e. a calibration model without distortion or perspective.
void	SetSensorSize (int sensorWidth, int 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.
void	ResetCustomMinDotArea ()
	Resets the custom minimum dot area parameter. The heurestic described in SetMinDotArea is used again.
bool	IsCalibrationAffine ()
	Whether the calibration is an affine transformation or not.
eVision.EFrame	ToFrame ()
	Converts the calibration to a EFrame where the global coordinates are the world coordinates.
void	EmptyLandmarks ()
	Resets the landmark specification sequence.
void	AddPoint (eVision.EPoint sensorPoint)
	Adds a new point coordinates (in Sensor space) to the set of grid points used for calibration.
void	AddLandmark (eVision.EPoint sensorPoint, 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 (uint index)
	Removes a landmark.
eVision.ELandmark	GetLandmark (uint i)
	Gets a landmark.
void	HitLandmarks (int x, int y, float zoomX, float zoomY, float panX, float panY)
	Checks if the cursor is placed over a landmark point.
void	HitLandmarks (int x, int y, float zoomX, float zoomY, float panX)
	Checks if the cursor is placed over a landmark point.
void	HitLandmarks (int x, int y, float zoomX, float zoomY)
	Checks if the cursor is placed over a landmark point.
void	HitLandmarks (int x, int y, float zoomX)
	Checks if the cursor is placed over a landmark point.
void	HitLandmarks (int x, int y)
	Checks if the cursor is placed over a landmark point.
void	DragLandmark (int x, int y, float zoomX, float zoomY, float panX, float panY)
	Moves the landmark to a new position.
void	DragLandmark (int x, int y, float zoomX, float zoomY, float panX)
	Moves the landmark to a new position.
void	DragLandmark (int x, int y, float zoomX, float zoomY)
	Moves the landmark to a new position.
void	DragLandmark (int x, int y, float zoomX)
	Moves the landmark to a new position.
void	DragLandmark (int x, int y)
	Moves the landmark to a new position.
void	Calibrate (uint 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.
uint	AutoCalibrate (bool testEmpiricalModes)
	Returns the best calibration modes for the current calibration grid and calibrates the field of view accordingly.
uint	AutoCalibrate ()
	Returns the best calibration modes for the current calibration grid and calibrates the field of view accordingly.
uint	AutoCalibrate (uint calibrationModes)
	Returns the best calibration modes for the current calibration grid and calibrates the field of view accordingly.
uint	AutoCalibrateLandmarks (bool testEmpiricalModes)
	Returns the best calibration modes for the current landmark set and calibrates the field of view accordingly.
uint	AutoCalibrateLandmarks ()
	Returns the best calibration modes for the current landmark set and calibrates the field of view accordingly.
uint	AutoCalibrateLandmarks (uint calibrationModes)
	Returns the best calibration modes for the current landmark set and calibrates the field of view accordingly.
uint	AutoCalibrateDotGrid (eVision.EROIBW8 sourceImage, float columnPitch, float rowPitch, bool testEmpiricalModes, bool testAdvancedCalibrationMode)
	Performs an automatic calibration based on a dot grid image.
uint	AutoCalibrateDotGrid (eVision.EROIBW8 sourceImage, float columnPitch, float rowPitch, bool testEmpiricalModes)
	Performs an automatic calibration based on a dot grid image.
uint	AutoCalibrateDotGrid (eVision.EROIBW8 sourceImage, float columnPitch, float rowPitch)
	Performs an automatic calibration based on a dot grid image.
uint	AutoCalibrateDotGrid (eVision.EROIBW8 sourceImage, float columnPitch, float rowPitch, uint enabledCalibrationModes)
	Performs an automatic calibration based on a dot grid image.
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.
uint	RebuildGrid (float colPitch, float rowPitch, uint centerIndex, bool direct)
	Reconstructs the grid of points from the given dot centers, to compute the World coordinates of the points.
uint	RebuildGrid (float colPitch, float rowPitch, uint centerIndex)
	Reconstructs the grid of points from the given dot centers, to compute the World coordinates of the points.
uint	RebuildGrid (float colPitch, float rowPitch)
	Reconstructs the grid of points from the given dot centers, to compute the World coordinates of the points.
uint	RebuildGrid (float colPitch, float rowPitch, eVision.EPoint worldCenter, uint centerIndex, bool direct)
	Reconstructs the grid of points from the given dot centers, to compute the World coordinates of the points.
uint	RebuildGrid (float colPitch, float rowPitch, eVision.EPoint worldCenter, uint centerIndex)
	Reconstructs the grid of points from the given dot centers, to compute the World coordinates of the points.
uint	RebuildGrid (float colPitch, float rowPitch, 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, eVision.EROIBW8 sourceImage, bool interpolate, bool resizeDestination)
	Prepares a lookup table for fast image unwarping.
void	SetupUnwarp (eVision.EUnwarpingLut lookupTable, eVision.EROIBW8 sourceImage, bool interpolate)
	Prepares a lookup table for fast image unwarping.
void	SetupUnwarp (eVision.EUnwarpingLut lookupTable, eVision.EROIBW8 sourceImage)
	Prepares a lookup table for fast image unwarping.
void	SetupUnwarp (eVision.EUnwarpingLut lookupTable, eVision.EROIC24 sourceImage, bool interpolate, bool resizeDestination)
	Prepares a lookup table for fast image unwarping.
void	SetupUnwarp (eVision.EUnwarpingLut lookupTable, eVision.EROIC24 sourceImage, bool interpolate)
	Prepares a lookup table for fast image unwarping.
void	SetupUnwarp (eVision.EUnwarpingLut lookupTable, eVision.EROIC24 sourceImage)
	Prepares a lookup table for fast image unwarping.
void	Unwarp (eVision.EROIBW8 sourceImage, eVision.EROIBW8 destinationImage, bool interpolate, bool resizeDestination)
	Unwarps a distorted image using the current calibration model.
void	Unwarp (eVision.EROIBW8 sourceImage, eVision.EROIBW8 destinationImage, bool interpolate)
	Unwarps a distorted image using the current calibration model.
void	Unwarp (eVision.EROIBW8 sourceImage, eVision.EROIBW8 destinationImage)
	Unwarps a distorted image using the current calibration model.
void	Unwarp (eVision.EROIC24 sourceImage, eVision.EROIC24 destinationImage, bool interpolate, bool resizeDestination)
	Unwarps a distorted image using the current calibration model.
void	Unwarp (eVision.EROIC24 sourceImage, eVision.EROIC24 destinationImage, bool interpolate)
	Unwarps a distorted image using the current calibration model.
void	Unwarp (eVision.EROIC24 sourceImage, eVision.EROIC24 destinationImage)
	Unwarps a distorted image using the current calibration model.
void	Unwarp (eVision.EROIBW8 sourceImage, eVision.EROIBW8 destinationImage, eVision.ERegion region, bool interpolate, bool resizeDestination)
	Unwarps a distorted image using the current calibration model.
void	Unwarp (eVision.EROIBW8 sourceImage, eVision.EROIBW8 destinationImage, eVision.ERegion region, bool interpolate)
	Unwarps a distorted image using the current calibration model.
void	Unwarp (eVision.EROIBW8 sourceImage, eVision.EROIBW8 destinationImage, eVision.ERegion region)
	Unwarps a distorted image using the current calibration model.
void	Unwarp (eVision.EROIC24 sourceImage, eVision.EROIC24 destinationImage, eVision.ERegion region, bool interpolate, bool resizeDestination)
	Unwarps a distorted image using the current calibration model.
void	Unwarp (eVision.EROIC24 sourceImage, eVision.EROIC24 destinationImage, eVision.ERegion region, bool interpolate)
	Unwarps a distorted image using the current calibration model.
void	Unwarp (eVision.EROIC24 sourceImage, eVision.EROIC24 destinationImage, eVision.ERegion region)
	Unwarps a distorted image using the current calibration model.
void	Unwarp (eVision.EUnwarpingLut lookupTable, eVision.EROIBW8 sourceImage, eVision.EROIBW8 destinationImage, bool interpolate)
	Unwarps a distorted image using the current calibration model.
void	Unwarp (eVision.EUnwarpingLut lookupTable, eVision.EROIBW8 sourceImage, eVision.EROIBW8 destinationImage)
	Unwarps a distorted image using the current calibration model.
void	Unwarp (eVision.EUnwarpingLut lookupTable, eVision.EROIC24 sourceImage, eVision.EROIC24 destinationImage, bool interpolate)
	Unwarps a distorted image using the current calibration model.
void	Unwarp (eVision.EUnwarpingLut lookupTable, eVision.EROIC24 sourceImage, eVision.EROIC24 destinationImage)
	Unwarps a distorted image using the current calibration model.
void	Unwarp (eVision.EUnwarpingLut lookupTable, eVision.EROIBW8 sourceImage, eVision.EROIBW8 destinationImage, eVision.ERegion region, bool interpolate)
	Unwarps a distorted image using the current calibration model.
void	Unwarp (eVision.EUnwarpingLut lookupTable, eVision.EROIBW8 sourceImage, eVision.EROIBW8 destinationImage, eVision.ERegion region)
	Unwarps a distorted image using the current calibration model.
void	Unwarp (eVision.EUnwarpingLut lookupTable, eVision.EROIC24 sourceImage, eVision.EROIC24 destinationImage, eVision.ERegion region, bool interpolate)
	Unwarps a distorted image using the current calibration model.
void	Unwarp (eVision.EUnwarpingLut lookupTable, eVision.EROIC24 sourceImage, eVision.EROIC24 destinationImage, eVision.ERegion region)
	Unwarps a distorted image using the current calibration model.
eVision.ECameraCalibration	GetUnwarpedCalibration (eVision.EBaseROI sourceImage, bool resizeDestination)
	Gets a ECameraCalibration instance representing the transformation of image to world coordinates for the result of ECameraCalibration.Unwarp.
eVision.ECameraCalibration	GetUnwarpedCalibration (eVision.EBaseROI sourceImage)
	Gets a ECameraCalibration instance representing the transformation of image to world coordinates for the result of ECameraCalibration.Unwarp.
eVision.ECameraCalibration	GetUnwarpedCalibration (int sourceWidth, int sourceHeight, bool resizeDestination)
	Gets a ECameraCalibration instance representing the transformation of image to world coordinates for the result of ECameraCalibration.Unwarp.
eVision.ECameraCalibration	GetUnwarpedCalibration (int sourceWidth, int sourceHeight)
	Gets a ECameraCalibration instance representing the transformation of image to world coordinates for the result of ECameraCalibration.Unwarp.
eVision.EPoint	SensorToWorld (eVision.EPoint sensorPoint)
	Performs coordinate transform for arbitrary points from Sensor space to World space.
eVision.EPoint	WorldToSensor (eVision.EPoint worldPoint)
	Performs coordinate transform for arbitrary points from World space to Sensor space.
void	Draw (eVision.EDrawAdapter graphicContext, float zoomX, float zoomY, float panX, float panY)
	Draws the world coordinate axis.
void	Draw (eVision.EDrawAdapter graphicContext, float zoomX, float zoomY, float panX)
	Draws the world coordinate axis.
void	Draw (eVision.EDrawAdapter graphicContext, float zoomX, float zoomY)
	Draws the world coordinate axis.
void	Draw (eVision.EDrawAdapter graphicContext, float zoomX)
	Draws the world coordinate axis.
void	Draw (eVision.EDrawAdapter graphicContext)
	Draws the world coordinate axis.
void	Draw (eVision.EDrawAdapter graphicContext, float xAxisSize, float yAxisSize, float zoomX, float zoomY, float panX, float panY)
	Draws the world coordinate axis.
void	DrawCrossGrid (eVision.EDrawAdapter graphicContext, float minimumX, float maximumX, float minimumY, float maximumY, uint numberOfIntervalsX, uint numberOfIntervalsY, float zoomX, float zoomY, float panX, float panY)
	Draws a regular grid of crosses in world coordinates.
void	DrawCrossGrid (eVision.EDrawAdapter graphicContext, float minimumX, float maximumX, float minimumY, float maximumY, uint numberOfIntervalsX, uint numberOfIntervalsY, float zoomX, float zoomY, float panX)
	Draws a regular grid of crosses in world coordinates.
void	DrawCrossGrid (eVision.EDrawAdapter graphicContext, float minimumX, float maximumX, float minimumY, float maximumY, uint numberOfIntervalsX, uint numberOfIntervalsY, float zoomX, float zoomY)
	Draws a regular grid of crosses in world coordinates.
void	DrawCrossGrid (eVision.EDrawAdapter graphicContext, float minimumX, float maximumX, float minimumY, float maximumY, uint numberOfIntervalsX, uint numberOfIntervalsY, float zoomX)
	Draws a regular grid of crosses in world coordinates.
void	DrawCrossGrid (eVision.EDrawAdapter graphicContext, float minimumX, float maximumX, float minimumY, float maximumY, uint numberOfIntervalsX, uint numberOfIntervalsY)
	Draws a regular grid of crosses in world coordinates.
void	DrawCrossGrid (eVision.EDrawAdapter graphicContext, float minimumX, float maximumX, float minimumY, float maximumY, uint numberOfIntervalsX)
	Draws a regular grid of crosses in world coordinates.
void	DrawCrossGrid (eVision.EDrawAdapter graphicContext, float minimumX, float maximumX, float minimumY, float maximumY)
	Draws a regular grid of crosses in world coordinates.
void	DrawCrossGrid (eVision.EDrawAdapter graphicContext, float minimumX, float maximumX, float minimumY)
	Draws a regular grid of crosses in world coordinates.
void	DrawCrossGrid (eVision.EDrawAdapter graphicContext, float minimumX, float maximumX)
	Draws a regular grid of crosses in world coordinates.
void	DrawCrossGrid (eVision.EDrawAdapter graphicContext, float minimumX)
	Draws a regular grid of crosses in world coordinates.
void	DrawCrossGrid (eVision.EDrawAdapter graphicContext)
	Draws a regular grid of crosses in world coordinates.
void	DrawGrid (eVision.EDrawAdapter graphicContext, float zoomX, float zoomY, float panX, float panY)
	Draws the reconstructed grid to be used for grid calibration.
void	DrawGrid (eVision.EDrawAdapter graphicContext, float zoomX, float zoomY, float panX)
	Draws the reconstructed grid to be used for grid calibration.
void	DrawGrid (eVision.EDrawAdapter graphicContext, float zoomX, float zoomY)
	Draws the reconstructed grid to be used for grid calibration.
void	DrawGrid (eVision.EDrawAdapter graphicContext, float zoomX)
	Draws the reconstructed grid to be used for grid calibration.
void	DrawGrid (eVision.EDrawAdapter graphicContext)
	Draws the reconstructed grid to be used for grid calibration.
void	DrawLandmarks (eVision.EDrawAdapter graphicContext, float zoomX, float zoomY, float panX, float panY)
	Draws the landmarks to be used for landmark calibration.
void	DrawLandmarks (eVision.EDrawAdapter graphicContext, float zoomX, float zoomY, float panX)
	Draws the landmarks to be used for landmark calibration.
void	DrawLandmarks (eVision.EDrawAdapter graphicContext, float zoomX, float zoomY)
	Draws the landmarks to be used for landmark calibration.
void	DrawLandmarks (eVision.EDrawAdapter graphicContext, float zoomX)
	Draws the landmarks to be used for landmark calibration.
void	DrawLandmarks (eVision.EDrawAdapter graphicContext)
	Draws the landmarks to be used for landmark calibration.
virtual void	Load (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 (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.

Properties
float	FieldWidth [get]
	Field-of-view width, in physical units.
float	FieldHeight [get]
	Field-of-view height, in physical units.
float	Angle [get]
	Angle of the principal direction of the world plane with respect to the x-axis of the image.
float	Ratio [get]
	XResolution/YResolution ratio.
float	Scale [get]
	Scale of the model (X resolution).
eVision.EPoint	Center [get]
	Pixel coordinates of the projection of the world center.
int	SensorWidth [get]
	Logical image width, that is the number of pixels horizontally.
int	SensorHeight [get]
	Logical image height, that is the number of pixels vertically.
float	XResolution [get]
	Horizontal sensor resolution, in pixels per unit.
float	YResolution [get]
	Vertical sensor resolution, in pixels per unit.
float	TiltXAngle [get]
	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	TiltYAngle [get]
	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	PerspectiveStrength [get]
	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	DistortionStrength [get]
	Optical distortion strength (the ratio of the image diagonal length with and without optical distortion introduced by the lens).
float	OpticalCenterX [get]
	X coordinate of the optical center of the sensor in the image (in pixels).
float	OpticalCenterY [get]
	Y coordinate of the optical center of the sensor in the image (in pixels).
uint	CalibrationModes [get]
	Current calibration mode, made from a combination of values.
bool	HasCustomMinDotArea [get]
	Returns if a custom minimum dot area has been previously set.
int	CustomMinDotArea [get, set]
	Gets the minimum dot area.
uint	NumLandmark [get]
	Number of landmarks.
uint	HitLandmark [get]
	Returns the landmark selected by ECameraCalibration.HitLandmarks or ~0 if no landmark is selected.
float	ReprojectionScore [get]
	Reproject score (average squared distance between a landmark and its projection in the image using the calibrated model).
float	MeanWorldToSensorError [get]
	Mean WorldToSensor error over all valid landmarks (root mean square error, RMSE).
float	MaxWorldToSensorError [get]
	Maximum WorldToSensor error over all valid landmarks (maximum distance between a landmark and its projection in the image using the calibrated model).
float	MeanSensorToWorldError [get]
	Mean SensorToWorld error over all valid landmarks (root mean square error, RMSE).
float	MaxSensorToWorldError [get]
	Maximum SensorToWorld error over all valid landmarks (maximum distance between a landmark and its projection in world space using the calibrated model).
float	GridPointsMeanVariation [get]
	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	GridPointsMaxVariation [get]
	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	GridPointsMeanVariationThreshold [get, set]
	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	GridPointsMaxVariationThreshold [get, set]
	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.
float	DefaultAxisSize [get]
	The default size of axis when drawing with ECameraCalibration.Draw.
eVision.AdvancedCalibrationParameters	AdvancedCalibrationParameters [get]
	Get the advanced calibration parameters. Throws if the calibration mode is not advanced.

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/2]

eVision.ECameraCalibration.ECameraCalibration

(

)

Constructs a raw camera calibration object.

ECameraCalibration() [2/2]

eVision.ECameraCalibration.ECameraCalibration

(

eVision.ECameraCalibration

other

)

Copy constructor.

Parameters

other

Other ECameraCalibration object.

Member Function Documentation

AddLandmark()

void eVision.ECameraCalibration.AddLandmark	(	eVision.EPoint	sensorPoint,
		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

(

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]

uint 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]

uint 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]

uint eVision.ECameraCalibration.AutoCalibrate

(

uint

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]

uint eVision.ECameraCalibration.AutoCalibrateDotGrid	(	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.CustomMinDotArea. 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]

uint eVision.ECameraCalibration.AutoCalibrateDotGrid	(	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.CustomMinDotArea. 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]

uint eVision.ECameraCalibration.AutoCalibrateDotGrid	(	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.CustomMinDotArea. 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]

uint eVision.ECameraCalibration.AutoCalibrateDotGrid	(	eVision.EROIBW8	sourceImage,
		float	columnPitch,
		float	rowPitch,
		uint	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.CustomMinDotArea. 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]

uint 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]

uint 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]

uint eVision.ECameraCalibration.AutoCalibrateLandmarks

(

uint

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.CalibrationModes 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

(

uint

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.CalibrationModes 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.GridPointsMeanVariationThreshold and ECameraCalibration.GridPointsMaxVariationThreshold properties.

CopyTo()

void eVision.ECameraCalibration.CopyTo

(

eVision.ECameraCalibration

other

)

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

Parameters

other

Object to copy to.

DragLandmark() [1/5]

void eVision.ECameraCalibration.DragLandmark	(	int	x,
		int	y )

Moves the landmark to a new position.

Parameters

x	Current cursor coordinates.
y	Current cursor coordinates.

DragLandmark() [2/5]

void eVision.ECameraCalibration.DragLandmark	(	int	x,
		int	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	(	int	x,
		int	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	(	int	x,
		int	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	(	int	x,
		int	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

)

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 )

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 )

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 )

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 )

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 )

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

)

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 )

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 )

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 )

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 )

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,
		uint	numberOfIntervalsX )

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,
		uint	numberOfIntervalsX,
		uint	numberOfIntervalsY )

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,
		uint	numberOfIntervalsX,
		uint	numberOfIntervalsY,
		float	zoomX )

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,
		uint	numberOfIntervalsX,
		uint	numberOfIntervalsY,
		float	zoomX,
		float	zoomY )

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,
		uint	numberOfIntervalsX,
		uint	numberOfIntervalsY,
		float	zoomX,
		float	zoomY,
		float	panX )

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,
		uint	numberOfIntervalsX,
		uint	numberOfIntervalsY,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY )

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

)

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 )

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 )

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 )

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 )

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

)

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 )

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 )

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 )

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 )

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.

GetLandmark()

eVision.ELandmark eVision.ECameraCalibration.GetLandmark

(

uint

i

)

Gets a landmark.

Parameters

i	Index of the landmark between 0 and ECameraCalibration.NumLandmark - 1

GetUnwarpedCalibration() [1/4]

eVision.ECameraCalibration eVision.ECameraCalibration.GetUnwarpedCalibration

(

eVision.EBaseROI

sourceImage

)

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	(	eVision.EBaseROI	sourceImage,
		bool	resizeDestination )

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	(	int	sourceWidth,
		int	sourceHeight )

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	(	int	sourceWidth,
		int	sourceHeight,
		bool	resizeDestination )

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.

HitLandmarks() [1/5]

void eVision.ECameraCalibration.HitLandmarks	(	int	x,
		int	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	(	int	x,
		int	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	(	int	x,
		int	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	(	int	x,
		int	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	(	int	x,
		int	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

(

)

Whether the calibration is an affine transformation or not.

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

Load() [1/2]

virtual void eVision.ECameraCalibration.Load ( eVision.ESerializer serializer )

virtual

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

Parameters

serializer

The serializer.

Load() [2/2]

virtual void eVision.ECameraCalibration.Load ( string path )

virtual

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

Parameters

path	The file path.

RebuildGrid() [1/6]

uint 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]

uint eVision.ECameraCalibration.RebuildGrid	(	float	colPitch,
		float	rowPitch,
		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]

uint eVision.ECameraCalibration.RebuildGrid	(	float	colPitch,
		float	rowPitch,
		eVision.EPoint	worldCenter,
		uint	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]

uint eVision.ECameraCalibration.RebuildGrid	(	float	colPitch,
		float	rowPitch,
		eVision.EPoint	worldCenter,
		uint	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]

uint eVision.ECameraCalibration.RebuildGrid	(	float	colPitch,
		float	rowPitch,
		uint	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]

uint eVision.ECameraCalibration.RebuildGrid	(	float	colPitch,
		float	rowPitch,
		uint	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

(

uint

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]

virtual 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.

Save() [2/2]

virtual void eVision.ECameraCalibration.Save ( string path )

virtual

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

Parameters

path	The file path.

SensorToWorld()

eVision.EPoint eVision.ECameraCalibration.SensorToWorld

(

eVision.EPoint

sensorPoint

)

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	(	int	sensorWidth,
		int	sensorHeight,
		float	resolutionX,
		float	resolutionY )

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

The ECameraCalibration.CalibrationModes 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	(	int	sensorWidth,
		int	sensorHeight,
		float	resolutionX,
		float	resolutionY,
		float	centerX )

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

The ECameraCalibration.CalibrationModes 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	(	int	sensorWidth,
		int	sensorHeight,
		float	resolutionX,
		float	resolutionY,
		float	centerX,
		float	centerY )

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

The ECameraCalibration.CalibrationModes 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	(	int	sensorWidth,
		int	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.CalibrationModes 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.

SetSensor() [1/13]

void eVision.ECameraCalibration.SetSensor	(	int	sensorWidth,
		int	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.CalibrationModes, not a simpler one.

SetSensor() [2/13]

void eVision.ECameraCalibration.SetSensor	(	int	sensorWidth,
		int	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.CalibrationModes, not a simpler one.

SetSensor() [3/13]

void eVision.ECameraCalibration.SetSensor	(	int	sensorWidth,
		int	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.CalibrationModes, not a simpler one.

SetSensor() [4/13]

void eVision.ECameraCalibration.SetSensor	(	int	sensorWidth,
		int	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.CalibrationModes, not a simpler one.

SetSensor() [5/13]

void eVision.ECameraCalibration.SetSensor	(	int	sensorWidth,
		int	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.CalibrationModes, not a simpler one.

SetSensor() [6/13]

void eVision.ECameraCalibration.SetSensor	(	int	sensorWidth,
		int	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.CalibrationModes, not a simpler one.

SetSensor() [7/13]

void eVision.ECameraCalibration.SetSensor	(	int	sensorWidth,
		int	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.CalibrationModes, not a simpler one.

SetSensor() [8/13]

void eVision.ECameraCalibration.SetSensor	(	int	sensorWidth,
		int	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.CalibrationModes, not a simpler one.

SetSensor() [9/13]

void eVision.ECameraCalibration.SetSensor	(	int	sensorWidth,
		int	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.CalibrationModes, not a simpler one.

SetSensor() [10/13]

void eVision.ECameraCalibration.SetSensor	(	int	sensorWidth,
		int	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.CalibrationModes, not a simpler one.

SetSensor() [11/13]

void eVision.ECameraCalibration.SetSensor	(	int	sensorWidth,
		int	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.CalibrationModes, not a simpler one.

SetSensor() [12/13]

void eVision.ECameraCalibration.SetSensor	(	int	sensorWidth,
		int	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.CalibrationModes, not a simpler one.

SetSensor() [13/13]

void eVision.ECameraCalibration.SetSensor	(	int	sensorWidth,
		int	sensorHeight,
		float	fieldWidth,
		float	fieldHeight,
		float	centerX,
		float	centerY,
		float	angle,
		float	tiltXAngle,
		float	tiltYAngle,
		float	perspectiveStrength,
		float	distortionStrength,
		float	opticalCenterX,
		float	opticalCenterY,
		uint	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.CalibrationModes, not a simpler one.

SetSensorSize()

void eVision.ECameraCalibration.SetSensorSize	(	int	sensorWidth,
		int	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	(	int	sensorWidth,
		int	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.CalibrationModes, not a simpler one.

SetSensorUsingResolution() [2/13]

void eVision.ECameraCalibration.SetSensorUsingResolution	(	int	sensorWidth,
		int	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.CalibrationModes, not a simpler one.

SetSensorUsingResolution() [3/13]

void eVision.ECameraCalibration.SetSensorUsingResolution	(	int	sensorWidth,
		int	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.CalibrationModes, not a simpler one.

SetSensorUsingResolution() [4/13]

void eVision.ECameraCalibration.SetSensorUsingResolution	(	int	sensorWidth,
		int	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.CalibrationModes, not a simpler one.

SetSensorUsingResolution() [5/13]

void eVision.ECameraCalibration.SetSensorUsingResolution	(	int	sensorWidth,
		int	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.CalibrationModes, not a simpler one.

SetSensorUsingResolution() [6/13]

void eVision.ECameraCalibration.SetSensorUsingResolution	(	int	sensorWidth,
		int	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.CalibrationModes, not a simpler one.

SetSensorUsingResolution() [7/13]

void eVision.ECameraCalibration.SetSensorUsingResolution	(	int	sensorWidth,
		int	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.CalibrationModes, not a simpler one.

SetSensorUsingResolution() [8/13]

void eVision.ECameraCalibration.SetSensorUsingResolution	(	int	sensorWidth,
		int	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.CalibrationModes, not a simpler one.

SetSensorUsingResolution() [9/13]

void eVision.ECameraCalibration.SetSensorUsingResolution	(	int	sensorWidth,
		int	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.CalibrationModes, not a simpler one.

SetSensorUsingResolution() [10/13]

void eVision.ECameraCalibration.SetSensorUsingResolution	(	int	sensorWidth,
		int	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.CalibrationModes, not a simpler one.

SetSensorUsingResolution() [11/13]

void eVision.ECameraCalibration.SetSensorUsingResolution	(	int	sensorWidth,
		int	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.CalibrationModes, not a simpler one.

SetSensorUsingResolution() [12/13]

void eVision.ECameraCalibration.SetSensorUsingResolution	(	int	sensorWidth,
		int	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.CalibrationModes, not a simpler one.

SetSensorUsingResolution() [13/13]

void eVision.ECameraCalibration.SetSensorUsingResolution	(	int	sensorWidth,
		int	sensorHeight,
		float	resolutionX,
		float	resolutionY,
		float	centerX,
		float	centerY,
		float	angle,
		float	tiltXAngle,
		float	tiltYAngle,
		float	perspectiveStrength,
		float	distortionStrength,
		float	opticalCenterX,
		float	opticalCenterY,
		uint	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.CalibrationModes, not a simpler one.

SetupUnwarp() [1/6]

void eVision.ECameraCalibration.SetupUnwarp	(	eVision.EUnwarpingLut	lookupTable,
		eVision.EROIBW8	sourceImage )

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,
		eVision.EROIBW8	sourceImage,
		bool	interpolate )

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,
		eVision.EROIBW8	sourceImage,
		bool	interpolate,
		bool	resizeDestination )

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,
		eVision.EROIC24	sourceImage )

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,
		eVision.EROIC24	sourceImage,
		bool	interpolate )

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,
		eVision.EROIC24	sourceImage,
		bool	interpolate,
		bool	resizeDestination )

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

(

)

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	(	eVision.EROIBW8	sourceImage,
		eVision.EROIBW8	destinationImage )

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	(	eVision.EROIBW8	sourceImage,
		eVision.EROIBW8	destinationImage,
		bool	interpolate )

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	(	eVision.EROIBW8	sourceImage,
		eVision.EROIBW8	destinationImage,
		bool	interpolate,
		bool	resizeDestination )

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	(	eVision.EROIBW8	sourceImage,
		eVision.EROIBW8	destinationImage,
		eVision.ERegion	region )

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	(	eVision.EROIBW8	sourceImage,
		eVision.EROIBW8	destinationImage,
		eVision.ERegion	region,
		bool	interpolate )

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	(	eVision.EROIBW8	sourceImage,
		eVision.EROIBW8	destinationImage,
		eVision.ERegion	region,
		bool	interpolate,
		bool	resizeDestination )

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	(	eVision.EROIC24	sourceImage,
		eVision.EROIC24	destinationImage )

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	(	eVision.EROIC24	sourceImage,
		eVision.EROIC24	destinationImage,
		bool	interpolate )

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	(	eVision.EROIC24	sourceImage,
		eVision.EROIC24	destinationImage,
		bool	interpolate,
		bool	resizeDestination )

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	(	eVision.EROIC24	sourceImage,
		eVision.EROIC24	destinationImage,
		eVision.ERegion	region )

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	(	eVision.EROIC24	sourceImage,
		eVision.EROIC24	destinationImage,
		eVision.ERegion	region,
		bool	interpolate )

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	(	eVision.EROIC24	sourceImage,
		eVision.EROIC24	destinationImage,
		eVision.ERegion	region,
		bool	interpolate,
		bool	resizeDestination )

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	(	eVision.EUnwarpingLut	lookupTable,
		eVision.EROIBW8	sourceImage,
		eVision.EROIBW8	destinationImage )

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	(	eVision.EUnwarpingLut	lookupTable,
		eVision.EROIBW8	sourceImage,
		eVision.EROIBW8	destinationImage,
		bool	interpolate )

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	(	eVision.EUnwarpingLut	lookupTable,
		eVision.EROIBW8	sourceImage,
		eVision.EROIBW8	destinationImage,
		eVision.ERegion	region )

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	(	eVision.EUnwarpingLut	lookupTable,
		eVision.EROIBW8	sourceImage,
		eVision.EROIBW8	destinationImage,
		eVision.ERegion	region,
		bool	interpolate )

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	(	eVision.EUnwarpingLut	lookupTable,
		eVision.EROIC24	sourceImage,
		eVision.EROIC24	destinationImage )

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	(	eVision.EUnwarpingLut	lookupTable,
		eVision.EROIC24	sourceImage,
		eVision.EROIC24	destinationImage,
		bool	interpolate )

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	(	eVision.EUnwarpingLut	lookupTable,
		eVision.EROIC24	sourceImage,
		eVision.EROIC24	destinationImage,
		eVision.ERegion	region )

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	(	eVision.EUnwarpingLut	lookupTable,
		eVision.EROIC24	sourceImage,
		eVision.EROIC24	destinationImage,
		eVision.ERegion	region,
		bool	interpolate )

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

(

eVision.EPoint

worldPoint

)

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.

Property Documentation

AdvancedCalibrationParameters

eVision.AdvancedCalibrationParameters eVision.ECameraCalibration.AdvancedCalibrationParameters

get

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

Angle

float eVision.ECameraCalibration.Angle

get

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

CalibrationModes

uint eVision.ECameraCalibration.CalibrationModes

get

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.

Center

eVision.EPoint eVision.ECameraCalibration.Center

get

Pixel coordinates of the projection of the world center.

CustomMinDotArea

int eVision.ECameraCalibration.CustomMinDotArea

getset

Gets the minimum dot area.

DefaultAxisSize

float eVision.ECameraCalibration.DefaultAxisSize

get

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

DistortionStrength

float eVision.ECameraCalibration.DistortionStrength

get

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

FieldHeight

float eVision.ECameraCalibration.FieldHeight

get

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.

FieldWidth

float eVision.ECameraCalibration.FieldWidth

get

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.

GridPointsMaxVariation

float eVision.ECameraCalibration.GridPointsMaxVariation

get

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.

GridPointsMaxVariationThreshold

float eVision.ECameraCalibration.GridPointsMaxVariationThreshold

getset

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.

GridPointsMeanVariation

float eVision.ECameraCalibration.GridPointsMeanVariation

get

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.

GridPointsMeanVariationThreshold

float eVision.ECameraCalibration.GridPointsMeanVariationThreshold

getset

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.

HasCustomMinDotArea

bool eVision.ECameraCalibration.HasCustomMinDotArea

get

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

HitLandmark

uint eVision.ECameraCalibration.HitLandmark

get

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

MaxSensorToWorldError

float eVision.ECameraCalibration.MaxSensorToWorldError

get

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

MaxWorldToSensorError

float eVision.ECameraCalibration.MaxWorldToSensorError

get

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

MeanSensorToWorldError

float eVision.ECameraCalibration.MeanSensorToWorldError

get

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

MeanWorldToSensorError

float eVision.ECameraCalibration.MeanWorldToSensorError

get

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

NumLandmark

uint eVision.ECameraCalibration.NumLandmark

get

Number of landmarks.

OpticalCenterX

float eVision.ECameraCalibration.OpticalCenterX

get

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

OpticalCenterY

float eVision.ECameraCalibration.OpticalCenterY

get

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

PerspectiveStrength

float eVision.ECameraCalibration.PerspectiveStrength

get

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).

Ratio

float eVision.ECameraCalibration.Ratio

get

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.

ReprojectionScore

float eVision.ECameraCalibration.ReprojectionScore

get

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.

Scale

float eVision.ECameraCalibration.Scale

get

Scale of the model (X resolution).

SensorHeight

int eVision.ECameraCalibration.SensorHeight

get

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

SensorWidth

int eVision.ECameraCalibration.SensorWidth

get

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

TiltXAngle

float eVision.ECameraCalibration.TiltXAngle

get

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

TiltYAngle

float eVision.ECameraCalibration.TiltYAngle

get

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

XResolution

float eVision.ECameraCalibration.XResolution

get

Horizontal sensor resolution, in pixels per unit.

YResolution

float eVision.ECameraCalibration.YResolution

get

Vertical sensor resolution, in pixels per unit.