Back to Aurora Vision Library website

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

CalibrateCamera_Telecentric_Deprecated


Header: AVL.h
Namespace: avl
Module: Calibration

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

Applications: Camera calibration, image to world coordinates transformations.

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
Input value inImagePoints const Array<Array<Point2D> >& Array, for each view: array of 2D points of the calibration pattern, in the picture.
Input value inWorldPlanePoints const Array<Array<Point2D> >& Array, for each view: array of 2D points of the calibration pattern, in a world coordinate plane.
Input value inImageWidth int 1 - Image width, used for initial estimation of principal point.
Input value inImageHeight int 1 - Image height, used for initial estimation of principal point.
Input value inDistortionType LensDistortionModelType::Type PolynomialWithThinPrism Lens distortion model
Input value inImagePointsStandardDeviation float 0.0 - 0.1f Assumed uncertainty of inImagePoints. Used for robust optimization and outCameraModelStdDev estimation.
Output value outCameraModel TelecentricCameraModel&
Output value 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.
Output value outRmsError Optional<float&> NIL Final reprojection RMS error, in pixels.
Output value outMaxReprojectionErrors Optional<Array<float>&> NIL For each view: the maximum reprojection error among all points.
Output value 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.

Read more about Optional Outputs.

Errors

List of possible exceptions:

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