You are here: Start » Filter Reference » Image Spatial Transforms Maps » CreatePerspectiveMap_Path

CreatePerspectiveMap_Path

Creates a perspective transform map from planes defined by paths.

Name	Type	Description
inImageFormat	ImageFormat
inRoi	Region *	Range of pixels to be processed
inImagePath	Path	Plane defined by a closed path made of 4 points
inTargetPath	Path *	Target plane. If NIL then image corners are used starting from (0,0) (Width, 0) (Width, Height), (0, Height)
inNewSize	Size *	New image size after remapping
inInterpolationMethod	InterpolationMethod	Interpolation method used in extraction of image pixel values
outSpatialMap	SpatialMap	Calculated spatial map
outTransformMatrix	Matrix	Used transform matrix

Applications

Data preprocessing for fast perspective correction. The result is used by RemapImage.

Description

This operation computes a SpatialMap which can be later used for removing a perspective distortion from an image.

The operation maps the input path (inImagePath) into the target path (inTargetPath). If the inTargetPath input is set to Auto this path will be made from the corner points of the input image. Both paths must be closed and must be made of four points.

The input inNewSize allows rescaling of the output image.

The inImageFormat format is necessary for preparation of a spatial map.

The outTransformMatrix output allows verifying the found transformation.

For more information about distortion removal please refer to: Machine Vision Guide - Camera Calibration

Examples

Description of usage of this filter can be found in examples and tutorial: Calibration of World Coordinates.

Remarks

Notice that both inImagePath path and inTargetPath must be made of four points. This filter creates point to point transform so the changing points order in paths may yield an unexpected result.

Errors

This filter can throw an exception to report error. Read how to deal with errors here: Error Handling

Error type	Description
DomainError	inImagePath input must contain a closed path created from 4 points in CreatePerspectiveMap_Path.
DomainError	inTargetPath input must contain a closed path created from 4 points in CreatePerspectiveMap_Path.

Complexity Level

This filter is available on Basic Complexity Level.

Filter Group

This filters is member of CreatePerspectiveMap filter group.