You are here: Start » Filter Reference » Image Spatial Transforms Maps » ConvertMatrixMapsToSpatialMap
ConvertMatrixMapsToSpatialMap
Joins two matrices of coordinates to produce a SpatialMap for use in RemapImage.
| Name | Type | Description | |
|---|---|---|---|
 |
inImageFormat | ImageFormat | Information about dimensions, depth and pixel type of the image |
|
inMatrixX | Matrix | Map of atl::real X coordinates |
|
inMatrixY | Matrix | Map of atl::real Y coordinates |
|
inInterpolationMethod | InterpolationMethod | |
|
inRoundingOpenCV | Bool | Use same interpolation convention as cvRemap |
 |
outSpatialMap | SpatialMap | Output spatial map |
|
outOutputRegion | Region | Pixels set by the spatial map application |
Remarks
The two source matrices contain real-valued coordinates - if inMatrixX[a, b] = x and inMatrixY[a, b] = y, then the RemapImage filter applied with this map will generate the outImage[a, b] pixel based on pixels around (x, y) in inImage.
One example of application of this filter is the conversion of matrix maps generated with the OpenCV filter cvInitUndistortRectifyMap .
The inRoundingOpenCV parameter should be set to true if the matrices passed to this filter were obtained from an OpenCV function, like cvInitUndistortRectifyMap . This ensures that the results of RemapImage will be identical to cvRemap used with the same interpolation.
Errors
This filter can throw an exception to report error. Read how to deal with errors here: Error Handling
| Error type | Description |
|---|---|
| DomainError | Input matrices must have equal sizes in ConvertMatrixMapsToSpatialMap. |
| DomainError | Format of an empty image on input in ConvertMatrixMapsToSpatialMap. |
Complexity Level
This filter is available on Expert Complexity Level.
