im_circle3
Draws a circle within an image file
Usage
#include <vips/vips.h>
int im_circle(im, cx, cy, radius, intensity)
IMAGE *im;
int cx, cy;
int radius, intensity;
Overview
im_circle() draws a circle on top of an image pointed by the image descriptor im. Input im should be one band unsigned char image.
It must be stressed that a call to this function overwrites the content of the original image at the points corresponding to the drawn circle. The centre of the circle is at point (cx, cy) and has radius radius and the intensity of the produced circle is given by the int intensity (between 0 and 255). If the circle does not fit in the original image, an error code is returned.
Return value
The function returns 0 on success and -1 on error.
Releases
Unchanged in 4 releases since Debian 3.1 (Sarge).