Draw a filled polygon
  • « imagefilledellipse
    		•   
  • imagefilledrectangle »
    		•

    imagefilledpolygon

    (PHP 4, PHP 5, PHP 7, PHP 8)

    imagefilledpolygon — Draw a filled polygon

    Description

    Signature as of PHP 8.0.0 (not supported with named arguments)

    imagefilledpolygon(GdImage $image, array $points, int $color): bool

    Alternative signature (deprecated as of PHP 8.1.0)

    imagefilledpolygon(
        GdImage $image,
        array $points,
        int $num_points,
        int $color
    ): bool

    imagefilledpolygon() creates a filled 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 x and y coordinates of the polygons vertices consecutively.

    num_points

    Total 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.
    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 valid gd resource was expected.

    Examples

    Example #1 imagefilledpolygon() example

    <?php// set up array of points for polygon$values = array(            40,  50,  // Point 1 (x, y)            20,  240, // Point 2 (x, y)            60,  60,  // Point 3 (x, y)            240, 20,  // Point 4 (x, y)            50,  40,  // Point 5 (x, y)            10,  10   // Point 6 (x, y)            );// create image$image = imagecreatetruecolor(250, 250);// allocate colors$bg   = imagecolorallocate($image, 0, 0, 0);$blue = imagecolorallocate($image, 0, 0, 255);// fill the backgroundimagefilledrectangle($image, 0, 0, 249, 249, $bg);// draw a polygonimagefilledpolygon($image, $values, 6, $blue);// flush imageheader('Content-type: image/png');imagepng($image);imagedestroy($image);?>

    The above example will output something similar to:

    Output of example : imagefilledpolygon()

    See Also