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

CreateImageRotationMap

Header:	FIL.h
Namespace:	fil
Module:	Calibration

Creates a spatial map representing an image rotation.

Applications: Preprocessing data for fast image rotation by a constant angle. The result is used by RemapImage.

Syntax

void fil::CreateImageRotationMap
(
	const fil::ImageFormat& inImageFormat,
	float inAngle,
	fil::RotationSizeMode::Type inSizeMode,
	fil::InterpolationMethod::Type inInterpolationMethod,
	fil::SpatialMap& outRotationMap,
	ftl::Optional<fil::Region&> outOutputRegion = ftl::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

Optional Outputs

The computation of following outputs can be switched off by passing value ftl::NIL to these parameters: outOutputRegion.

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