PHP 中 imagefilltoborder 函数怎么用？图像区域填充案例详解

gitbox 2025-06-10

在 PHP 图像处理函数库中，imagefilltoborder 是一个非常实用的函数，用于在指定区域内进行颜色填充，直到遇到边界颜色为止。这个功能在图像编辑、生成动态图形时非常常见，尤其是在需要对复杂区域进行颜色填充时。

本文将通过具体案例，详细介绍 imagefilltoborder 函数的使用方法及其工作原理，帮助你快速掌握这一图像处理技巧。

1. imagefilltoborder 函数简介

imagefilltoborder 函数用于从指定起点像素开始填充颜色，填充范围直到遇到某个边界颜色停止。其函数定义如下：

bool imagefilltoborder ( resource $image , int $x , int $y , int $border , int $color )

$image：图像资源句柄。
$x, $y：起始填充点的坐标。
$border：边界颜色的索引值，填充将不会越过这个颜色边界。
$color：用于填充的颜色索引值。

如果填充成功，返回 true，否则返回 false。

2. 使用场景说明

假设你有一张带有不同颜色区域的图像，想对某个区域进行颜色填充，但不希望颜色越界。imagefilltoborder 就可以从你指定的点开始填充，直到碰到预设的边界颜色为止。

3. 具体案例：图像区域填充示例

下面示例演示如何创建一个带有黑色边框的矩形，并使用 imagefilltoborder 填充其内部为红色。

<?php
// 创建一个空白图像
$width = 200;
$height = 100;
$image = imagecreatetruecolor($width, $height);

// 分配颜色
$white = imagecolorallocate($image, 255, 255, 255);
$black = imagecolorallocate($image, 0, 0, 0);
$red = imagecolorallocate($image, 255, 0, 0);

// 填充背景为白色
imagefill($image, 0, 0, $white);

// 画一个黑色矩形边框
imagerectangle($image, 50, 20, 150, 80, $black);

// 使用 imagefilltoborder 从（51,21）点开始填充红色，直到遇到黑色边界
imagefilltoborder($image, 51, 21, $black, $red);

// 输出图像
header("Content-Type: image/png");
imagepng($image);

// 释放资源
imagedestroy($image);
?>

代码说明：

先创建一个 200x100 的真彩图像。
设置白色背景。
画一个黑色矩形边框。
从矩形内部一点开始用红色填充，直到遇到黑色边界。
通过浏览器直接输出 PNG 格式图像。

运行这段代码后，可以看到一个红色填充的矩形区域，边界是黑色，填充色没有超出边界。

4. 注意事项

imagefilltoborder 会一直填充直到遇到边界颜色，因此边界颜色必须准确，否则可能填充超出预期范围。
边界颜色与填充颜色不能相同，否则填充无效。
起始点坐标要位于非边界的区域内，否则不会有填充效果。

5. 总结

imagefilltoborder 是 PHP 图像处理中进行区域颜色填充的重要工具，特别适用于需要按照边界限制填充的场景。通过合理设置起点和边界颜色，可以实现复杂图像区域的精确填充。

更多图像处理功能可以参考 PHP 官方手册：https://gitbox.net/manual/en/function.imagefilltoborder.php

imagefilltoborder