| .TH IM_CIRCLE 3 "10 May 1991" |
| .SH NAME |
| im_circle \- draws a circle within an image file |
| .SH SYNOPSIS |
| .B #include <vips/vips.h> |
| |
| .B int im_circle(im, cx, cy, radius, intensity) |
| .br |
| .B IMAGE *im; |
| .br |
| .B int cx, cy; |
| .br |
| .B int radius, intensity; |
| .SH DESCRIPTION |
| .B 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. |
| .SH RETURN VALUE |
| The function returns 0 on success and -1 on error. |
| .SH SEE ALSO |
| im_line(3). |
| .SH COPYRIGHT |
| .br |
| N. Dessipris |
| .SH AUTHOR |
| N. Dessipris \- 10/05/1991 |