im_c2amph(3) im_clip2fmt,


#include <vips/vips.h>

int im_c2amph(in, out)
IMAGE *in, *out;

int im_c2rect(in, out)
IMAGE *in, *out;

int im_c2imag(in, out)
IMAGE *in, *out;

int im_c2ps(in, out)
IMAGE *in, *out;

int im_c2real(in, out)
IMAGE *in, *out;

int im_clip2fmt(in, out, ofmt)
IMAGE *in, *out;
int ofmt;

int im_ri2c(in1, in2, out)
IMAGE *in1, *in2, *out;


Each of the above functions converts the image held by the image descriptor in to another type image and writes the result on the image descriptor out. Sizes and the number of channels are identical to those of input. Whenever required by the conversion, the element values are rounded by calling floor().

im_c2amph() converts a complex (float or double) input to (amplitude, phase), with phase in degrees. Output has the same format as input.

im_c2rect() converts a complex (float or double) input in (amplitude, phase) form back to rectangular coordinates. Again, phase should be expressed in degrees.

im_c2ps() convert a (float or double) complex image to amplitude (float or double) image. Complex input (a,b) is mapped to sqrt( a*a+b*b ).

im_clip2fmt() converts the input image to 'ofmt', where ofmt is the new value for BandFmt. For example, im_clip2fmt(in, out, FMTUSHORT) converts any image to unsigned short.

The number of clipped values (if any), are printed in the standard error output. Before clipping rounding is carried out if necessary. When converting between real and complex types with these functions, the imaginary part of the output is set to zero. When converting from complex to real types, the imaginary part is ignored. Use im_c2ps(), im_c2real() etc. to get other behaviour.

Legacy functions are available, called im_clip(), im_clip2c(), im_clip2d(), im_clip2f(), im_clip2i(), im_clip2s(), im_clip2ui(), im_clip2us(), im_clip2cm() and im_clip2dcm() which convert the input image to unsigned char, signed char, double, float, int, short, unsigned int, unsigned short, complex and double complex respectively.

im_ri2c() takes as inputs two non-complex images of equal sizes and number of channels. The output is a complex image with the real part coming from in1 and the imaginary part coming from in2. Output is float complex (FMTCOMPLEX) only if none of the inputs is double. If one or both inputs are double the result is double complex (FMTDPCOMPLEX).

im_c2real() and im_c2imag() extract the real or the imaginary part of a complex image respectively. If input is be float complex or double complex, then output is float or double respectively.


The functions returns 0 on success and -1 on error.