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

CalibrateWorldPlane_OffgridOrigin_Deprecated

Header:	AVL.h
Namespace:	avl

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

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
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.
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.
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.
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 atl::NIL to these parameters: outRmsError, outMaxReprojectionError, outReprojectionErrorSegments.

Errors

List of possible exceptions:

Error type	Description
DomainError	Array inImagePoints and inWorldPlanePoints sizes differ