imageellipse

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

imageellipseDraw an ellipse

Description

imageellipse(
    GdImage $image,
    int $center_x,
    int $center_y,
    int $width,
    int $height,
    int $color
): bool

Draws an ellipse centered at the specified 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 ellipse width.

height

The ellipse height.

color

The color of the ellipse. 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 imageellipse() example

<?php// Create a blank image.$image = imagecreatetruecolor(400, 300);// Select the background color.$bg = imagecolorallocate($image, 0, 0, 0);// Fill the background with the color selected above.imagefill($image, 0, 0, $bg);// Choose a color for the ellipse.$col_ellipse = imagecolorallocate($image, 255, 255, 255);// Draw the ellipse.imageellipse($image, 200, 150, 300, 200, $col_ellipse);// Output the image.header("Content-type: image/png");imagepng($image);?>

The above example will output something similar to:

Output of example : imageellipse()

Notes

Note:

imageellipse() ignores imagesetthickness().

See Also