libvips/man/im_mpercent.3

31 lines
854 B
Groff
Raw Normal View History

2007-08-29 18:23:50 +02:00
.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