imagearc

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

imagearc — Draws an arc

Description

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

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

Always returns true.

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 head
imagearc($img, 100, 100, 200, 200, 0, 360, $white);
// mouth
imagearc($img, 100, 100, 150, 150, 25, 155, $red);
// left and then the right eye
imagearc($img, 60, 75, 50, 50, 0, 360, $green);
imagearc($img, 140, 75, 50, 50, 0, 360, $blue);

// output image in the browser
header("Content-type: image/png");
imagepng($img);

?>

The above example will output something similar to:

Output of example : Drawing a circle with imagearc()