imagesettile

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

imagesettile — Define a imagem de ladrilho para preenchimento

Descrição

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

imagesettile() define a imagem de ladrilho para ser usada por todas as funções de preenchimento de região (tal como imagefill() e imagefilledpolygon()) ao preencher com a cor especial IMG_COLOR_TILED.

O ladrilho é uma imagem usada para preencher uma área com um padrão repetido. Qualquer imagem GD pode ser usada como ladrilho, e ao definir o índice de cor transparente da imagem de ladrilho com imagecolortransparent(), permite-se que certas partes da área subjacente apareçam.

Cuidado

Não é necessário tomar ações especiais ao terminar de usar uma imagem de ladrilho, mas se ela for destruída, a cor IMG_COLOR_TILED não poderá ser usada até que uma nova imagem de ladrilho seja definida!

Parâmetros

image: Um objeto GdImage, retornado por uma das funções de criação de imagem, como imagecreatetruecolor().
tile: O objeto imagem a ser usado como ladrilho.

Valor Retornado

Sempre retorna true.

Registro de Alterações

Versão	Descrição
8.0.0	`image` e `tile` agora esperam instâncias GdImage; anteriormente, resources eram esperados.

Exemplos

Exemplo #1 Exemplo de imagesettile()

<?php
// Carrega uma imagem externa
$zend = imagecreatefromgif('./zend.gif');

// Cria uma imagem 200x200
$im = imagecreatetruecolor(200, 200);

// Define o ladrilho
imagesettile($im, $zend);

// Faz a imagem se repetir
imagefilledrectangle($im, 0, 0, 199, 199, IMG_COLOR_TILED);

// Mostra a imagem no navegador
header('Content-Type: image/png');

imagepng($im);
?>

O exemplo acima produzirá algo semelhante a: