(PHP 4, PHP 5, PHP 7, PHP 8)
imagepolygon — Draws a polygon
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.
imageA GdImage object, returned by one of the image creation functions, such as imagecreatetruecolor().
pointsAn array containing the polygon's vertices, e.g.:
| points[0] | = x0 |
| points[1] | = y0 |
| points[2] | = x1 |
| points[3] | = y1 |
num_pointsTotal number of points (vertices), which must be at least 3.
If this parameter is omitted as per the second signature,points
must have an even number of elements, and num_points is
assumed to be count($points)/2.
colorA color identifier created with imagecolorallocate().
| Version | Description |
|---|---|
| 8.1.0 |
The parameter num_points has been deprecated.
|
| 8.0.0 |
image expects a GdImage
instance now; previously, a valid gd resource was expected.
|
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
),
$col_poly);
// Output the picture to the browser
header('Content-type: image/png');
imagepng($image);
?>The above example will output something similar to: