protation

Performs rotation of image or region map.

Synopsis

protation axis angle [-m mask] [im_in|-] [im_out|-]

Description

protation rotates the input image im_in to build the output image im_out. The rotation is done along the specified axis with a specified angle.

The output image im_out keeps the same type than the input image im_in. The new introduced pixels are set to 0.

Notice: 4 successive rotations with 90° produces an output image slightly different from the original image due to calculus approximation.

Parameters

angle is a real value measured in degree and it can be negative.
axis is specified by an integer:
- 0: rotation around the z axis (by default for 2D image).
- 1: rotation around the y axis.
- 2: rotation around the z axis.

Inputs

im_in: an image or a region map.

Outputs

im_out: an object of the same type as im_in.

Result

Returns SUCCESS or FAILURE.

Examples

Rotates tangram.pan to 90 degrees:

   protation 0 90 tangram.pan a.pan

C++ prototype

Errc PRotation( const Img2duc &im_in; Img2duc &im_out; int axis, float angle );

Version française

Construction de la rotation selon un axe du contenu d'une image.

Author: Régis Clouard