Рисует многоугольник

Описание

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

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

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

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

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

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

image

Объект GdImage, который возвращает одна из функций, создающих изображения, например, imagecreatetruecolor().

points

Массив вершин многоугольника:

points[0]	= x0
points[1]	= y0
points[2]	= x1
points[3]	= y1

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 Пример отрисовки многоугольника функцией imagepolygon()

<?php

// Создаём пустое изображение
$image = imagecreatetruecolor(400, 300);

// Создаём цвет полигона
$col_poly = imagecolorallocate($image, 255, 255, 255);

// Отрисовываем многоугольник
imagepolygon(
    $image,
    array(
        0,
        0,
        100,
        200,
        300,
        200
    ),
    $col_poly
);

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

imagepng($image);

?>

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

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

imagefilledpolygon() - Рисует закрашенный многоугольник
imageopenpolygon() - Рисует открытый полигон
imagecreate() - Создаёт новое палитровое изображение
imagecreatetruecolor() - Создаёт новое truecolor-изображение