Back to Adaptive Vision Library website

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

RemapImage


Header:AVL.h
Namespace:avl

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

Syntax

C++
C#
 
void avl::RemapImage
(
	const avl::Image& inImage,
	const avl::SpatialMap& inSpatialMap,
	atl::Optional<const avl::Region&> inMapRoi,
	avl::Image& outImage
)

Parameters

Name Type Default Description
inImage const Image& Input image
inSpatialMap const SpatialMap& Definition of the transformation
inMapRoi Optional<const Region&> NIL 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 inSpatialMap input with a spatial map. This can be for example the result of the CreateSphereMap function or similar.

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 supports automatic parallelization for multicore and multiprocessor systems.

Errors

List of possible exceptions:

Error type Description
DomainError Incorrect SpatialMap on input in RemapImage.

See Also