Рисует закрашенный многоугольник

# imagefilledpolygon

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

imagefilledpolygon — Рисует закрашенный многоугольник

### Описание

Сигнатура, которая действует с PHP 8.0.0 (не поддерживается с именованными аргументами)

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

Альтернативная сигнатура (устарела с PHP 8.1.0)

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

Функция imagefilledpolygon() создаёт закрашенный многоугольник в изображении `image`.

### Список параметров

`image`
  Объект GdImage, который вернула функция imagecreatetruecolor() или другая функция генерации изображений.
`points`

  Массив с `x`- и `y`-координатами последовательных вершин многоугольника.

`num_points`

  Общее количество точек (вершин), должно быть не меньше 3.

  При вызове функции согласно сигнатуре без этого параметра массив `points` должен содержать чётное количество элементов, тогда значение параметра `num_points` функция вычислит как `count($points) / 2`.
`color`

  Идентификатор цвета, который добавила в палитру изображения функция imagecolorallocate().

### Возвращаемые значения

Функция возвращает `true`, если выполнилась успешно, или `false`, если возникла ошибка.

### Список изменений

Версия | Описание
--- | ---
8.1.0 | Параметр `num_points` устарел.
8.0.0 | Параметр `image` теперь принимает объект GdImage; раньше параметр принимал корректный `gd`-ресурс (resource).

### Примеры

Пример #1 Пример рисования закрашенного многоугольника функцией imagefilledpolygon()

    <?php

    // Установка массива точек для многоугольника
    $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)
    );

    // Создание изображения
    $image = imagecreatetruecolor(250, 250);

    // Определение цветов
    $bg   = imagecolorallocate($image, 0, 0, 0);
    $blue = imagecolorallocate($image, 0, 0, 255);

    // Заливка фона
    imagefilledrectangle($image, 0, 0, 249, 249, $bg);

    // Рисование многоугольника
    imagefilledpolygon($image, $values, $blue);

    // Вывод изображения
    header('Content-type: image/png');
    imagepng($image);

    ?>

Вывод приведённого примера будет похож на:

### Смотрите также

- imagepolygon() - Рисует многоугольник

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