imagefilltoborder

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

    imagefilltoborder — Заливка цветом

    Описание

    imagefilltoborder(
        GdImage $image,
        int $x,
        int $y,
        int $border_color,
        int $color
    ): bool

    imagefilltoborder() производит заливку области, ограниченной цветом border_color. Начальная координата x, y (левый верхний угол имеет координаты 0, 0), а область закрашивается цветом color.

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

    image

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

    x

    x-координата начала.

    y

    y-координата начала.

    border_color

    Цвет границы заливки. Идентификатор цвета, созданный функцией imagecolorallocate().

    color

    Цвет заливки. Идентификатор цвета, созданный функцией imagecolorallocate().

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

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

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

    Версия Описание
    8.0.0 Параметр image теперь ожидает экземпляр класса GdImage; раньше параметр ждал корректный gd-ресурс (resource).

    Примеры

    Пример #1 Закрашивание эллипса

    <?php
    // создание изображения, установка белого фона
    $im = imagecreatetruecolor(100, 100);
    imagefilledrectangle($im, 0, 0, 100, 100, imagecolorallocate($im, 255, 255, 255));

    // рисование эллипса закрашенного черным цветом
    imageellipse($im, 50, 50, 50, 50, imagecolorallocate($im, 0, 0, 0));

    // установка цвета границы заливки
    $border = imagecolorallocate($im, 0, 0, 0);
    $fill = imagecolorallocate($im, 255, 0, 0);

    // заливка области
    imagefilltoborder($im, 50, 50, $border, $fill);

    // вывод и освобождение памяти
    header('Content-type: image/png');
    imagepng($im);
    imagedestroy($im);
    ?>

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

    Вывод примера: Закрашивание эллипса

    Примечания

    Алгоритм не запоминает явно, какие пиксели уже были установлены, а скорее делает вывод по цвету пикселя, поэтому он не может отличить только что установленные пиксели от пикселей, которые уже есть. Это означает, что выбор любого цвета заливки, который уже используется в изображении, может привести к нежелательным результатам.

    Нашли ошибку?

    Инструкция • Исправление • Сообщение об ошибке
    ＋Добавить

    Примечания пользователей 2 notes

    up
    2
    edrad at wanadoo dot fr
    21 years ago
    Very useful to build a pseudo-sphere with a color gradient...

    <?php
    $width     = 300;
    $center = $width / 2;
    $colordivs = 255 / $center;
    $im = @imagecreate($width, $width);
    $back_color = imagecolorallocate($im, 20, 30, 40);
    imagefill($im, 0, 0, $back_color);
    for (    $i = 0; $i <= $center; $i++)
    {
    $diametre = $width - 2 * $i;
    $el_color = imagecolorallocate($im, $i * $colordivs, 0, 0);
    imagearc($im, $center, $center, $diametre, $diametre, 0, 360, $el_color);
    imagefilltoborder($im, $center, $center, $el_color, $el_color);
    }
    imagepng($im);
    ?>

    Dark Skull Software
    http://www.darkskull.net
    up
    0
    admin at worldlanguages dot tk
    20 years ago
    In the example below, for those with newer GD versions, it makes more sense to replace:

    imagearc($im, $center, $center, $diametre, $diametre, 0, 360, $el_color);

    with:

    imageellipse($im, $center, $center, $diametre, $diametre, $el_color);

    This is obviously simpler.
    ＋Добавить
    To Top