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

Описание

Сигнатура, начиная с 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
    ),
    3,
    $col_poly);

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

imagepng($image);
imagedestroy($image);
?>

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

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

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