塗りつぶし用のイメージを設定する

# imagesettile

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

imagesettile — 塗りつぶし用のイメージを設定する

### 説明

function imagesettile(GdImage `$image`, GdImage `$tile`): true

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

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

警告

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

### パラメータ

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

  タイルとして使用する画像オブジェクト。

### 戻り値

常に `true` を返します。

### 変更履歴

バージョン | 説明
--- | ---
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);
    ?>

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

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