PHP 5.4.31 Released

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!

add a note add a note

User Contributed Notes 1 note

up
0
brent at ebrent dot net
7 years ago
Use a brush to create a thick line.

To create a 3x3 red brush:

<?php
$brush_size
= 3;
$brush = imagecreatetruecolor($brush_size,$brush_size);
$brush_color = imagecolorallocate($brush,255,0,0);
imagefill($brush,0,0,$brush_color);
imagesetbrush($im,$brush);
?>

Then use imageline() or imagepolygon() with IMG_COLOR_BRUSHED as the color.

To stop using the brush, destroy it:

<?php imagedestroy($brush); ?>

The brush can also be created from an existing image.
To Top