imagesetbrush

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

imagesetbrush — Define o tipo de pincel para desenho de linhas

Descrição

imagesetbrush(GdImage $image, GdImage $brush): true

imagesetbrush() define a imagem de pincel para ser usada por todas as funções de desenho de linhas (como imageline() e imagepolygon()) ao desenhar com as cores especiais IMG_COLOR_BRUSHED ou IMG_COLOR_STYLEDBRUSHED.

Cuidado

Não é necessário tomar medidas especiais ao terminar de usar um pincel, mas se a imagem do pincel for destruída (ou se o PHP destruí-la), as cores IMG_COLOR_BRUSHED ou IMG_COLOR_STYLEDBRUSHED não podem ser usadas até que uma nova imagem de pincel seja definida!

Parâmetros

image: Um objeto GdImage, retornado por uma das funções de criação de imagem, como imagecreatetruecolor().
brush: Um objeto de imagem.

Valor Retornado

Sempre retorna true.

Registro de Alterações

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

Exemplos

Exemplo #1 Exemplo de imagesetbrush()

<?php
// Carrega uma mini logomarca do PHP
$php = imagecreatefrompng('./php.png');

// Cria a imagem principal, 100x100
$im = imagecreatetruecolor(100, 100);

// Preenche o fundo com a cor branca
$white = imagecolorallocate($im, 255, 255, 255);
imagefilledrectangle($im, 0, 0, 299, 99, $white);

// Define o pincel
imagesetbrush($im, $php);

// Desenha um par de pincéis, um sobrepondo o outro
imageline($im, 50, 50, 50, 60, IMG_COLOR_BRUSHED);

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

imagepng($im);
?>

O exemplo acima produzirá algo semelhante a: