Back to FabImage Library website

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

CalibrateWorldPlane_Default_Deprecated


Header: FIL.h
Namespace: fil
Module: Calibration

Finds the image to world plane transformation matrix.

Applications: Image to world coordinates transformations.

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
Input value
 inImagePoints const Array<Point2D>& Array of 2D points of the calibration pattern, in the picture.
Input value
 inWorldPlanePoints const Array<Point2D>& Array of 2D points of the calibration pattern, in a given world coordinate plane.
Input value
 inCameraModel const Optional<const AnyCameraModel&>& NIL For undistortion of inImagePoints. If not supplied, the filter will assume undistorted inImagePoints.
Output value
 outTransform RectificationTransform&
Output value
 outRmsError Optional<float&> NIL RMS reprojection error, in pixels.
Output value
 outMaxReprojectionError Optional<float&> NIL Maximum reprojection error, in pixels.
Output value
 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.

Read more about Optional Outputs.

Errors

List of possible exceptions:

Error type Description
DomainError Array inImagePoints and inWorldPlanePoints sizes differ