gimp_paintbrush (1995-1996)

NAME

gimp_paintbrush - Paint in the current brush with optional fade out parameter and pull colors from a gradient.

SYNOPSIS

gimp_paintbrush (drawable,fade_out,num_strokes,strokes,method,gradient_length)

DESCRIPTION

This tool is the standard paintbrush. It draws linearly interpolated lines through the specified stroke coordinates. It operates on the specified drawable in the foreground color with the active brush. The "fade_out" parameter is measured in pixels and allows the brush stroke to linearly fall off. The pressure is set to the maximum at the beginning of the stroke. As the distance of the stroke nears the fade_out value, the pressure will approach zero. The gradient_length is the distance to spread the gradient over. It is measured in pixels. If the gradient_length is 0, no gradient is used.

INPUT ARGUMENTS

TYPE	NAME	DESCRIPTION
DRAWABLE	drawable	The affected drawable
FLOAT	fade_out	Fade out parameter: 0 <= fade_out
INT32	num_strokes	Number of stroke control points (count each coordinate as 2 points)
FLOATARRAY	strokes	Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }
INT32	method	CONTINUOUS (0) or INCREMENTAL (1)
FLOAT	gradient_length	Length of gradient to draw: 0 <= gradient_length

SOME SYNTAX ALTERNATIVES

$drawable->paintbrush (fade_out,strokes,method,gradient_length)

AUTHOR

Spencer Kimball & Peter Mattis
(c)1995-1996 Spencer Kimball & Peter Mattis