Start » Filter Reference » Image » Image Spatial Transforms Maps » ConvertMatrixMapsToSpatialMap

ConvertMatrixMapsToSpatialMap

Expert

Module: Calibration

Joins two matrices of coordinates to produce a SpatialMap for use in RemapImage.

Name Type Description
Input value
 inImageFormat ImageFormat Information about dimensions, depth and pixel type of the image
Input value
 inMatrixX Matrix Map of real X coordinates
Input value
 inMatrixY Matrix Map of real Y coordinates
Input value
 inInterpolationMethod InterpolationMethod
Input value
 inRoundingOpenCV Bool Use same interpolation convention as cvRemap
Output value
 outSpatialMap SpatialMap Output spatial map
Output value
 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 in Error Handling.

List of possible exceptions:

Error type Description
DomainError Format of an empty image on input in ConvertMatrixMapsToSpatialMap.
DomainError Input matrices must have equal sizes in ConvertMatrixMapsToSpatialMap.

Complexity Level

This filter is available on Expert Complexity Level.

See Also

  • RemapImage – Applies a precomputed image transform, defined by a spatial map object.