Draw a filled polygon

# 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)

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

Alternative signature (deprecated as of PHP 8.1.0)

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

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

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

The above example will output something similar to:

### See Also

- imagepolygon() - Draws a polygon

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open