rotate

The C++ interface for rotate. More...

array	rotate (const array &image, const float theta=0, const bool iscrop=true, const bool recenter=true)

Detailed Description

The C++ interface for rotate.

Rotate the input image by theta radians. Positive indicates clockwise rotatoin and a negative angle rotates the image counter-clockwise.

// Rotate an image counter-clockwise 60 degrees
// and set output size to be same as input (cropping)
array img_out_crop = rotate(img_in, -Pi/3.f);

// Perform the same transformation but skip the cropping
// operation.  The output will be larger than the input
array img_out_nocrop = rotate(img_in, -Pi/3.f, false);

// Rotate an image clockwise 90 degrees
// and adjust output image size as needed (no cropping)
array img_out = rotate(img_in, Pi/2.f, false);

img_in

img_out_nocrop

img_out_crop

img_out

Function Documentation

array af::rotate	(	const array &	image,
		const float	theta = 0,
		const bool	iscrop = true,
		const bool	recenter = true
	)

Parameters

[in]	image	input image
[in]	theta	clockwise rotation angle in radians.
[in]	iscrop	use in-place rotation and crop outlying pixels (true, default), else enlarge image domain to fit rotation (false)
[in]	recenter	rotate about the center of the image (true, default) or rotate about the (0,0) index position (top left corner) (false)

Returns

rotated image (same size as input when crop=true, enlarged when crop=false)

Note

rotations in increments of pi/2 are fast

Examples:

examples/image_processing/image_demo.cpp.