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 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:
Notes
Note:
imageellipse() ignores imagesetthickness().
See Also
- imagefilledellipse() - Draw a filled ellipse
- imagearc() - Draws an arc
© 1997–2021 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
https://www.php.net/manual/en/function.imageellipse.php