drawBrush

drawBrush (integer Image, integer X, integer Y)

Use this function to draw on an image using a brush tip. The function uses the current brush and color settings. Equivalent to using the Brush Tool.

Parameters

Image

An integer between 1 and 116 specifying the image frame number. Values in the range of 100-116 correspond to hidden frames.

X, Y

Positive integers specifying the coordinates of the center of the brush tip in pixels.

Error flags

ERR_OK

The flag set if successful.

ERR_FAILED

The flag set if failed.

Example

The following set of statements sets the draw color and brush parameters, and then applies a brush tip to a sample image.

size=8

intensity=80

hardness=0

space=20

shape=BR_ROUND

setCurDir("samples")

loadIm (1,"sample14.iwd")

setDrawColor(255, 255, 0)

setBrush (size, intensity, hardness, space, shape)

drawBrush (1, 100, 100)

updateIm(TRUE)

Remark

To set the draw color and brush parameters, use setDrawColor and setBrush.

If you apply this function repeatedly, it is recommended to disable the screen update of the image before calling the drawing section of your script and enable the update afterwards. This will allow for significant speed increase. See updateIm for more details.