Chasys Draw IES Help:

Objects : Brushes

What is a Brush Object?

Brush objects, or custom brushes, are image-based resources used by the Brush tool to control the shape and behavior of the "tip" of the "brush". They are implemented as static or animated layered images with MARK metadata containing the brush.* family of mark-up tags. Brushes are shared resources that can be exported to and imported from a file.

Custom Brush functionality is currently enabled through Brush Engine, which supports Chasys Draw IES brushes (.cd5), Adobe brushes (.abr) and GIMP brushes (.gbr/.gih).

The presence of a brush object is indicated by a "current brush" gadget showing the shape of the brush tip and basic information about the brush.


Using Brush Objects

See the sections on the Brush Tool and the Basic Painting Tutorial for information on how to use brush objects in your drawings.


Installing Brush Objects

To install brushes, you need to copy the CD5 files to the Brushes folder in your Chasys Draw IES resources folder. You can find this folder by selecting Open Repository from the Objects menu.


Creating Brush Objects

To create a brush object you need to create a new image of type image-list (for static brushes) or frame animation (for animated brushes). You should then proceed to create the images that make up the brush in question. Finally, you need to add the mark-up attachment that will describe the behavior of the brush. Within this mark-up, you'll need to define the brush properties in the form brush.property=value; using the following values:

brush.spacing=x; This tag is used to control the spacing attribute of a custom brush. The spacing is the distance between any two applications of the tip. 0 means the distance is automatically determined by Chasys Draw based on the level setting on the toolbox, 1 means the tip is continuous/joined, and any other value indicates the spacing in pixels. Negative values are not allowed.
brush.color_mode=mode; This tag is used to define the color mode of a custom brush. Four modes are supported, color, alpha, mono and luma. Color means the tip is alpha-blended into the image as is. Alpha means that only the alpha channel is used; the color set by the user is used for the operation. Mono is similar to alpha, except that the luminance of the tip is interpreted as its alpha channel, while luma combines the luminance of the brush with the chrominance of the current color.
brush.scale_mode=mode; This tag is used to define the scaling mode of a custom brush. Two modes are supported, smooth and rough. This parameter basically controls where or not a smooth stretching operation is performed.
brush.auto_select=mode; This tag is used to define the auto-selection mode of a custom brush. Two modes are supported, none and width. When this is set to width in a static brush, the brush tip image is selected based on the width setting in the toolbox, effectively making it possible to define the tip at different sizes and automatically switch between these definitions.
brush.auto_rotate=mode; This tag is used to define the auto-rotation mode of a custom brush. Three modes are supported, none, vector and user_input. In vector mode, the tip of the brush rotates to align with the direction of drawing. When set to user_input, it relies on the user to provide direction, either through the toolbox intersity setting or via graphics pen rotation if supported (e.g. Wacom Intuos with 6D Art Pen).
brush.timer=time; This tag is used to define the timer reference for animated brushes with repeated frames.

Brush objects can be saved to file, which are then stored in the brushes folder. Chasys Draw IES comes with a number of predefined brushes, but you can always add your own.



Copyright © John Paul Chacha, 2001-2017