imagepolygon
(PHP 4, PHP 5, PHP 7, PHP 8)
imagepolygon — Draws a polygon
Description
Signature as of PHP 8.0.0 (not supported with named arguments)
Alternative signature (deprecated as of PHP 8.1.0)
imagepolygon() creates a polygon in the given
image.
Parameters
-
image -
A GdImage object, returned by one of the image creation functions, such as imagecreatetruecolor().
-
points -
An array containing the polygon's vertices, e.g.:
points[0] = x0 points[1] = y0 points[2] = x1 points[3] = y1 -
num_points -
Total number of points (vertices), which must be at least 3.
If this parameter is omitted as per the second signature,pointsmust have an even number of elements, andnum_pointsis assumed to becount($points)/2. -
color -
A color identifier created with imagecolorallocate().
Return Values
Returns true on success or false on failure.
Changelog
| Version | Description |
|---|---|
| 8.1.0 |
The parameter num_points has been deprecated.
|
| 8.0.0 |
image expects a GdImage
instance now; previously, a resource was expected.
|
Examples
Example #1 imagepolygon() example
<?php
// Create a blank image
$image = imagecreatetruecolor(400, 300);
// Allocate a color for the polygon
$col_poly = imagecolorallocate($image, 255, 255, 255);
// Draw the polygon
imagepolygon($image, array(
0, 0,
100, 200,
300, 200
),
3,
$col_poly);
// Output the picture to the browser
header('Content-type: image/png');
imagepng($image);
imagedestroy($image);
?>
The above example will output something similar to:
See Also
- imagefilledpolygon() - Draw a filled polygon
- imageopenpolygon() - Draws an open polygon
- imagecreate() - Create a new palette based image
- imagecreatetruecolor() - Create a new true color image