| .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 |