Back to Adaptive Vision Library website

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

CalibrateWorldPlane_OffgridOrigin_Deprecated


Header: AVL.h
Namespace: avl
Module: Calibration

Finds the image to world plane transformation matrix, with world origin optionally specified.

Applications: Image to world coordinates transformations.

Syntax

void avl::CalibrateWorldPlane_OffgridOrigin_Deprecated
(
	const atl::Array<avl::Point2D>& inImagePoints,
	const atl::Array<avl::Point2D>& inWorldPlanePoints,
	const atl::Optional<const avl::AnyCameraModel&>& inCameraModel,
	const atl::Optional<avl::Point2D>& inWorldPlaneOrigin,
	const atl::Optional<avl::Point2D>& inWorldPlaneXAxis,
	avl::RectificationTransform& outTransform,
	atl::Optional<float&> outRmsError = atl::NIL,
	atl::Optional<float&> outMaxReprojectionError = atl::NIL,
	atl::Optional<atl::Array<avl::Segment2D>&> outReprojectionErrorSegments = atl::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.
Input value
 inWorldPlaneOrigin const Optional<Point2D>& NIL Override world plane origin. If set, the world plane specified by inWorldPlanePoints will be translated so that world plane origin will lie at the specified image point.
Input value
 inWorldPlaneXAxis const Optional<Point2D>& NIL Override world plane x axis direction. If set, the world plane specified by inWorldPlanePoints will be rotated so that world plane x axis will lie at the specified image point.
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 atl::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