imagefilledpolygon

Draw a filled polygon

&reftitle.description;

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

`bool` `imagefilledpolygon` `GdImage` `image` `array` `points` `int` `color`

Alternative signature (deprecated as of PHP 8.1.0)

`bool` `imagefilledpolygon` `GdImage` `image` `array` `points` `int` `num_points` `int` `color`

`imagefilledpolygon` creates a filled polygon in the given `image`.

&reftitle.parameters;

&gd.image.description;

`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`

- &gd.identifier.color;

&reftitle.returnvalues;

&return.success;

&reftitle.changelog;

&Version; | &Description;
8.1.0 | The parameter `num_points` has been deprecated.
&gd.changelog.image-param;

&reftitle.examples;

### `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 background
    imagefilledrectangle($image, 0, 0, 249, 249, $bg);

    // draw a polygon
    imagefilledpolygon($image, $values, 6, $blue);

    // flush image
    header('Content-type: image/png');
    imagepng($image);
    imagedestroy($image);
    ?>

&example.outputs.similar; Output of example : imagefilledpolygon()
&reftitle.seealso;

- `imagepolygon`