.TH CONVERSIONS 3 "28 June 1990"
.SH NAME
im_scale, im_scaleps \- scale an image to unsigned char image
.SH SYNOPSIS
#include <vips/vips.h>

int im_scale(in, out)
.br
IMAGE *in, *out;

int im_scaleps(in, out)
.br
IMAGE *in, *out;
.SH DESCRIPTION
These functions scale a non-complex image to a displayable
byte (unsigned char) image.

im_scale() scales the image held by image descriptor to a byte (unsigned char)
image and writes the result on the image descriptor out.  Sizes and the number
of the bands of out are identical to those of input. 
Input image should be non complex and can have any number of channels.  
The output is scaled between 0 and 255; if the image is multiband the maximum
value of all channels is set to 255 and the minimum to 0.  In all cases,
rounding is performed by adding .5 to the scaled values.

.B im_scaleps()
scales to 0 - 255 by mapping each pixel through the equation

   log10(1.0 + pow(x, 0.25))

and then multiplying by a factor so that the image maximum is 255.

This transformation highlights both low and high spatial 
frequencies in the power spectrum.  
The images produced by this non-linear transformation are only
for display and not for further processing.
.SH RETURN VALUE
Each function returns 0 on success and -1 on error.
.SH SEE ALSO
im_any2c(3), im_c2amph(3), im_clip(3)