php8.5
Home/ Manual/ image / functions/ imagesetbrush

imagesetbrush

PHP function Edit on GitHub ✎

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

Set the brush image for line drawing

Description

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

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

brush

An image object.

Return Values

Always

Changelog

VersionDescription
8.0.0image and brush expect GdImage instances now; previously, resources were expected.

Examples

imagesetbrush() example

php
<?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, 99, 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);
?>

The above example will output something similar to: Output of example : imagesetbrush()

Source: reference/image/functions/imagesetbrush.xml · from the official PHP manual (php/doc-en)