Заливает область изображения

# imagefilltoborder

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

imagefilltoborder — Заливает область изображения

### Описание

function imagefilltoborder(
GdImage `$image`,
int `$x`,
int `$y`,
int `$border_color`,
int `$color`
): true

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

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

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

  Координата начала заливки по оси x.

`y`

  Координата начала заливки по оси y.

`border_color`

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

`color`

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

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

Функция возвращает логическое значение `true`.

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

Версия | Описание
--- | ---
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);

    // Устанавливаем заголовок с MIME-типом изображения и выводим результат
    header('Content-type: image/png');
    imagepng($im);

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

### Примечания

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

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