imagefilltoborder

PHP 4, PHP 5, PHP 7, PHP 8
imagefilltoborder - Flood fill to specific color
Manual
Code Examples

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

imagefilltoborder performs a flood fill whose border color is defined by border_color. The starting point for the fill is x, y (top left is 0, 0) and the region is filled with color color.

Parameters

image

A GdImage object, returned by one of the image creation functions, such as imagecreatetruecolor.

x

x-coordinate of start.

y

y-coordinate of start.

border_color

The border color. A color identifier created with imagecolorallocate.

color

The fill color. A color identifier created with imagecolorallocate.

Return Values

Returns true on success or false on failure.

Notes

The algorithm does not explicitly remember which pixels have already been set, but rather infers that from the color of the pixel, so it cannot distinguish between freshly set pixels and pixels that are already there. That means chosing any fill color that is already used in the image may yield undesired results.

Changelog

Version Description
8.0.0 image expects a GdImage instance now; previously, a resource was expected.

Example of imagefilltoborder

Show all examples for imagefilltoborder

PHP Version:


Function imagefilltoborder:

Image Processing and GD Functions

Most used PHP functions