You are here: Start » Function Reference » Camera Calibration » CalibrateCamera_Telecentric_Deprecated

CalibrateCamera_Telecentric_Deprecated

Header:	AVL.h
Namespace:	avl

Finds the telecentric camera intrinsic parameters from the input arrays of image and real-world coordinates.

Syntax

void avl::CalibrateCamera_Telecentric_Deprecated
(
	const atl::Array<atl::Array<avl::Point2D> >& inImagePoints,
	const atl::Array<atl::Array<avl::Point2D> >& inWorldPlanePoints,
	int inImageWidth,
	int inImageHeight,
	avl::LensDistortionModelType::Type inDistortionType,
	float inImagePointsStandardDeviation,
	avl::TelecentricCameraModel& outCameraModel,
	atl::Optional<avl::TelecentricCameraModel&> outCameraModelStdDev = atl::NIL,
	atl::Optional<float&> outRmsError = atl::NIL,
	atl::Optional<atl::Array<float>&> outMaxReprojectionErrors = atl::NIL,
	atl::Optional<atl::Array<atl::Array<avl::Segment2D> >&> outReprojectionErrorSegments = atl::NIL
)

Parameters

Name	Type	Range	Default	Description
inImagePoints	const Array<Array<Point2D> >&			Array, for each view: array of 2D points of the calibration pattern, in the picture.
inWorldPlanePoints	const Array<Array<Point2D> >&			Array, for each view: array of 2D points of the calibration pattern, in a world coordinate plane.
inImageWidth	int	1 -		Image width, used for initial estimation of principal point.
inImageHeight	int	1 -		Image height, used for initial estimation of principal point.
inDistortionType	LensDistortionModelType::Type		PolynomialWithThinPrism	Lens distortion model
inImagePointsStandardDeviation	float	0.0 -	0.1f	Assumed uncertainty of inImagePoints. Used for robust optimization and outCameraModelStdDev estimation.
outCameraModel	TelecentricCameraModel&
outCameraModelStdDev	Optional<TelecentricCameraModel&>		NIL	Standard deviations of all model parameters, assuming that inImagePoints positions are disturbed with gaussian noise with standard deviation equal to inImagePointsStandardDeviation.
outRmsError	Optional<float&>		NIL	Final reprojection RMS error, in pixels.
outMaxReprojectionErrors	Optional<Array<float>&>		NIL	For each view: the maximum reprojection error among all points.
outReprojectionErrorSegments	Optional<Array<Array<Segment2D> >&>		NIL	For each view: array of segments connecting input image points to reprojected world points.

Optional Outputs

The computation of following outputs can be switched off by passing value atl::NIL to these parameters: outCameraModelStdDev, outRmsError, outMaxReprojectionErrors, outReprojectionErrorSegments.

Errors

List of possible exceptions:

Error type	Description
DomainError	Empty input array
DomainError	Input array sizes differ