Set the brush image for line drawing

- « imagescale

- imagesetclip »

- PHP Manual
- GD and Image Functions
- Set the brush image for line drawing

# imagesetbrush

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

imagesetbrush — Set the brush image for line drawing

### Description

imagesetbrush(GdImage `$image`, GdImage `$brush`): bool

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`.

Caution

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

### Parameters

`image`

  A GdImage object, returned by one of the image creation functions, such as imagecreatetruecolor().

`brush`

  An image object.

### Return Values

Returns `true` on success or `false` on failure.

### Changelog

Version | Description
--- | ---
8.0.0 | `image` and `brush` expect GdImage instances now; previously, resources were expected.

### Examples

Example #1 imagesetbrush() example

    <?php// Load a mini php logo$php = imagecreatefrompng('./php.png');// Create the main image, 100x100$im = imagecreatetruecolor(100, 100);// Fill the background with white$white = imagecolorallocate($im, 255, 255, 255);imagefilledrectangle($im, 0, 0, 299, 99, $white);// Set the brushimagesetbrush($im, $php);// Draw a couple of brushes, each overlaying eachimageline($im, 50, 50, 50, 60, IMG_COLOR_BRUSHED);// Output image to the browserheader('Content-type: image/png');imagepng($im);imagedestroy($im);imagedestroy($php);?>

The above example will output something similar to: