imagesettile
(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)
imagesettile — Set the tile image for filling
Description
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!
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(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);
?>
The above example will output something similar to: