.TH IM_MPERCENT 3 "14 May 1991"
.SH NAME
im_mpercent \- find threshold corresponding to a percentage of an image values
.SH SYNOPSIS
#include <vips/vips.h>

int im_mpercent( in, percent, thresh )
.br
IMAGE *in;
.br
int percent;
.br
int *thresh;

.SH DESCRIPTION
im_mpercent() returns (through the thresh parameter) the threshold above which
there are percent values of the input image. If for example percent=.1, the
number of pels of the input image with values greater than the returned int
will correspond to 10% of all pels of the image.

The function is applied on one band FMTUCHAR images only.  It can be
used in order to threshold the scaled result of a filtering operation.
.SH RETURN VALUE
The function returns 0 on success and -1 on error.
.SH SEE ALSO
im_conv(3), im_zerox(3).
.SH COPYRIGHT
N. Dessipris
.SH AUTHOR
N. Dessipris \- 14/05/1991