imagesetbrush

(PHP 4 >= 4.0.6, PHP 5)

imagesetbrushSet the brush image for line drawing

Description

bool imagesetbrush ( resource $image , resource $brush )

imagesetbrush() sets the brush image to be used by all line drawing functions (such as imageline() and imagepolygon()) when drawing with the special colors IMG_COLOR_BRUSHED or IMG_COLOR_STYLEDBRUSHED.

Parameters

image

An image resource, returned by one of the image creation functions, such as imagecreatetruecolor().

brush

An image resource.

Return Values

Returns TRUE on success or FALSE on failure.

Examples

Example #1 imagesetbrush() example

<?php
// Load a mini php logo
$php imagecreatefrompng('./php.png');

// Create the main image, 100x100
$im imagecreatetruecolor(100100);

// Fill the background with white
$white imagecolorallocate($im255255255);
imagefilledrectangle($im0029999$white);

// Set the brush
imagesetbrush($im$php);

// Draw a couple of brushes, each overlaying each
imageline($im50505060IMG_COLOR_BRUSHED);

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

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

The above example will output something similar to:

Output of example : imagesetbrush()

Notes

Note:

You need not take special action when you are finished with a brush, but if you destroy the brush image, you must not use the IMG_COLOR_BRUSHED or IMG_COLOR_STYLEDBRUSHED colors until you have set a new brush image!