Back to FabImage Library website

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

ImagePointsToWorldPlane

Header:	FIL.h
Namespace:	fil

Finds the world coordinates of image points.

Syntax

void fil::ImagePointsToWorldPlane
(
	const ftl::Array<fil::Point2D>& inImagePoints,
	const fil::RectificationTransform& inTransform,
	ftl::Array<fil::Point2D>& outWorldPoints
)

Parameters

	Name	Type	Default	Description
	inImagePoints	const Array<Point2D>&		Array of 2D points in the picture.
	inTransform	const RectificationTransform&		Transform's camera model is needed for undistortion, when not supplied the filter assumes undistorted input. Transform's homography is needed for transforming coordinates to given world plane, when not supplied the filter only removes distortion of input.
	outWorldPoints	Array<Point2D>&

Errors

List of possible exceptions:

Error type	Description
DomainError	inTransform homography matrix must be a 3x3 matrix

See Also

CalibrateWorldPlane – Finds the image to world plane transformation matrix.

ImageEdgesToWorldPlane – Finds the world coordinates of image edges.

ImageGapsToWorldPlane – Finds the world coordinates of image gaps.

ImagePathsToWorldPlane – Finds the world coordinates of image paths.

ImageRidgesToWorldPlane – Finds the world coordinates of image ridges.

ImageSegmentsToWorldPlane – Finds the world coordinates of image segments.

ImageStripesToWorldPlane – Finds the world coordinates of image stripes.

WorldPlanePointsToImage – Finds the image coordinates of world points.