imagesetbrush

Set the brush image for line drawing

&reftitle.description; `bool` `imagesetbrush` `GdImage` `image` `GdImage` `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`.

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!

&reftitle.parameters;

&gd.image.description;

`brush`

- An image object.

&reftitle.returnvalues;

&return.success;

&reftitle.changelog;

&Version; | &Description;
8.0.0 | `image` and `brush` expect `GdImage` instances now; previously, `resource`s were expected.

&reftitle.examples;

### `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 brush
    imagesetbrush($im, $php);

    // Draw a couple of brushes, each overlaying each
    imageline($im, 50, 50, 50, 60, IMG_COLOR_BRUSHED);

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

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

&example.outputs.similar; Output of example : imagesetbrush()