You are here: Start » Filter Reference » Image Spatial Transforms Maps » CreatePerspectiveMap_Points
CreatePerspectiveMap_Points
Creates a perspective transform map from four points denoting a rectangle in the world coordinates.
| Name | Type | Description | |
|---|---|---|---|
 |
inImageFormat | ImageFormat | |
|
inRoi | Region* | Range of pixels to be processed |
|
inImagePoints | Point2DArray | Points define real object plane corners. |
|
inTargetPoints | Point2DArray* | Points define target plane corners. 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 | Created SpatialMap with perspective transform |
|
outTransformMatrix | Matrix | Used transform matrix |
Applications
Description
This operation computes a SpatialMap which can be later used for removing a perspective distortion from an image.
The operation maps the input image points (inImagePoints) onto locations described by the target points (inTargetPoints). If the inTargetPoints input is set to Auto this array will be made from the corner points of the input image. Both array must contains 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
Remarks
Notice that both inImagePoints array and inTargetPoints must be made of four points. This filter creates point to point transform so changing the points' order in the array 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 | Each of input array must contain four points in CreatePerspectiveMap_Points |
Complexity Level
This filter is available on Basic Complexity Level.
Filter Group
This filters is member of CreatePerspectiveMap filter group.
