IM_SIGN

Section: C Library Functions (3)
Updated: July 2002
Index Return to Main Contents
 

NAME

im_sign - find the unit vector in the direction of value  

SYNOPSIS

#include <vips/vips.h>

int im_sign( in, out )
IMAGE *in, *out;  

DESCRIPTION

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.  

RETURN VALUE

The function returns 0 on success and -1 on error.  

SEE ALSO

im_abs(3), im_cmulnorm(3), im_c2amph(3)