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

CalibrateWorldPlane_Default_Deprecated

Header:	FIL.h
Namespace:	fil

Finds the image to world plane transformation matrix.

Syntax

void fil::CalibrateWorldPlane_Default_Deprecated
(
	const ftl::Array<fil::Point2D>& inImagePoints,
	const ftl::Array<fil::Point2D>& inWorldPlanePoints,
	const ftl::Optional<const fil::AnyCameraModel&>& inCameraModel,
	fil::RectificationTransform& outTransform,
	ftl::Optional<float&> outRmsError = ftl::NIL,
	ftl::Optional<float&> outMaxReprojectionError = ftl::NIL,
	ftl::Optional<ftl::Array<fil::Segment2D>&> outReprojectionErrorSegments = ftl::NIL
)

Parameters

Name	Type	Default	Description
inImagePoints	const Array<Point2D>&		Array of 2D points of the calibration pattern, in the picture.
inWorldPlanePoints	const Array<Point2D>&		Array of 2D points of the calibration pattern, in a given world coordinate plane.
inCameraModel	const Optional<const AnyCameraModel&>&	NIL	For undistortion of inImagePoints. If not supplied, the filter will assume undistorted inImagePoints.
outTransform	RectificationTransform&
outRmsError	Optional<float&>	NIL	RMS reprojection error, in pixels.
outMaxReprojectionError	Optional<float&>	NIL	Maximum reprojection error, in pixels.
outReprojectionErrorSegments	Optional<Array<Segment2D>&>	NIL	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 ftl::NIL to these parameters: outRmsError, outMaxReprojectionError, outReprojectionErrorSegments.

Errors

List of possible exceptions:

Error type	Description
DomainError	Array inImagePoints and inWorldPlanePoints sizes differ