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

imagecreatetruecolor()のような画像作成関数が返す GdImage オブジェクト。

x

開始位置の x 座標。

y

開始位置の y 座標。

border_color

境界色。imagecolorallocate() で作成された色識別子。

color

塗りつぶし色。imagecolorallocate() で作成された色識別子。

戻り値

成功した場合に true を、失敗した場合に false を返します。

変更履歴

バージョン 説明
8.0.0 image は、 GdImage クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、resource が期待されていました。

例1 楕円の塗りつぶし

<?php
// 画像ハンドルを作成し、背景を白に設定します
$im imagecreatetruecolor(100100);
imagefilledrectangle($im00100100imagecolorallocate($im255255255));

// 黒い線で楕円を描画します
imageellipse($im50505050imagecolorallocate($im000));

// 枠線と塗りつぶしの色を設定します
$border imagecolorallocate($im000);
$fill imagecolorallocate($im25500);

// 選択した部分を塗りつぶします
imagefilltoborder($im5050$border$fill);

// 出力し、メモリを開放します
header('Content-type: image/png');
imagepng($im);
imagedestroy($im);
?>

上の例の出力は、 たとえば以下のようになります。

出力例 : 楕円の塗りつぶし

注意

塗りつぶしのアルゴリズムは、 どのピクセルが既に設定されているかについて明示的に記憶しません。 むしろピクセルの色からそれを推測しようとします。 よって、そのピクセルが既に存在していたものか、 新たに設定されたものなのかは区別できません。 これは、画像で既に使われている色で画像を塗りつぶそうとすると、 望ましくない結果が得られることがあるということです。

関連キーワード:  特定, imagefilltoborder, int, 作成, ピクセル, GdImage, 画像, 設定, 期待, バージョン