imagearc

(PHP 4, PHP 5, PHP 7, PHP 8)

imagearcDraws an arc

Description

imagearc(
    GdImage $image,
    int $center_x,
    int $center_y,
    int $width,
    int $height,
    int $start_angle,
    int $end_angle,
    int $color
): bool

imagearc() draws an arc of circle centered at the given coordinates.

Parameters

image

A GdImage object, returned by one of the image creation functions, such as imagecreatetruecolor().

center_x

x-coordinate of the center.

center_y

y-coordinate of the center.

width

The arc width.

height

The arc height.

start_angle

The arc start angle, in degrees.

end_angle

The arc end angle, in degrees. 0° is located at the three-o'clock position, and the arc is drawn clockwise.

color

A color identifier created with imagecolorallocate().

Return Values

Returns true on success or false on failure.

Changelog

Version Description
8.0.0 image expects a GdImage instance now; previously, a valid gd resource was expected.

Examples

Example #1 Drawing a circle with imagearc()

<?php// create a 200*200 image$img = imagecreatetruecolor(200, 200);// allocate some colors$white = imagecolorallocate($img, 255, 255, 255);$red   = imagecolorallocate($img, 255,   0,   0);$green = imagecolorallocate($img,   0, 255,   0);$blue  = imagecolorallocate($img,   0,   0, 255);// draw the headimagearc($img, 100, 100, 200, 200,  0, 360, $white);// mouthimagearc($img, 100, 100, 150, 150, 25, 155, $red);// left and then the right eyeimagearc($img,  60,  75,  50,  50,  0, 360, $green);imagearc($img, 140,  75,  50,  50,  0, 360, $blue);// output image in the browserheader("Content-type: image/png");imagepng($img);// free memoryimagedestroy($img);?>

The above example will output something similar to:

Output of example : Drawing a circle with imagearc()

See Also