imagepolygon

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

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

    Описание

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

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

    Вывод примера: imagepolygon()

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

    To Top