imagesettile

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

imagesettileSet the tile image for filling

Description

imagesettile(GdImage $image, GdImage $tile): bool

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.

Caution

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!

Parameters

image

A GdImage object, returned by one of the image creation functions, such as imagecreatetruecolor().

tile

The image object to be used as a tile.

Return Values

Returns true on success or false on failure.

Changelog

Version Description
8.0.0 image and tile expect GdImage instances now; previously, resources were expected.

Examples

Example #1 imagesettile() example

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

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

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

// Make the image repeat
imagefilledrectangle($im00199199IMG_COLOR_TILED);

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

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

The above example will output something similar to:

Output of example : imagesettile()