Back to Adaptive Vision Library website

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

CreateImageRotationMap


Creates a spatial map representing an image rotation.

Header:AVL.h

Syntax

C++
C#
 
void avl::CreateImageRotationMap
(
	const avl::ImageFormat& inImageFormat,
	float inAngle,
	avl::RotationSizeMode::Type inSizeMode,
	avl::InterpolationMethod::Type inInterpolationMethod,
	avl::SpatialMap& outRotationMap,
	atl::Optional<avl::Region&> outOutputRegion = atl::NIL
)

Parameters

Name Type Default Description
inImageFormat const ImageFormat& Information about dimensions, depth and pixel type of the image
inAngle float 45.0f The angle of rotation
inSizeMode RotationSizeMode::Type
inInterpolationMethod InterpolationMethod::Type Bilinear Interpolation method used in extraction of image pixel values
outRotationMap SpatialMap& Output spatial map
outOutputRegion Optional<Region&> NIL Pixels set by the spatial map application

Description

The operation generates map that describes rotation mapping. Dimensions of the resulting image depends on inSizeMode. In 'Fit' mode size is extended to fit the rotated image. In 'Preserve' mode size of source image is left unchanged and part of rotated image may be lost. Two modes of pixel interpolation are available, the bilinear filtering being more precise and computationally expensive. Usually creating map and then using RemapImage is faster than RotateImage. outOutputRegion return region, which can be calculated by RemapImage.

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.

See Also

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