libvips/man/im_maxpos_vec.3
2007-08-31 13:01:42 +00:00

43 lines
1.1 KiB
Groff

.TH IM_MAXPOS_VEC 3 "01 September 2006"
.SH NAME
im_maxpos_vec, im_minpos_vec \- Find highest or lowest pixel values
.SH SYNOPSIS
.nf
.B #include <vips/vips.h>
.sp
.BI "int im_maxpos_vec( IMAGE " "*im" ", int " "*xpos" ", int " "*ypos" ", double " "*maxima" ", int " "n" " );
.br
.BI "int im_minpos_vec( IMAGE " "*im" ", int " "*xpos" ", int " "*ypos" ", double " "*minima" ", int " "n" " );
.fi
.SH DESCRIPTION
.B im_maxpos_vec(3)
fills the arrays
.I xpos
and
.I ypos
with the x and y coordinates of the
.I n
pixels in the image
.I im
which have the highest values. It writes those values (at double-precsion)
into the corresponding elements in the array
.IR maxima ".
.PP
If there is a draw for the
.IR n "th
pixel, then which of the drawing pixels is used is not defined.
.PP
.B im_minpos_vec(3)
performs the same operation, looking for the lowest valued pixels.
.SH RETURN VALUE
The functions returns 0 on success and -1 on error.
.SH SEE ALSO
im_maxpos(3), im_minpos(3)
.SH COPYRIGHT
.br
Copyright 2006, The Nottingham Trent University.
Copyright 2006, Tom Vajzovic.
.SH AUTHOR
Tom Vajzovic