You are here: Start » AVL.NET » Function Reference » Computer Vision » Camera Calibration » AVL.RectifyImage

AVL.RectifyImage

Applies a spatial map to distorted image transforming it to rectified image defined in world coordinates.

Namespace:AvlNet
Assembly:AVL.NET.dll

Syntax

C++
C#
 
public static void RectifyImage
(
	AvlNet.Image inImage,
	AvlNet.RectificationMap inRectificationMap,
	AvlNet.Image outImage,
	AvlNet.Matrix outRectifiedTransform,
	out AvlNet.Point2D outWorldOrigin,
	out float outWorldScale,
	out float outWorldScaleInv
)

Parameters

Name Type Range Default Description
inImageAvlNet.ImageInput image.
inRectificationMapAvlNet.RectificationMapThe spatial map with associated data for world coordinates calculation on rectified image. Designed to be set with calibration GUI.
outImageAvlNet.ImageRemapped image.
outRectifiedTransformAvlNet.MatrixFor convenient calculation of world coordinates on rectified image. Connects directly to Image...ToWorldPlane and WorldPlane...ToImage filters. The transformation is only translation + scaling.
outWorldOriginAvlNet.Point2DPosition of world origin on the rectified image.
outWorldScalefloat[pix / world unit] World scale of the rectified image.
outWorldScaleInvfloat[world unit / pix] Inverse of outWorldScale. Connects directly to inResolution input of filters such as PointToPointDistance.

Description

Uses a RectificationMap computed by CreateRectificationMap* filters (such as CreateRectificationMap_PixelUnits or CreateRectificationMap_WorldUnits) for image rectification onto a defined world plane. Point locations on rectified images are related to the world plane only by translation and scaling.

Auxiliary outputs outWorldOrigin and outWorldScale fully describe the relation of rectified image to world plane. For convenience the outRectifiedTransform output is provided, which describes the same relation, however it can be directly connected to the ImagePointsToWorldPlane filter family to obtain world coordinates of points detected on the remapped (rectified) image.

Examples

Left: original image, as captured by a camera, with mild lens distortion present. Right: rectified image with annotated length measurement.

Function Overrides

See also