Draw an ellipse
  • « imagedestroy
    		•   
  • imagefill »
    		•

    imageellipse

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

    imageellipse — Draw 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