PHP マニュアル: 塗りつぶし用のイメージを設定する

説明

bool imagesettile(GdImage $image, GdImage $tile)

imagesettile は、特別な色 IMG_COLOR_TILED を指定して塗りつぶされた場合に、 (imagefill や imagefilledpolygon のような) 領域塗りつぶし関数で使用されるタイルイメージを設定します。

タイルは、領域を塗りつぶすために繰り返し使用されるイメージです。全ての GD イメージをタイルとして使用可能で、 imagecolortransparent でタイルの透過色 ID を設定することにより、その一部から下の部分が透けて見えるようなタイルを作成することが可能です。

警告

タイルの使用が終った際には、特別な処理は不要ですが、タイルイメージを破棄する(もしくは、PHPに破棄させる)場合には、新たにタイルイメージを設定するまでは、色 IMG_COLOR_TILED を使用してはいけません。

パラメータ

image: imagecreatetruecolorのような画像作成関数が返す GdImage オブジェクト。
tile: タイルとして使用する画像オブジェクト。

戻り値

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

変更履歴

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

例

例1 imagesettile の例

<?php
// 外部の画像を読み込みます
$zend = imagecreatefromgif('./zend.gif');

// 200x200 の画像を作成します
$im = imagecreatetruecolor(200, 200);

// タイルを設定します
imagesettile($im, $zend);

// 画像の繰り返しを設定します
imagefilledrectangle($im, 0, 0, 199, 199, IMG_COLOR_TILED);

// 画像をブラウザに出力します
header('Content-Type: image/png');

imagepng($im);
imagedestroy($im);
imagedestroy($zend);
?>

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