eVision.ECameraCalibration Class Reference

Camera calibration. More...

Public Member Functions
None	__init__ (self)
	Constructs a raw camera calibration object.
None	__init__ (self, eVision.ECameraCalibration other)
	Copy constructor.
None	CopyTo (self, eVision.ECameraCalibration other)
	Copy the content of this eVision.ECameraCalibration object to the other object.
None	SetSensor (self, 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, int calibrationModes)
	Sensor characteristics.
None	SetSensor (self, 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.
None	SetSensor (self, 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.
None	SetSensor (self, int sensorWidth, int sensorHeight, float fieldWidth, float fieldHeight, float centerX, float centerY, float angle, float tiltXAngle, float tiltYAngle, float perspectiveStrength, float distortionStrength)
	Sensor characteristics.
None	SetSensor (self, int sensorWidth, int sensorHeight, float fieldWidth, float fieldHeight, float centerX, float centerY, float angle, float tiltXAngle, float tiltYAngle, float perspectiveStrength)
	Sensor characteristics.
None	SetSensor (self, int sensorWidth, int sensorHeight, float fieldWidth, float fieldHeight, float centerX, float centerY, float angle, float tiltXAngle, float tiltYAngle)
	Sensor characteristics.
None	SetSensor (self, int sensorWidth, int sensorHeight, float fieldWidth, float fieldHeight, float centerX, float centerY, float angle, float tiltXAngle)
	Sensor characteristics.
None	SetSensor (self, int sensorWidth, int sensorHeight, float fieldWidth, float fieldHeight, float centerX, float centerY, float angle)
	Sensor characteristics.
None	SetSensor (self, int sensorWidth, int sensorHeight, float fieldWidth, float fieldHeight, float centerX, float centerY)
	Sensor characteristics.
None	SetSensor (self, int sensorWidth, int sensorHeight, float fieldWidth, float fieldHeight, float centerX)
	Sensor characteristics.
None	SetSensor (self, int sensorWidth, int sensorHeight, float fieldWidth, float fieldHeight)
	Sensor characteristics.
None	SetSensor (self, int sensorWidth, int sensorHeight, float fieldWidth)
	Sensor characteristics.
None	SetSensor (self, int sensorWidth, int sensorHeight)
	Sensor characteristics.
None	SetSensorUsingResolution (self, 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, int calibrationModes)
	Sensor characteristics.
None	SetSensorUsingResolution (self, 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.
None	SetSensorUsingResolution (self, 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.
None	SetSensorUsingResolution (self, int sensorWidth, int sensorHeight, float resolutionX, float resolutionY, float centerX, float centerY, float angle, float tiltXAngle, float tiltYAngle, float perspectiveStrength, float distortionStrength)
	Sensor characteristics.
None	SetSensorUsingResolution (self, int sensorWidth, int sensorHeight, float resolutionX, float resolutionY, float centerX, float centerY, float angle, float tiltXAngle, float tiltYAngle, float perspectiveStrength)
	Sensor characteristics.
None	SetSensorUsingResolution (self, int sensorWidth, int sensorHeight, float resolutionX, float resolutionY, float centerX, float centerY, float angle, float tiltXAngle, float tiltYAngle)
	Sensor characteristics.
None	SetSensorUsingResolution (self, int sensorWidth, int sensorHeight, float resolutionX, float resolutionY, float centerX, float centerY, float angle, float tiltXAngle)
	Sensor characteristics.
None	SetSensorUsingResolution (self, int sensorWidth, int sensorHeight, float resolutionX, float resolutionY, float centerX, float centerY, float angle)
	Sensor characteristics.
None	SetSensorUsingResolution (self, int sensorWidth, int sensorHeight, float resolutionX, float resolutionY, float centerX, float centerY)
	Sensor characteristics.
None	SetSensorUsingResolution (self, int sensorWidth, int sensorHeight, float resolutionX, float resolutionY, float centerX)
	Sensor characteristics.
None	SetSensorUsingResolution (self, int sensorWidth, int sensorHeight, float resolutionX, float resolutionY)
	Sensor characteristics.
None	SetSensorUsingResolution (self, int sensorWidth, int sensorHeight, float resolutionX)
	Sensor characteristics.
None	SetSensorUsingResolution (self, int sensorWidth, int sensorHeight)
	Sensor characteristics.
None	SetAffineCalibration (self, int sensorWidth, int sensorHeight, float resolutionX, float resolutionY, float centerX, float centerY, float angle)
	Sets an affine calibration, i.e.
None	SetAffineCalibration (self, int sensorWidth, int sensorHeight, float resolutionX, float resolutionY, float centerX, float centerY)
	Sets an affine calibration, i.e.
None	SetAffineCalibration (self, int sensorWidth, int sensorHeight, float resolutionX, float resolutionY, float centerX)
	Sets an affine calibration, i.e.
None	SetAffineCalibration (self, int sensorWidth, int sensorHeight, float resolutionX, float resolutionY)
	Sets an affine calibration, i.e.
None	SetSensorSize (self, int sensorWidth, int sensorHeight)
	Sets the logical image size, i.e.
None	ResetCustomMinDotArea (self)
	Resets the custom minimum dot area parameter.
bool	IsCalibrationAffine (self)
	Whether the calibration is an affine transformation or not.
eVision.EFrame	ToFrame (self)
	Converts the calibration to a eVision.EFrame where the global coordinates are the world coordinates.
None	EmptyLandmarks (self)
	Resets the landmark specification sequence.
None	AddPoint (self, eVision.EPoint sensorPoint)
	Adds a new point coordinates (in Sensor space) to the set of grid points used for calibration.
None	AddLandmark (self, 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.
None	RemoveLandmark (self, int index)
	Removes a landmark.
eVision.ELandmark	GetLandmark (self, int i)
	Gets a landmark.
None	HitLandmarks (self, int x, int y, float zoomX, float zoomY, float panX, float panY)
	Checks if the cursor is placed over a landmark point.
None	HitLandmarks (self, int x, int y, float zoomX, float zoomY, float panX)
	Checks if the cursor is placed over a landmark point.
None	HitLandmarks (self, int x, int y, float zoomX, float zoomY)
	Checks if the cursor is placed over a landmark point.
None	HitLandmarks (self, int x, int y, float zoomX)
	Checks if the cursor is placed over a landmark point.
None	HitLandmarks (self, int x, int y)
	Checks if the cursor is placed over a landmark point.
None	DragLandmark (self, int x, int y, float zoomX, float zoomY, float panX, float panY)
	Moves the landmark to a new position.
None	DragLandmark (self, int x, int y, float zoomX, float zoomY, float panX)
	Moves the landmark to a new position.
None	DragLandmark (self, int x, int y, float zoomX, float zoomY)
	Moves the landmark to a new position.
None	DragLandmark (self, int x, int y, float zoomX)
	Moves the landmark to a new position.
None	DragLandmark (self, int x, int y)
	Moves the landmark to a new position.
None	Calibrate (self, int calibrationModes)
	Performs a calibration according to the specified combination of calibration modes.
None	Calibrate (self)
	Performs a calibration according to the specified combination of calibration modes.
int	AutoCalibrate (self, bool testEmpiricalModes)
	Returns the best calibration modes for the current calibration grid and calibrates the field of view accordingly.
int	AutoCalibrate (self)
	Returns the best calibration modes for the current calibration grid and calibrates the field of view accordingly.
int	AutoCalibrate (self, int calibrationModes)
	Returns the best calibration modes for the current calibration grid and calibrates the field of view accordingly.
int	AutoCalibrateLandmarks (self, bool testEmpiricalModes)
	Returns the best calibration modes for the current landmark set and calibrates the field of view accordingly.
int	AutoCalibrateLandmarks (self)
	Returns the best calibration modes for the current landmark set and calibrates the field of view accordingly.
int	AutoCalibrateLandmarks (self, int calibrationModes)
	Returns the best calibration modes for the current landmark set and calibrates the field of view accordingly.
int	AutoCalibrateDotGrid (self, eVision.EROIBW8|None sourceImage, float columnPitch, float rowPitch, bool testEmpiricalModes, bool testAdvancedCalibrationMode)
	Performs an automatic calibration based on a dot grid image.
int	AutoCalibrateDotGrid (self, eVision.EROIBW8|None sourceImage, float columnPitch, float rowPitch, bool testEmpiricalModes)
	Performs an automatic calibration based on a dot grid image.
int	AutoCalibrateDotGrid (self, eVision.EROIBW8|None sourceImage, float columnPitch, float rowPitch)
	Performs an automatic calibration based on a dot grid image.
int	AutoCalibrateDotGrid (self, eVision.EROIBW8|None sourceImage, float columnPitch, float rowPitch, int enabledCalibrationModes)
	Performs an automatic calibration based on a dot grid image.
bool	CalibrationSucceeded (self)
	Getter method for the CalibrationSucceeded property.
int	RebuildGrid (self, float colPitch, float rowPitch, int centerIndex, bool direct)
	Reconstructs the grid of points from the given dot centers, to compute the World coordinates of the points.
int	RebuildGrid (self, float colPitch, float rowPitch, int centerIndex)
	Reconstructs the grid of points from the given dot centers, to compute the World coordinates of the points.
int	RebuildGrid (self, float colPitch, float rowPitch)
	Reconstructs the grid of points from the given dot centers, to compute the World coordinates of the points.
int	RebuildGrid (self, float colPitch, float rowPitch, eVision.EPoint worldCenter, int centerIndex, bool direct)
	Reconstructs the grid of points from the given dot centers, to compute the World coordinates of the points.
int	RebuildGrid (self, float colPitch, float rowPitch, eVision.EPoint worldCenter, int centerIndex)
	Reconstructs the grid of points from the given dot centers, to compute the World coordinates of the points.
int	RebuildGrid (self, 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.
None	SetupUnwarp (self, eVision.EUnwarpingLut|None lookupTable, eVision.EROIBW8|None sourceImage, bool interpolate, bool resizeDestination)
	Prepares a lookup table for fast image unwarping.
None	SetupUnwarp (self, eVision.EUnwarpingLut|None lookupTable, eVision.EROIBW8|None sourceImage, bool interpolate)
	Prepares a lookup table for fast image unwarping.
None	SetupUnwarp (self, eVision.EUnwarpingLut|None lookupTable, eVision.EROIBW8|None sourceImage)
	Prepares a lookup table for fast image unwarping.
None	SetupUnwarp (self, eVision.EUnwarpingLut|None lookupTable, eVision.EROIC24|None sourceImage, bool interpolate, bool resizeDestination)
	Prepares a lookup table for fast image unwarping.
None	SetupUnwarp (self, eVision.EUnwarpingLut|None lookupTable, eVision.EROIC24|None sourceImage, bool interpolate)
	Prepares a lookup table for fast image unwarping.
None	SetupUnwarp (self, eVision.EUnwarpingLut|None lookupTable, eVision.EROIC24|None sourceImage)
	Prepares a lookup table for fast image unwarping.
None	Unwarp (self, eVision.EROIBW8|None sourceImage, eVision.EROIBW8|None destinationImage, bool interpolate, bool resizeDestination)
	Unwarps a distorted image using the current calibration model.
None	Unwarp (self, eVision.EROIBW8|None sourceImage, eVision.EROIBW8|None destinationImage, bool interpolate)
	Unwarps a distorted image using the current calibration model.
None	Unwarp (self, eVision.EROIBW8|None sourceImage, eVision.EROIBW8|None destinationImage)
	Unwarps a distorted image using the current calibration model.
None	Unwarp (self, eVision.EROIC24|None sourceImage, eVision.EROIC24|None destinationImage, bool interpolate, bool resizeDestination)
	Unwarps a distorted image using the current calibration model.
None	Unwarp (self, eVision.EROIC24|None sourceImage, eVision.EROIC24|None destinationImage, bool interpolate)
	Unwarps a distorted image using the current calibration model.
None	Unwarp (self, eVision.EROIC24|None sourceImage, eVision.EROIC24|None destinationImage)
	Unwarps a distorted image using the current calibration model.
None	Unwarp (self, eVision.EROIBW8|None sourceImage, eVision.EROIBW8|None destinationImage, eVision.ERegion region, bool interpolate, bool resizeDestination)
	Unwarps a distorted image using the current calibration model.
None	Unwarp (self, eVision.EROIBW8|None sourceImage, eVision.EROIBW8|None destinationImage, eVision.ERegion region, bool interpolate)
	Unwarps a distorted image using the current calibration model.
None	Unwarp (self, eVision.EROIBW8|None sourceImage, eVision.EROIBW8|None destinationImage, eVision.ERegion region)
	Unwarps a distorted image using the current calibration model.
None	Unwarp (self, eVision.EROIC24|None sourceImage, eVision.EROIC24|None destinationImage, eVision.ERegion region, bool interpolate, bool resizeDestination)
	Unwarps a distorted image using the current calibration model.
None	Unwarp (self, eVision.EROIC24|None sourceImage, eVision.EROIC24|None destinationImage, eVision.ERegion region, bool interpolate)
	Unwarps a distorted image using the current calibration model.
None	Unwarp (self, eVision.EROIC24|None sourceImage, eVision.EROIC24|None destinationImage, eVision.ERegion region)
	Unwarps a distorted image using the current calibration model.
None	Unwarp (self, eVision.EUnwarpingLut|None lookupTable, eVision.EROIBW8|None sourceImage, eVision.EROIBW8|None destinationImage, bool interpolate)
	Unwarps a distorted image using the current calibration model.
None	Unwarp (self, eVision.EUnwarpingLut|None lookupTable, eVision.EROIBW8|None sourceImage, eVision.EROIBW8|None destinationImage)
	Unwarps a distorted image using the current calibration model.
None	Unwarp (self, eVision.EUnwarpingLut|None lookupTable, eVision.EROIC24|None sourceImage, eVision.EROIC24|None destinationImage, bool interpolate)
	Unwarps a distorted image using the current calibration model.
None	Unwarp (self, eVision.EUnwarpingLut|None lookupTable, eVision.EROIC24|None sourceImage, eVision.EROIC24|None destinationImage)
	Unwarps a distorted image using the current calibration model.
None	Unwarp (self, eVision.EUnwarpingLut|None lookupTable, eVision.EROIBW8|None sourceImage, eVision.EROIBW8|None destinationImage, eVision.ERegion region, bool interpolate)
	Unwarps a distorted image using the current calibration model.
None	Unwarp (self, eVision.EUnwarpingLut|None lookupTable, eVision.EROIBW8|None sourceImage, eVision.EROIBW8|None destinationImage, eVision.ERegion region)
	Unwarps a distorted image using the current calibration model.
None	Unwarp (self, eVision.EUnwarpingLut|None lookupTable, eVision.EROIC24|None sourceImage, eVision.EROIC24|None destinationImage, eVision.ERegion region, bool interpolate)
	Unwarps a distorted image using the current calibration model.
None	Unwarp (self, eVision.EUnwarpingLut|None lookupTable, eVision.EROIC24|None sourceImage, eVision.EROIC24|None destinationImage, eVision.ERegion region)
	Unwarps a distorted image using the current calibration model.
eVision.ECameraCalibration	GetUnwarpedCalibration (self, eVision.EBaseROI|None sourceImage, bool resizeDestination)
	Gets a eVision.ECameraCalibration instance representing the transformation of image to world coordinates for the result of eVision.ECameraCalibration.Unwarp.
eVision.ECameraCalibration	GetUnwarpedCalibration (self, eVision.EBaseROI|None sourceImage)
	Gets a eVision.ECameraCalibration instance representing the transformation of image to world coordinates for the result of eVision.ECameraCalibration.Unwarp.
eVision.ECameraCalibration	GetUnwarpedCalibration (self, int sourceWidth, int sourceHeight, bool resizeDestination)
	Gets a eVision.ECameraCalibration instance representing the transformation of image to world coordinates for the result of eVision.ECameraCalibration.Unwarp.
eVision.ECameraCalibration	GetUnwarpedCalibration (self, int sourceWidth, int sourceHeight)
	Gets a eVision.ECameraCalibration instance representing the transformation of image to world coordinates for the result of eVision.ECameraCalibration.Unwarp.
eVision.EPoint	SensorToWorld (self, eVision.EPoint sensorPoint)
	Performs coordinate transform for arbitrary points from Sensor space to World space.
eVision.EPoint	WorldToSensor (self, eVision.EPoint worldPoint)
	Performs coordinate transform for arbitrary points from World space to Sensor space.
None	Draw (self, eVision.EDrawAdapter|None graphicContext, float zoomX, float zoomY, float panX, float panY)
	Draws the world coordinate axis.
None	Draw (self, eVision.EDrawAdapter|None graphicContext, float zoomX, float zoomY, float panX)
	Draws the world coordinate axis.
None	Draw (self, eVision.EDrawAdapter|None graphicContext, float zoomX, float zoomY)
	Draws the world coordinate axis.
None	Draw (self, eVision.EDrawAdapter|None graphicContext, float zoomX)
	Draws the world coordinate axis.
None	Draw (self, eVision.EDrawAdapter|None graphicContext)
	Draws the world coordinate axis.
None	Draw (self, eVision.EDrawAdapter|None graphicContext, float xAxisSize, float yAxisSize, float zoomX, float zoomY, float panX, float panY)
	Draws the world coordinate axis.
None	DrawCrossGrid (self, eVision.EDrawAdapter|None graphicContext, float minimumX, float maximumX, float minimumY, float maximumY, int numberOfIntervalsX, int numberOfIntervalsY, float zoomX, float zoomY, float panX, float panY)
	Draws a regular grid of crosses in world coordinates.
None	DrawCrossGrid (self, eVision.EDrawAdapter|None graphicContext, float minimumX, float maximumX, float minimumY, float maximumY, int numberOfIntervalsX, int numberOfIntervalsY, float zoomX, float zoomY, float panX)
	Draws a regular grid of crosses in world coordinates.
None	DrawCrossGrid (self, eVision.EDrawAdapter|None graphicContext, float minimumX, float maximumX, float minimumY, float maximumY, int numberOfIntervalsX, int numberOfIntervalsY, float zoomX, float zoomY)
	Draws a regular grid of crosses in world coordinates.
None	DrawCrossGrid (self, eVision.EDrawAdapter|None graphicContext, float minimumX, float maximumX, float minimumY, float maximumY, int numberOfIntervalsX, int numberOfIntervalsY, float zoomX)
	Draws a regular grid of crosses in world coordinates.
None	DrawCrossGrid (self, eVision.EDrawAdapter|None graphicContext, float minimumX, float maximumX, float minimumY, float maximumY, int numberOfIntervalsX, int numberOfIntervalsY)
	Draws a regular grid of crosses in world coordinates.
None	DrawCrossGrid (self, eVision.EDrawAdapter|None graphicContext, float minimumX, float maximumX, float minimumY, float maximumY, int numberOfIntervalsX)
	Draws a regular grid of crosses in world coordinates.
None	DrawCrossGrid (self, eVision.EDrawAdapter|None graphicContext, float minimumX, float maximumX, float minimumY, float maximumY)
	Draws a regular grid of crosses in world coordinates.
None	DrawCrossGrid (self, eVision.EDrawAdapter|None graphicContext, float minimumX, float maximumX, float minimumY)
	Draws a regular grid of crosses in world coordinates.
None	DrawCrossGrid (self, eVision.EDrawAdapter|None graphicContext, float minimumX, float maximumX)
	Draws a regular grid of crosses in world coordinates.
None	DrawCrossGrid (self, eVision.EDrawAdapter|None graphicContext, float minimumX)
	Draws a regular grid of crosses in world coordinates.
None	DrawCrossGrid (self, eVision.EDrawAdapter|None graphicContext)
	Draws a regular grid of crosses in world coordinates.
None	DrawGrid (self, eVision.EDrawAdapter|None graphicContext, float zoomX, float zoomY, float panX, float panY)
	Draws the reconstructed grid to be used for grid calibration.
None	DrawGrid (self, eVision.EDrawAdapter|None graphicContext, float zoomX, float zoomY, float panX)
	Draws the reconstructed grid to be used for grid calibration.
None	DrawGrid (self, eVision.EDrawAdapter|None graphicContext, float zoomX, float zoomY)
	Draws the reconstructed grid to be used for grid calibration.
None	DrawGrid (self, eVision.EDrawAdapter|None graphicContext, float zoomX)
	Draws the reconstructed grid to be used for grid calibration.
None	DrawGrid (self, eVision.EDrawAdapter|None graphicContext)
	Draws the reconstructed grid to be used for grid calibration.
None	DrawLandmarks (self, eVision.EDrawAdapter|None graphicContext, float zoomX, float zoomY, float panX, float panY)
	Draws the landmarks to be used for landmark calibration.
None	DrawLandmarks (self, eVision.EDrawAdapter|None graphicContext, float zoomX, float zoomY, float panX)
	Draws the landmarks to be used for landmark calibration.
None	DrawLandmarks (self, eVision.EDrawAdapter|None graphicContext, float zoomX, float zoomY)
	Draws the landmarks to be used for landmark calibration.
None	DrawLandmarks (self, eVision.EDrawAdapter|None graphicContext, float zoomX)
	Draws the landmarks to be used for landmark calibration.
None	DrawLandmarks (self, eVision.EDrawAdapter|None graphicContext)
	Draws the landmarks to be used for landmark calibration.
None	Load (self, str path)
	Loads the eVision.ECameraCalibration.
None	Load (self, eVision.ESerializer|None serializer)
	Loads the eVision.ECameraCalibration.
None	Save (self, str path)
	Saves the eVision.ECameraCalibration.
None	Save (self, eVision.ESerializer|None serializer)
	Saves the eVision.ECameraCalibration.
float	FieldWidth (self)
	Field-of-view width, in physical units.
float	FieldHeight (self)
	Field-of-view height, in physical units.
float	Angle (self)
	Angle of the principal direction of the world plane with respect to the x-axis of the image.
float	Ratio (self)
	XResolution/YResolution ratio.
float	Scale (self)
	Scale of the model (X resolution).
eVision.EPoint	Center (self)
	Pixel coordinates of the projection of the world center.
int	SensorWidth (self)
	Logical image width, that is the number of pixels horizontally.
int	SensorHeight (self)
	Logical image height, that is the number of pixels vertically.
float	XResolution (self)
	Horizontal sensor resolution, in pixels per unit.
float	YResolution (self)
	Vertical sensor resolution, in pixels per unit.
float	TiltXAngle (self)
	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 (self)
	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 (self)
	Perspective strength.
float	DistortionStrength (self)
	Optical distortion strength (the ratio of the image diagonal length with and without optical distortion introduced by the lens).
float	OpticalCenterX (self)
	X coordinate of the optical center of the sensor in the image (in pixels).
float	OpticalCenterY (self)
	Y coordinate of the optical center of the sensor in the image (in pixels).
int	CalibrationModes (self)
	Current calibration mode, made from a combination of values.
bool	HasCustomMinDotArea (self)
	Returns if a custom minimum dot area has been previously set.
int	CustomMinDotArea (self)
	Gets the minimum dot area.
	CustomMinDotArea (self, int value)
	Gets the minimum dot area.
int	NumLandmark (self)
	Number of landmarks.
int	HitLandmark (self)
	Returns the landmark selected by eVision.ECameraCalibration.HitLandmarks or ~0 if no landmark is selected.
float	ReprojectionScore (self)
	Reproject score (average squared distance between a landmark and its projection in the image using the calibrated model).
float	MeanWorldToSensorError (self)
	Mean WorldToSensor error over all valid landmarks (root mean square error, RMSE).
float	MaxWorldToSensorError (self)
	Maximum WorldToSensor error over all valid landmarks (maximum distance between a landmark and its projection in the image using the calibrated model).
float	MeanSensorToWorldError (self)
	Mean SensorToWorld error over all valid landmarks (root mean square error, RMSE).
float	MaxSensorToWorldError (self)
	Maximum SensorToWorld error over all valid landmarks (maximum distance between a landmark and its projection in world space using the calibrated model).
float	GridPointsMeanVariation (self)
	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 eVision.ECameraCalibration.CalibrationSucceeded.
float	GridPointsMaxVariation (self)
	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 eVision.ECameraCalibration.CalibrationSucceeded.
float	GridPointsMeanVariationThreshold (self)
	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 eVision.ECameraCalibration.CalibrationSucceeded.
	GridPointsMeanVariationThreshold (self, float value)
	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 eVision.ECameraCalibration.CalibrationSucceeded.
float	GridPointsMaxVariationThreshold (self)
	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 eVision.ECameraCalibration.CalibrationSucceeded.
	GridPointsMaxVariationThreshold (self, float value)
	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 eVision.ECameraCalibration.CalibrationSucceeded.
float	DefaultAxisSize (self)
	The default size of axis when drawing with eVision.ECameraCalibration.Draw.
eVision.AdvancedCalibrationParameters	AdvancedCalibrationParameters (self)
	Get the advanced calibration parameters.

Detailed Description

Camera calibration.

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

Remarks:

License(s): BasicTypes

Constructor & Destructor Documentation

__init__() [1/2]

None eVision.ECameraCalibration.__init__

(

self

)

Constructs a raw camera calibration object.

__init__() [2/2]

None eVision.ECameraCalibration.__init__	(		self,
		eVision.ECameraCalibration	other )

Copy constructor.

Parameters

other

Other eVision.ECameraCalibration object.

Member Function Documentation

AddLandmark()

None eVision.ECameraCalibration.AddLandmark	(		self,
		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.

Remarks:

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.

Parameters

sensorPoint	Sensor point coordinates.
worldPoint	Corresponding World point coordinates.

AddPoint()

None eVision.ECameraCalibration.AddPoint	(		self,
		eVision.EPoint	sensorPoint )

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

Remarks:

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.

Parameters

sensorPoint

Sensor point coordinates.

AdvancedCalibrationParameters()

eVision.AdvancedCalibrationParameters eVision.ECameraCalibration.AdvancedCalibrationParameters

(

self

)

Get the advanced calibration parameters.

Throws if the calibration mode is not advanced.

Angle()

float eVision.ECameraCalibration.Angle

(

self

)

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

AutoCalibrate() [1/3]

int eVision.ECameraCalibration.AutoCalibrate

(

self

)

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

Remarks:

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

By default, only combination of the calibration modes eVision.ECalibrationMode.Scaled, eVision.ECalibrationMode.Skewed, eVision.ECalibrationMode.Radial, eVision.ECalibrationMode.Tilted, and eVision.ECalibrationMode.Anisotropic are considered. The eVision.ECalibrationMode.Advanced calibration mode must be explicitly selected to be considered.

AutoCalibrate() [2/3]

int eVision.ECameraCalibration.AutoCalibrate	(		self,
		bool	testEmpiricalModes )

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

Remarks:

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

By default, only combination of the calibration modes eVision.ECalibrationMode.Scaled, eVision.ECalibrationMode.Skewed, eVision.ECalibrationMode.Radial, eVision.ECalibrationMode.Tilted, and eVision.ECalibrationMode.Anisotropic are considered. The eVision.ECalibrationMode.Advanced calibration mode must be explicitly selected to be considered.

Parameters

testEmpiricalModes

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

AutoCalibrate() [3/3]

int eVision.ECameraCalibration.AutoCalibrate	(		self,
		int	calibrationModes )

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

Remarks:

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

By default, only combination of the calibration modes eVision.ECalibrationMode.Scaled, eVision.ECalibrationMode.Skewed, eVision.ECalibrationMode.Radial, eVision.ECalibrationMode.Tilted, and eVision.ECalibrationMode.Anisotropic are considered. The eVision.ECalibrationMode.Advanced calibration mode must be explicitly selected to be considered.

Parameters

calibrationModes

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

AutoCalibrateDotGrid() [1/4]

int eVision.ECameraCalibration.AutoCalibrateDotGrid	(		self,
		eVision.EROIBW8 | None	sourceImage,
		float	columnPitch,
		float	rowPitch )

Performs an automatic calibration based on a dot grid image.

Remarks:

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 eVision.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 eVision.ECalibrationMode.Scaled, eVision.ECalibrationMode.Skewed, eVision.ECalibrationMode.Radial, eVision.ECalibrationMode.Tilted, and eVision.ECalibrationMode.Anisotropic are considered. The eVision.ECalibrationMode.Advanced calibration mode must be explicitly selected to be considered.

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.

AutoCalibrateDotGrid() [2/4]

int eVision.ECameraCalibration.AutoCalibrateDotGrid	(		self,
		eVision.EROIBW8 | None	sourceImage,
		float	columnPitch,
		float	rowPitch,
		bool	testEmpiricalModes )

Performs an automatic calibration based on a dot grid image.

Remarks:

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 eVision.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 eVision.ECalibrationMode.Scaled, eVision.ECalibrationMode.Skewed, eVision.ECalibrationMode.Radial, eVision.ECalibrationMode.Tilted, and eVision.ECalibrationMode.Anisotropic are considered. The eVision.ECalibrationMode.Advanced calibration mode must be explicitly selected to be considered.

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 (eVision.ECalibrationMode.Quadratic) should be considered when determining the best calibration modes. Default value is false.

AutoCalibrateDotGrid() [3/4]

int eVision.ECameraCalibration.AutoCalibrateDotGrid	(		self,
		eVision.EROIBW8 | None	sourceImage,
		float	columnPitch,
		float	rowPitch,
		bool	testEmpiricalModes,
		bool	testAdvancedCalibrationMode )

Performs an automatic calibration based on a dot grid image.

Remarks:

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 eVision.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 eVision.ECalibrationMode.Scaled, eVision.ECalibrationMode.Skewed, eVision.ECalibrationMode.Radial, eVision.ECalibrationMode.Tilted, and eVision.ECalibrationMode.Anisotropic are considered. The eVision.ECalibrationMode.Advanced calibration mode must be explicitly selected to be considered.

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 (eVision.ECalibrationMode.Quadratic) should be considered when determining the best calibration modes. Default value is false.
testAdvancedCalibrationMode	Boolean indicating whether the advanced calibration mode (eVision.ECalibrationMode.Advanced) should be considered when determining the best calibration modes. Default value is false.

AutoCalibrateDotGrid() [4/4]

int eVision.ECameraCalibration.AutoCalibrateDotGrid	(		self,
		eVision.EROIBW8 | None	sourceImage,
		float	columnPitch,
		float	rowPitch,
		int	enabledCalibrationModes )

Performs an automatic calibration based on a dot grid image.

Remarks:

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 eVision.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 eVision.ECalibrationMode.Scaled, eVision.ECalibrationMode.Skewed, eVision.ECalibrationMode.Radial, eVision.ECalibrationMode.Tilted, and eVision.ECalibrationMode.Anisotropic are considered. The eVision.ECalibrationMode.Advanced calibration mode must be explicitly selected to be considered.

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

AutoCalibrateLandmarks() [1/3]

int eVision.ECameraCalibration.AutoCalibrateLandmarks

(

self

)

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

Remarks:

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 eVision.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 eVision.ECameraCalibration.AutoCalibrate method instead.

By default, only combination of the calibration modes eVision.ECalibrationMode.Scaled, eVision.ECalibrationMode.Skewed, eVision.ECalibrationMode.Radial, eVision.ECalibrationMode.Tilted, and eVision.ECalibrationMode.Anisotropic are considered. The eVision.ECalibrationMode.Advanced calibration mode must be explicitly selected to be considered.

AutoCalibrateLandmarks() [2/3]

int eVision.ECameraCalibration.AutoCalibrateLandmarks	(		self,
		bool	testEmpiricalModes )

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

Remarks:

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 eVision.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 eVision.ECameraCalibration.AutoCalibrate method instead.

By default, only combination of the calibration modes eVision.ECalibrationMode.Scaled, eVision.ECalibrationMode.Skewed, eVision.ECalibrationMode.Radial, eVision.ECalibrationMode.Tilted, and eVision.ECalibrationMode.Anisotropic are considered. The eVision.ECalibrationMode.Advanced calibration mode must be explicitly selected to be considered.

Parameters

testEmpiricalModes

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

AutoCalibrateLandmarks() [3/3]

int eVision.ECameraCalibration.AutoCalibrateLandmarks	(		self,
		int	calibrationModes )

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

Remarks:

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 eVision.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 eVision.ECameraCalibration.AutoCalibrate method instead.

By default, only combination of the calibration modes eVision.ECalibrationMode.Scaled, eVision.ECalibrationMode.Skewed, eVision.ECalibrationMode.Radial, eVision.ECalibrationMode.Tilted, and eVision.ECalibrationMode.Anisotropic are considered. The eVision.ECalibrationMode.Advanced calibration mode must be explicitly selected to be considered.

Parameters

calibrationModes

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

Calibrate() [1/2]

None eVision.ECameraCalibration.Calibrate

(

self

)

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

Remarks:

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, eVision.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]

None eVision.ECameraCalibration.Calibrate	(		self,
		int	calibrationModes )

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

Remarks:

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, eVision.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.

Parameters

calibrationModes

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

CalibrationModes()

int eVision.ECameraCalibration.CalibrationModes

(

self

)

Current calibration mode, made from a combination of values.

Remarks:

The supported calibration modes can be set to eVision.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 eVision.ECalibrationMode.

CalibrationSucceeded()

bool eVision.ECameraCalibration.CalibrationSucceeded

(

self

)

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.

Remarks:

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

Center()

eVision.EPoint eVision.ECameraCalibration.Center

(

self

)

Pixel coordinates of the projection of the world center.

CopyTo()

None eVision.ECameraCalibration.CopyTo	(		self,
		eVision.ECameraCalibration	other )

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

Parameters

other

Object to copy to.

CustomMinDotArea() [1/2]

int eVision.ECameraCalibration.CustomMinDotArea

(

self

)

Gets the minimum dot area.

CustomMinDotArea() [2/2]

eVision.ECameraCalibration.CustomMinDotArea	(		self,
		int	value )

Gets the minimum dot area.

DefaultAxisSize()

float eVision.ECameraCalibration.DefaultAxisSize

(

self

)

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

DistortionStrength()

float eVision.ECameraCalibration.DistortionStrength

(

self

)

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

DragLandmark() [1/5]

None eVision.ECameraCalibration.DragLandmark	(		self,
		int	x,
		int	y )

Moves the landmark to a new position.

Parameters

x	Current cursor coordinates.
y	Current cursor coordinates.

DragLandmark() [2/5]

None eVision.ECameraCalibration.DragLandmark	(		self,
		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]

None eVision.ECameraCalibration.DragLandmark	(		self,
		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]

None eVision.ECameraCalibration.DragLandmark	(		self,
		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]

None eVision.ECameraCalibration.DragLandmark	(		self,
		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]

None eVision.ECameraCalibration.Draw	(		self,
		eVision.EDrawAdapter | None	graphicContext )

Draws the world coordinate axis.

Parameters

graphicContext

Handle of the device context on which to draw.

Draw() [2/6]

None eVision.ECameraCalibration.Draw	(		self,
		eVision.EDrawAdapter | None	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]

None eVision.ECameraCalibration.Draw	(		self,
		eVision.EDrawAdapter | None	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]

None eVision.ECameraCalibration.Draw	(		self,
		eVision.EDrawAdapter | None	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]

None eVision.ECameraCalibration.Draw	(		self,
		eVision.EDrawAdapter | None	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]

None eVision.ECameraCalibration.Draw	(		self,
		eVision.EDrawAdapter | None	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]

None eVision.ECameraCalibration.DrawCrossGrid	(		self,
		eVision.EDrawAdapter | None	graphicContext )

Draws a regular grid of crosses in world coordinates.

Parameters

graphicContext

Handle of the device context on which to draw.

DrawCrossGrid() [2/11]

None eVision.ECameraCalibration.DrawCrossGrid	(		self,
		eVision.EDrawAdapter | None	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]

None eVision.ECameraCalibration.DrawCrossGrid	(		self,
		eVision.EDrawAdapter | None	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]

None eVision.ECameraCalibration.DrawCrossGrid	(		self,
		eVision.EDrawAdapter | None	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]

None eVision.ECameraCalibration.DrawCrossGrid	(		self,
		eVision.EDrawAdapter | None	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]

None eVision.ECameraCalibration.DrawCrossGrid	(		self,
		eVision.EDrawAdapter | None	graphicContext,
		float	minimumX,
		float	maximumX,
		float	minimumY,
		float	maximumY,
		int	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]

None eVision.ECameraCalibration.DrawCrossGrid	(		self,
		eVision.EDrawAdapter | None	graphicContext,
		float	minimumX,
		float	maximumX,
		float	minimumY,
		float	maximumY,
		int	numberOfIntervalsX,
		int	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]

None eVision.ECameraCalibration.DrawCrossGrid	(		self,
		eVision.EDrawAdapter | None	graphicContext,
		float	minimumX,
		float	maximumX,
		float	minimumY,
		float	maximumY,
		int	numberOfIntervalsX,
		int	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]

None eVision.ECameraCalibration.DrawCrossGrid	(		self,
		eVision.EDrawAdapter | None	graphicContext,
		float	minimumX,
		float	maximumX,
		float	minimumY,
		float	maximumY,
		int	numberOfIntervalsX,
		int	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]

None eVision.ECameraCalibration.DrawCrossGrid	(		self,
		eVision.EDrawAdapter | None	graphicContext,
		float	minimumX,
		float	maximumX,
		float	minimumY,
		float	maximumY,
		int	numberOfIntervalsX,
		int	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]

None eVision.ECameraCalibration.DrawCrossGrid	(		self,
		eVision.EDrawAdapter | None	graphicContext,
		float	minimumX,
		float	maximumX,
		float	minimumY,
		float	maximumY,
		int	numberOfIntervalsX,
		int	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]

None eVision.ECameraCalibration.DrawGrid	(		self,
		eVision.EDrawAdapter | None	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]

None eVision.ECameraCalibration.DrawGrid	(		self,
		eVision.EDrawAdapter | None	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]

None eVision.ECameraCalibration.DrawGrid	(		self,
		eVision.EDrawAdapter | None	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]

None eVision.ECameraCalibration.DrawGrid	(		self,
		eVision.EDrawAdapter | None	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]

None eVision.ECameraCalibration.DrawGrid	(		self,
		eVision.EDrawAdapter | None	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]

None eVision.ECameraCalibration.DrawLandmarks	(		self,
		eVision.EDrawAdapter | None	graphicContext )

Draws the landmarks to be used for landmark calibration.

Parameters

graphicContext

Handle of the device context on which to draw.

DrawLandmarks() [2/5]

None eVision.ECameraCalibration.DrawLandmarks	(		self,
		eVision.EDrawAdapter | None	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]

None eVision.ECameraCalibration.DrawLandmarks	(		self,
		eVision.EDrawAdapter | None	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]

None eVision.ECameraCalibration.DrawLandmarks	(		self,
		eVision.EDrawAdapter | None	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]

None eVision.ECameraCalibration.DrawLandmarks	(		self,
		eVision.EDrawAdapter | None	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()

None eVision.ECameraCalibration.EmptyLandmarks

(

self

)

Resets the landmark specification sequence.

Remarks:

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.

FieldHeight()

float eVision.ECameraCalibration.FieldHeight

(

self

)

Field-of-view height, in physical units.

Remarks:

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

(

self

)

Field-of-view width, in physical units.

Remarks:

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.

GetLandmark()

eVision.ELandmark eVision.ECameraCalibration.GetLandmark	(		self,
		int	i )

Gets a landmark.

Parameters

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

GetUnwarpedCalibration() [1/4]

eVision.ECameraCalibration eVision.ECameraCalibration.GetUnwarpedCalibration	(		self,
		eVision.EBaseROI | None	sourceImage )

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

Parameters

sourceImage

Image to unwarp.

GetUnwarpedCalibration() [2/4]

eVision.ECameraCalibration eVision.ECameraCalibration.GetUnwarpedCalibration	(		self,
		eVision.EBaseROI | None	sourceImage,
		bool	resizeDestination )

Gets a eVision.ECameraCalibration instance representing the transformation of image to world coordinates for the result of eVision.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	(		self,
		int	sourceWidth,
		int	sourceHeight )

Gets a eVision.ECameraCalibration instance representing the transformation of image to world coordinates for the result of eVision.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	(		self,
		int	sourceWidth,
		int	sourceHeight,
		bool	resizeDestination )

Gets a eVision.ECameraCalibration instance representing the transformation of image to world coordinates for the result of eVision.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.

GridPointsMaxVariation()

float eVision.ECameraCalibration.GridPointsMaxVariation

(

self

)

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 eVision.ECameraCalibration.CalibrationSucceeded.

Remarks:

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

GridPointsMaxVariationThreshold() [1/2]

float eVision.ECameraCalibration.GridPointsMaxVariationThreshold

(

self

)

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 eVision.ECameraCalibration.CalibrationSucceeded.

Remarks:

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

GridPointsMaxVariationThreshold() [2/2]

eVision.ECameraCalibration.GridPointsMaxVariationThreshold	(		self,
		float	value )

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 eVision.ECameraCalibration.CalibrationSucceeded.

Remarks:

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

GridPointsMeanVariation()

float eVision.ECameraCalibration.GridPointsMeanVariation

(

self

)

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 eVision.ECameraCalibration.CalibrationSucceeded.

Remarks:

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

GridPointsMeanVariationThreshold() [1/2]

float eVision.ECameraCalibration.GridPointsMeanVariationThreshold

(

self

)

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 eVision.ECameraCalibration.CalibrationSucceeded.

Remarks:

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

GridPointsMeanVariationThreshold() [2/2]

eVision.ECameraCalibration.GridPointsMeanVariationThreshold	(		self,
		float	value )

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 eVision.ECameraCalibration.CalibrationSucceeded.

Remarks:

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

HasCustomMinDotArea()

bool eVision.ECameraCalibration.HasCustomMinDotArea

(

self

)

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

HitLandmark()

int eVision.ECameraCalibration.HitLandmark

(

self

)

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

HitLandmarks() [1/5]

None eVision.ECameraCalibration.HitLandmarks	(		self,
		int	x,
		int	y )

Checks if the cursor is placed over a landmark point.

Remarks:

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.

Parameters

x	Current cursor coordinates.
y	Current cursor coordinates.

HitLandmarks() [2/5]

None eVision.ECameraCalibration.HitLandmarks	(		self,
		int	x,
		int	y,
		float	zoomX )

Checks if the cursor is placed over a landmark point.

Remarks:

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.

Parameters

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

HitLandmarks() [3/5]

None eVision.ECameraCalibration.HitLandmarks	(		self,
		int	x,
		int	y,
		float	zoomX,
		float	zoomY )

Checks if the cursor is placed over a landmark point.

Remarks:

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.

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.

HitLandmarks() [4/5]

None eVision.ECameraCalibration.HitLandmarks	(		self,
		int	x,
		int	y,
		float	zoomX,
		float	zoomY,
		float	panX )

Checks if the cursor is placed over a landmark point.

Remarks:

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.

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.

HitLandmarks() [5/5]

None eVision.ECameraCalibration.HitLandmarks	(		self,
		int	x,
		int	y,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY )

Checks if the cursor is placed over a landmark point.

Remarks:

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.

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.

IsCalibrationAffine()

bool eVision.ECameraCalibration.IsCalibrationAffine

(

self

)

Whether the calibration is an affine transformation or not.

A calibration is affine when the eVision.ECameraCalibration.CalibrationModes do not include either eVision.ECalibrationMode.Skewed, eVision.ECalibrationMode.Radial, eVision.ECalibrationMode.Advanced, or eVision.ECalibrationMode.Quadratic.

Load() [1/2]

None eVision.ECameraCalibration.Load	(		self,
		eVision.ESerializer | None	serializer )

Loads the eVision.ECameraCalibration.

The given eVision.ESerializer must have been created for reading.

Parameters

serializer

The serializer.

Load() [2/2]

None eVision.ECameraCalibration.Load	(		self,
		str	path )

Loads the eVision.ECameraCalibration.

The given eVision.ESerializer must have been created for reading.

Parameters

path	The file path.

MaxSensorToWorldError()

float eVision.ECameraCalibration.MaxSensorToWorldError

(

self

)

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

(

self

)

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

(

self

)

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

MeanWorldToSensorError()

float eVision.ECameraCalibration.MeanWorldToSensorError

(

self

)

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

NumLandmark()

int eVision.ECameraCalibration.NumLandmark

(

self

)

Number of landmarks.

OpticalCenterX()

float eVision.ECameraCalibration.OpticalCenterX

(

self

)

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

OpticalCenterY()

float eVision.ECameraCalibration.OpticalCenterY

(

self

)

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

PerspectiveStrength()

float eVision.ECameraCalibration.PerspectiveStrength

(

self

)

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

(

self

)

XResolution/YResolution ratio.

Remarks:

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.

RebuildGrid() [1/6]

int eVision.ECameraCalibration.RebuildGrid	(		self,
		float	colPitch,
		float	rowPitch )

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

Remarks:

This member function also returns the number of grid points that were connected. This prepares the calibration using landmarks (for use by member eVision.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.

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.

RebuildGrid() [2/6]

int eVision.ECameraCalibration.RebuildGrid	(		self,
		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.

Remarks:

This member function also returns the number of grid points that were connected. This prepares the calibration using landmarks (for use by member eVision.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.

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.

RebuildGrid() [3/6]

int eVision.ECameraCalibration.RebuildGrid	(		self,
		float	colPitch,
		float	rowPitch,
		eVision.EPoint	worldCenter,
		int	centerIndex )

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

Remarks:

This member function also returns the number of grid points that were connected. This prepares the calibration using landmarks (for use by member eVision.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.

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.

RebuildGrid() [4/6]

int eVision.ECameraCalibration.RebuildGrid	(		self,
		float	colPitch,
		float	rowPitch,
		eVision.EPoint	worldCenter,
		int	centerIndex,
		bool	direct )

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

Remarks:

This member function also returns the number of grid points that were connected. This prepares the calibration using landmarks (for use by member eVision.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.

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.

RebuildGrid() [5/6]

int eVision.ECameraCalibration.RebuildGrid	(		self,
		float	colPitch,
		float	rowPitch,
		int	centerIndex )

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

Remarks:

This member function also returns the number of grid points that were connected. This prepares the calibration using landmarks (for use by member eVision.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.

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.

RebuildGrid() [6/6]

int eVision.ECameraCalibration.RebuildGrid	(		self,
		float	colPitch,
		float	rowPitch,
		int	centerIndex,
		bool	direct )

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

Remarks:

This member function also returns the number of grid points that were connected. This prepares the calibration using landmarks (for use by member eVision.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.

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.

RemoveLandmark()

None eVision.ECameraCalibration.RemoveLandmark	(		self,
		int	index )

Removes a landmark.

Parameters

index

Index of the landmark to be removed.

ReprojectionScore()

float eVision.ECameraCalibration.ReprojectionScore

(

self

)

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.

ResetCustomMinDotArea()

None eVision.ECameraCalibration.ResetCustomMinDotArea

(

self

)

Resets the custom minimum dot area parameter.

The heurestic described in SetMinDotArea is used again.

Save() [1/2]

None eVision.ECameraCalibration.Save	(		self,
		eVision.ESerializer | None	serializer )

Saves the eVision.ECameraCalibration.

The given eVision.ESerializer must have been created for writing.

Parameters

serializer

The eVision.ESerializer object that is written to.

Save() [2/2]

None eVision.ECameraCalibration.Save	(		self,
		str	path )

Saves the eVision.ECameraCalibration.

The given eVision.ESerializer must have been created for writing.

Parameters

path	The file path.

Scale()

float eVision.ECameraCalibration.Scale

(

self

)

Scale of the model (X resolution).

SensorHeight()

int eVision.ECameraCalibration.SensorHeight

(

self

)

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

SensorToWorld()

eVision.EPoint eVision.ECameraCalibration.SensorToWorld	(		self,
		eVision.EPoint	sensorPoint )

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

Remarks:

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.

Parameters

sensorPoint

Sensor point.

SensorWidth()

int eVision.ECameraCalibration.SensorWidth

(

self

)

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

SetAffineCalibration() [1/4]

None eVision.ECameraCalibration.SetAffineCalibration	(		self,
		int	sensorWidth,
		int	sensorHeight,
		float	resolutionX,
		float	resolutionY )

Sets an affine calibration, i.e.

a calibration model without distortion or perspective.

The eVision.ECameraCalibration.CalibrationModes will include eVision.ECalibrationMode.Scaled and according to the arguments eVision.ECalibrationMode.Anisotropic, eVision.ECalibrationMode.Inverse, or eVision.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]

None eVision.ECameraCalibration.SetAffineCalibration	(		self,
		int	sensorWidth,
		int	sensorHeight,
		float	resolutionX,
		float	resolutionY,
		float	centerX )

Sets an affine calibration, i.e.

a calibration model without distortion or perspective.

The eVision.ECameraCalibration.CalibrationModes will include eVision.ECalibrationMode.Scaled and according to the arguments eVision.ECalibrationMode.Anisotropic, eVision.ECalibrationMode.Inverse, or eVision.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]

None eVision.ECameraCalibration.SetAffineCalibration	(		self,
		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 eVision.ECameraCalibration.CalibrationModes will include eVision.ECalibrationMode.Scaled and according to the arguments eVision.ECalibrationMode.Anisotropic, eVision.ECalibrationMode.Inverse, or eVision.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]

None eVision.ECameraCalibration.SetAffineCalibration	(		self,
		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 eVision.ECameraCalibration.CalibrationModes will include eVision.ECalibrationMode.Scaled and according to the arguments eVision.ECalibrationMode.Anisotropic, eVision.ECalibrationMode.Inverse, or eVision.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]

None eVision.ECameraCalibration.SetSensor	(		self,
		int	sensorWidth,
		int	sensorHeight )

Sensor characteristics.

Remarks:

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 eVision.ECameraCalibration.CalibrationModes, not a simpler one.

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.

SetSensor() [2/13]

None eVision.ECameraCalibration.SetSensor	(		self,
		int	sensorWidth,
		int	sensorHeight,
		float	fieldWidth )

Sensor characteristics.

Remarks:

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 eVision.ECameraCalibration.CalibrationModes, not a simpler one.

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.

SetSensor() [3/13]

None eVision.ECameraCalibration.SetSensor	(		self,
		int	sensorWidth,
		int	sensorHeight,
		float	fieldWidth,
		float	fieldHeight )

Sensor characteristics.

Remarks:

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 eVision.ECameraCalibration.CalibrationModes, not a simpler one.

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.

SetSensor() [4/13]

None eVision.ECameraCalibration.SetSensor	(		self,
		int	sensorWidth,
		int	sensorHeight,
		float	fieldWidth,
		float	fieldHeight,
		float	centerX )

Sensor characteristics.

Remarks:

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 eVision.ECameraCalibration.CalibrationModes, not a simpler one.

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 eVision.ECalibrationMode.Raw, it is set to 0. Otherwise, it is set to the image center.

SetSensor() [5/13]

None eVision.ECameraCalibration.SetSensor	(		self,
		int	sensorWidth,
		int	sensorHeight,
		float	fieldWidth,
		float	fieldHeight,
		float	centerX,
		float	centerY )

Sensor characteristics.

Remarks:

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 eVision.ECameraCalibration.CalibrationModes, not a simpler one.

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 eVision.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 eVision.ECalibrationMode.Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain eVision.ECalibrationMode.Inverse). Otherwise, it is set to the image center.

SetSensor() [6/13]

None eVision.ECameraCalibration.SetSensor	(		self,
		int	sensorWidth,
		int	sensorHeight,
		float	fieldWidth,
		float	fieldHeight,
		float	centerX,
		float	centerY,
		float	angle )

Sensor characteristics.

Remarks:

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 eVision.ECameraCalibration.CalibrationModes, not a simpler one.

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 eVision.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 eVision.ECalibrationMode.Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain eVision.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.

SetSensor() [7/13]

None eVision.ECameraCalibration.SetSensor	(		self,
		int	sensorWidth,
		int	sensorHeight,
		float	fieldWidth,
		float	fieldHeight,
		float	centerX,
		float	centerY,
		float	angle,
		float	tiltXAngle )

Sensor characteristics.

Remarks:

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 eVision.ECameraCalibration.CalibrationModes, not a simpler one.

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 eVision.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 eVision.ECalibrationMode.Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain eVision.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.

SetSensor() [8/13]

None eVision.ECameraCalibration.SetSensor	(		self,
		int	sensorWidth,
		int	sensorHeight,
		float	fieldWidth,
		float	fieldHeight,
		float	centerX,
		float	centerY,
		float	angle,
		float	tiltXAngle,
		float	tiltYAngle )

Sensor characteristics.

Remarks:

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 eVision.ECameraCalibration.CalibrationModes, not a simpler one.

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 eVision.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 eVision.ECalibrationMode.Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain eVision.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.

SetSensor() [9/13]

None eVision.ECameraCalibration.SetSensor	(		self,
		int	sensorWidth,
		int	sensorHeight,
		float	fieldWidth,
		float	fieldHeight,
		float	centerX,
		float	centerY,
		float	angle,
		float	tiltXAngle,
		float	tiltYAngle,
		float	perspectiveStrength )

Sensor characteristics.

Remarks:

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 eVision.ECameraCalibration.CalibrationModes, not a simpler one.

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 eVision.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 eVision.ECalibrationMode.Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain eVision.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.

SetSensor() [10/13]

None eVision.ECameraCalibration.SetSensor	(		self,
		int	sensorWidth,
		int	sensorHeight,
		float	fieldWidth,
		float	fieldHeight,
		float	centerX,
		float	centerY,
		float	angle,
		float	tiltXAngle,
		float	tiltYAngle,
		float	perspectiveStrength,
		float	distortionStrength )

Sensor characteristics.

Remarks:

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 eVision.ECameraCalibration.CalibrationModes, not a simpler one.

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 eVision.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 eVision.ECalibrationMode.Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain eVision.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.

SetSensor() [11/13]

None eVision.ECameraCalibration.SetSensor	(		self,
		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.

Remarks:

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 eVision.ECameraCalibration.CalibrationModes, not a simpler one.

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 eVision.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 eVision.ECalibrationMode.Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain eVision.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.

SetSensor() [12/13]

None eVision.ECameraCalibration.SetSensor	(		self,
		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.

Remarks:

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 eVision.ECameraCalibration.CalibrationModes, not a simpler one.

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 eVision.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 eVision.ECalibrationMode.Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain eVision.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.

SetSensor() [13/13]

None eVision.ECameraCalibration.SetSensor	(		self,
		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,
		int	calibrationModes )

Sensor characteristics.

Remarks:

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 eVision.ECameraCalibration.CalibrationModes, not a simpler one.

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 eVision.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 eVision.ECalibrationMode.Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain eVision.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 eVision.ECalibrationMode. By default (argument omitted), the simplest model compatible with the given parameters is chosen.

SetSensorSize()

None eVision.ECameraCalibration.SetSensorSize	(		self,
		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]

None eVision.ECameraCalibration.SetSensorUsingResolution	(		self,
		int	sensorWidth,
		int	sensorHeight )

Sensor characteristics.

Remarks:

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 eVision.ECameraCalibration.CalibrationModes, not a simpler one.

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.

SetSensorUsingResolution() [2/13]

None eVision.ECameraCalibration.SetSensorUsingResolution	(		self,
		int	sensorWidth,
		int	sensorHeight,
		float	resolutionX )

Sensor characteristics.

Remarks:

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 eVision.ECameraCalibration.CalibrationModes, not a simpler one.

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.

SetSensorUsingResolution() [3/13]

None eVision.ECameraCalibration.SetSensorUsingResolution	(		self,
		int	sensorWidth,
		int	sensorHeight,
		float	resolutionX,
		float	resolutionY )

Sensor characteristics.

Remarks:

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 eVision.ECameraCalibration.CalibrationModes, not a simpler one.

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.

SetSensorUsingResolution() [4/13]

None eVision.ECameraCalibration.SetSensorUsingResolution	(		self,
		int	sensorWidth,
		int	sensorHeight,
		float	resolutionX,
		float	resolutionY,
		float	centerX )

Sensor characteristics.

Remarks:

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 eVision.ECameraCalibration.CalibrationModes, not a simpler one.

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 eVision.ECalibrationMode.Raw, it is set to 0. Otherwise, it is set to the image center.

SetSensorUsingResolution() [5/13]

None eVision.ECameraCalibration.SetSensorUsingResolution	(		self,
		int	sensorWidth,
		int	sensorHeight,
		float	resolutionX,
		float	resolutionY,
		float	centerX,
		float	centerY )

Sensor characteristics.

Remarks:

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 eVision.ECameraCalibration.CalibrationModes, not a simpler one.

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 eVision.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 eVision.ECalibrationMode.Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain eVision.ECalibrationMode.Inverse). Otherwise, it is set to the image center.

SetSensorUsingResolution() [6/13]

None eVision.ECameraCalibration.SetSensorUsingResolution	(		self,
		int	sensorWidth,
		int	sensorHeight,
		float	resolutionX,
		float	resolutionY,
		float	centerX,
		float	centerY,
		float	angle )

Sensor characteristics.

Remarks:

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 eVision.ECameraCalibration.CalibrationModes, not a simpler one.

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 eVision.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 eVision.ECalibrationMode.Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain eVision.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.

SetSensorUsingResolution() [7/13]

None eVision.ECameraCalibration.SetSensorUsingResolution	(		self,
		int	sensorWidth,
		int	sensorHeight,
		float	resolutionX,
		float	resolutionY,
		float	centerX,
		float	centerY,
		float	angle,
		float	tiltXAngle )

Sensor characteristics.

Remarks:

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 eVision.ECameraCalibration.CalibrationModes, not a simpler one.

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 eVision.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 eVision.ECalibrationMode.Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain eVision.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.

SetSensorUsingResolution() [8/13]

None eVision.ECameraCalibration.SetSensorUsingResolution	(		self,
		int	sensorWidth,
		int	sensorHeight,
		float	resolutionX,
		float	resolutionY,
		float	centerX,
		float	centerY,
		float	angle,
		float	tiltXAngle,
		float	tiltYAngle )

Sensor characteristics.

Remarks:

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 eVision.ECameraCalibration.CalibrationModes, not a simpler one.

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 eVision.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 eVision.ECalibrationMode.Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain eVision.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.

SetSensorUsingResolution() [9/13]

None eVision.ECameraCalibration.SetSensorUsingResolution	(		self,
		int	sensorWidth,
		int	sensorHeight,
		float	resolutionX,
		float	resolutionY,
		float	centerX,
		float	centerY,
		float	angle,
		float	tiltXAngle,
		float	tiltYAngle,
		float	perspectiveStrength )

Sensor characteristics.

Remarks:

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 eVision.ECameraCalibration.CalibrationModes, not a simpler one.

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 eVision.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 eVision.ECalibrationMode.Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain eVision.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.

SetSensorUsingResolution() [10/13]

None eVision.ECameraCalibration.SetSensorUsingResolution	(		self,
		int	sensorWidth,
		int	sensorHeight,
		float	resolutionX,
		float	resolutionY,
		float	centerX,
		float	centerY,
		float	angle,
		float	tiltXAngle,
		float	tiltYAngle,
		float	perspectiveStrength,
		float	distortionStrength )

Sensor characteristics.

Remarks:

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 eVision.ECameraCalibration.CalibrationModes, not a simpler one.

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 eVision.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 eVision.ECalibrationMode.Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain eVision.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.

SetSensorUsingResolution() [11/13]

None eVision.ECameraCalibration.SetSensorUsingResolution	(		self,
		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.

Remarks:

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 eVision.ECameraCalibration.CalibrationModes, not a simpler one.

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 eVision.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 eVision.ECalibrationMode.Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain eVision.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.

SetSensorUsingResolution() [12/13]

None eVision.ECameraCalibration.SetSensorUsingResolution	(		self,
		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.

Remarks:

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 eVision.ECameraCalibration.CalibrationModes, not a simpler one.

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 eVision.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 eVision.ECalibrationMode.Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain eVision.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.

SetSensorUsingResolution() [13/13]

None eVision.ECameraCalibration.SetSensorUsingResolution	(		self,
		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,
		int	calibrationModes )

Sensor characteristics.

Remarks:

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 eVision.ECameraCalibration.CalibrationModes, not a simpler one.

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 eVision.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 eVision.ECalibrationMode.Raw, it is set to 0 (or to the bottommost pixel index if the calibration modes also contain eVision.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 eVision.ECalibrationMode. By default (argument omitted), the simplest model compatible with the given parameters is chosen.

SetupUnwarp() [1/6]

None eVision.ECameraCalibration.SetupUnwarp	(		self,
		eVision.EUnwarpingLut | None	lookupTable,
		eVision.EROIBW8 | None	sourceImage )

Prepares a lookup table for fast image unwarping.

Remarks:

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 eVision.ECameraCalibration.Unwarp are not allowed to use images with row pitches different from the source image initially supplied to this method.

Parameters

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

SetupUnwarp() [2/6]

None eVision.ECameraCalibration.SetupUnwarp	(		self,
		eVision.EUnwarpingLut | None	lookupTable,
		eVision.EROIBW8 | None	sourceImage,
		bool	interpolate )

Prepares a lookup table for fast image unwarping.

Remarks:

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 eVision.ECameraCalibration.Unwarp are not allowed to use images with row pitches different from the source image initially supplied to this method.

Parameters

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

SetupUnwarp() [3/6]

None eVision.ECameraCalibration.SetupUnwarp	(		self,
		eVision.EUnwarpingLut | None	lookupTable,
		eVision.EROIBW8 | None	sourceImage,
		bool	interpolate,
		bool	resizeDestination )

Prepares a lookup table for fast image unwarping.

Remarks:

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 eVision.ECameraCalibration.Unwarp are not allowed to use images with row pitches different from the source image initially supplied to this method.

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.

SetupUnwarp() [4/6]

None eVision.ECameraCalibration.SetupUnwarp	(		self,
		eVision.EUnwarpingLut | None	lookupTable,
		eVision.EROIC24 | None	sourceImage )

Prepares a lookup table for fast image unwarping.

Remarks:

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 eVision.ECameraCalibration.Unwarp are not allowed to use images with row pitches different from the source image initially supplied to this method.

Parameters

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

SetupUnwarp() [5/6]

None eVision.ECameraCalibration.SetupUnwarp	(		self,
		eVision.EUnwarpingLut | None	lookupTable,
		eVision.EROIC24 | None	sourceImage,
		bool	interpolate )

Prepares a lookup table for fast image unwarping.

Remarks:

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 eVision.ECameraCalibration.Unwarp are not allowed to use images with row pitches different from the source image initially supplied to this method.

Parameters

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

SetupUnwarp() [6/6]

None eVision.ECameraCalibration.SetupUnwarp	(		self,
		eVision.EUnwarpingLut | None	lookupTable,
		eVision.EROIC24 | None	sourceImage,
		bool	interpolate,
		bool	resizeDestination )

Prepares a lookup table for fast image unwarping.

Remarks:

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 eVision.ECameraCalibration.Unwarp are not allowed to use images with row pitches different from the source image initially supplied to this method.

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.

TiltXAngle()

float eVision.ECameraCalibration.TiltXAngle

(

self

)

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.

Remarks:

Tilt X Angle and Tilt Y Angle

TiltYAngle()

float eVision.ECameraCalibration.TiltYAngle

(

self

)

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.

Remarks:

Tilt X Angle and Tilt Y Angle

ToFrame()

eVision.EFrame eVision.ECameraCalibration.ToFrame

(

self

)

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

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

Unwarp() [1/20]

None eVision.ECameraCalibration.Unwarp	(		self,
		eVision.EROIBW8 | None	sourceImage,
		eVision.EROIBW8 | None	destinationImage )

Unwarps a distorted image using the current calibration model.

Remarks:

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

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.

Unwarp() [2/20]

None eVision.ECameraCalibration.Unwarp	(		self,
		eVision.EROIBW8 | None	sourceImage,
		eVision.EROIBW8 | None	destinationImage,
		bool	interpolate )

Unwarps a distorted image using the current calibration model.

Remarks:

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

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.

Unwarp() [3/20]

None eVision.ECameraCalibration.Unwarp	(		self,
		eVision.EROIBW8 | None	sourceImage,
		eVision.EROIBW8 | None	destinationImage,
		bool	interpolate,
		bool	resizeDestination )

Unwarps a distorted image using the current calibration model.

Remarks:

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

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.

Unwarp() [4/20]

None eVision.ECameraCalibration.Unwarp	(		self,
		eVision.EROIBW8 | None	sourceImage,
		eVision.EROIBW8 | None	destinationImage,
		eVision.ERegion	region )

Unwarps a distorted image using the current calibration model.

Remarks:

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

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.

Unwarp() [5/20]

None eVision.ECameraCalibration.Unwarp	(		self,
		eVision.EROIBW8 | None	sourceImage,
		eVision.EROIBW8 | None	destinationImage,
		eVision.ERegion	region,
		bool	interpolate )

Unwarps a distorted image using the current calibration model.

Remarks:

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

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.

Unwarp() [6/20]

None eVision.ECameraCalibration.Unwarp	(		self,
		eVision.EROIBW8 | None	sourceImage,
		eVision.EROIBW8 | None	destinationImage,
		eVision.ERegion	region,
		bool	interpolate,
		bool	resizeDestination )

Unwarps a distorted image using the current calibration model.

Remarks:

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

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.

Unwarp() [7/20]

None eVision.ECameraCalibration.Unwarp	(		self,
		eVision.EROIC24 | None	sourceImage,
		eVision.EROIC24 | None	destinationImage )

Unwarps a distorted image using the current calibration model.

Remarks:

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

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.

Unwarp() [8/20]

None eVision.ECameraCalibration.Unwarp	(		self,
		eVision.EROIC24 | None	sourceImage,
		eVision.EROIC24 | None	destinationImage,
		bool	interpolate )

Unwarps a distorted image using the current calibration model.

Remarks:

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

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.

Unwarp() [9/20]

None eVision.ECameraCalibration.Unwarp	(		self,
		eVision.EROIC24 | None	sourceImage,
		eVision.EROIC24 | None	destinationImage,
		bool	interpolate,
		bool	resizeDestination )

Unwarps a distorted image using the current calibration model.

Remarks:

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

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.

Unwarp() [10/20]

None eVision.ECameraCalibration.Unwarp	(		self,
		eVision.EROIC24 | None	sourceImage,
		eVision.EROIC24 | None	destinationImage,
		eVision.ERegion	region )

Unwarps a distorted image using the current calibration model.

Remarks:

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

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.

Unwarp() [11/20]

None eVision.ECameraCalibration.Unwarp	(		self,
		eVision.EROIC24 | None	sourceImage,
		eVision.EROIC24 | None	destinationImage,
		eVision.ERegion	region,
		bool	interpolate )

Unwarps a distorted image using the current calibration model.

Remarks:

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

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.

Unwarp() [12/20]

None eVision.ECameraCalibration.Unwarp	(		self,
		eVision.EROIC24 | None	sourceImage,
		eVision.EROIC24 | None	destinationImage,
		eVision.ERegion	region,
		bool	interpolate,
		bool	resizeDestination )

Unwarps a distorted image using the current calibration model.

Remarks:

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

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.

Unwarp() [13/20]

None eVision.ECameraCalibration.Unwarp	(		self,
		eVision.EUnwarpingLut | None	lookupTable,
		eVision.EROIBW8 | None	sourceImage,
		eVision.EROIBW8 | None	destinationImage )

Unwarps a distorted image using the current calibration model.

Remarks:

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

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.

Unwarp() [14/20]

None eVision.ECameraCalibration.Unwarp	(		self,
		eVision.EUnwarpingLut | None	lookupTable,
		eVision.EROIBW8 | None	sourceImage,
		eVision.EROIBW8 | None	destinationImage,
		bool	interpolate )

Unwarps a distorted image using the current calibration model.

Remarks:

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

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.

Unwarp() [15/20]

None eVision.ECameraCalibration.Unwarp	(		self,
		eVision.EUnwarpingLut | None	lookupTable,
		eVision.EROIBW8 | None	sourceImage,
		eVision.EROIBW8 | None	destinationImage,
		eVision.ERegion	region )

Unwarps a distorted image using the current calibration model.

Remarks:

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

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.

Unwarp() [16/20]

None eVision.ECameraCalibration.Unwarp	(		self,
		eVision.EUnwarpingLut | None	lookupTable,
		eVision.EROIBW8 | None	sourceImage,
		eVision.EROIBW8 | None	destinationImage,
		eVision.ERegion	region,
		bool	interpolate )

Unwarps a distorted image using the current calibration model.

Remarks:

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

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.

Unwarp() [17/20]

None eVision.ECameraCalibration.Unwarp	(		self,
		eVision.EUnwarpingLut | None	lookupTable,
		eVision.EROIC24 | None	sourceImage,
		eVision.EROIC24 | None	destinationImage )

Unwarps a distorted image using the current calibration model.

Remarks:

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

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.

Unwarp() [18/20]

None eVision.ECameraCalibration.Unwarp	(		self,
		eVision.EUnwarpingLut | None	lookupTable,
		eVision.EROIC24 | None	sourceImage,
		eVision.EROIC24 | None	destinationImage,
		bool	interpolate )

Unwarps a distorted image using the current calibration model.

Remarks:

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

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.

Unwarp() [19/20]

None eVision.ECameraCalibration.Unwarp	(		self,
		eVision.EUnwarpingLut | None	lookupTable,
		eVision.EROIC24 | None	sourceImage,
		eVision.EROIC24 | None	destinationImage,
		eVision.ERegion	region )

Unwarps a distorted image using the current calibration model.

Remarks:

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

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.

Unwarp() [20/20]

None eVision.ECameraCalibration.Unwarp	(		self,
		eVision.EUnwarpingLut | None	lookupTable,
		eVision.EROIC24 | None	sourceImage,
		eVision.EROIC24 | None	destinationImage,
		eVision.ERegion	region,
		bool	interpolate )

Unwarps a distorted image using the current calibration model.

Remarks:

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

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.

WorldToSensor()

eVision.EPoint eVision.ECameraCalibration.WorldToSensor	(		self,
		eVision.EPoint	worldPoint )

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

Remarks:

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.

Parameters

worldPoint

World point.

XResolution()

float eVision.ECameraCalibration.XResolution

(

self

)

Horizontal sensor resolution, in pixels per unit.

YResolution()

float eVision.ECameraCalibration.YResolution

(

self

)

Vertical sensor resolution, in pixels per unit.