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

20 lines
568 B
Groff

.TH IM_SIGN 3 "July 2002"
.SH NAME
im_sign \- find the unit vector in the direction of value
.SH SYNOPSIS
#include <vips/vips.h>
int im_sign( in, out )
.br
IMAGE *in, *out;
.SH DESCRIPTION
.B im_sign(3)
finds the unit vector in the direction of the pixel value. For non-complex
images, it returns a signed char image with values -1, 0, and 1 for negative,
zero and positive pixels. For complex images it returns a
complex normalised to length 1.
.SH RETURN VALUE
The function returns 0 on success and -1 on error.
.SH SEE ALSO
im_abs(3), im_cmulnorm(3), im_c2amph(3)