im_sign(3) 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.