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

RemapImage

Module:	Calibration

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

Applications

Fast (precomputed) image transformations, especially for view undistortion or object geometry correction (e.g. pos recognition of labels on cylindrical bottles).

Name	Type	Description
inImage	Image	Input image
inSpatialMap	SpatialMap	Definition of the transformation
inMapRoi	Region *	Defines which elements of the spatial map are valid
outImage	Image	Output image

Description

The operation applies an arbitrary spatial transformation to an image using a SpatialMap object. The input image has to be compatible with the given map. You can check if a map is compatible with an image using TestSpatialMapApplicability.

Hints

Connect the inImage input with an appropriate image source.
Connect the inSpatialMap input with a spatial map. This can be for example the result of the CreateSphereMap filter or similar.

Examples

Description of usage of this filter can be found in examples and tutorial: Globe Flattening, Bottle Flattening, Perspective Removal.

Remarks

Read more about how to handle images from camera in Camera Calibration article.

Hardware Acceleration

This operation is optimized for SSE4 technology for pixels of types: 1xUINT8, 3xUINT8.

This operation is optimized for AVX2 technology for pixels of type: 3xUINT8.

This operation is optimized for NEON technology for pixels of types: 1xUINT8, 3xUINT8.

This operation supports automatic parallelization for multicore and multiprocessor systems.

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	Incorrect SpatialMap on input in RemapImage.

Complexity Level

This filter is available on Basic Complexity Level.