imagesettile

Set the tile image for filling

&reftitle.description; `bool` `imagesettile` `GdImage` `image` `GdImage` `tile`

`imagesettile` sets the tile image to be used by all region filling functions (such as `imagefill` and `imagefilledpolygon`) when filling with the special color `IMG_COLOR_TILED`.

A tile is an image used to fill an area with a repeated pattern. Any GD image can be used as a tile, and by setting the transparent color index of the tile image with `imagecolortransparent`, a tile allows certain parts of the underlying area to shine through can be created.

You need not take special action when you are finished with a tile, but if you destroy the tile image (or let PHP destroy it), you must not use the `IMG_COLOR_TILED` color until you have set a new tile image!

&reftitle.parameters;

&gd.image.description;

`tile`

- The image object to be used as a tile.

&reftitle.returnvalues;

&return.success;

&reftitle.changelog;

&Version; | &Description;
8.0.0 | `image` and `tile` expect `GdImage` instances now; previously, `resource`s were expected.

&reftitle.examples;

### `imagesettile` example

    <?php
    // Load an external image
    $zend = imagecreatefromgif('./zend.gif');

    // Create a 200x200 image
    $im = imagecreatetruecolor(200, 200);

    // Set the tile
    imagesettile($im, $zend);

    // Make the image repeat
    imagefilledrectangle($im, 0, 0, 199, 199, IMG_COLOR_TILED);

    // Output image to the browser
    header('Content-Type: image/png');

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

&example.outputs.similar; Output of example : imagesettile()