ptransposition

Performs a transposition of image.

Synopsis

ptransposition direction [im_in|-] [im_out|-]

Description

ptransposition builds a new image from the transpose transformation of the input image im_in according to a specified axis. Transposing an image array interchanges array dimensions, reflecting an image about a diagonal. The transpose function reverses the order of the dimensions.

Parameters

direction indicates the transposition direction:
- 0 = transposition where x becomes y and y becomes x.
- 1 = transposition where x becomes z and z becomes x.
- 2 = transposition where y becomes z and z becomes y.
For 2D image, this parameter is ignored since it corresponds to direction=0.

Inputs

im_in: an image.

Outputs

im_in: an image of the same type as im_in.

Examples

Transposes the tangram.pan image:

   ptransposition 0 tangram.pan a.pan

Result

Returns SUCCESS ou FAILURE.

C++ prototype

Errc PTransposition( const Img2duc &im_in, Img2duc &im_out, int direction );

Version française

Construit le transposé d'une image selon un axe.

Author: Régis Clouard