Back to Aurora 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