View source for Canvas Brush Tools

__NOTOC__

PanelForge provides 'Paint' and 'Erase' brush tools. These tools are based around an advanced common brush engine with highly adjustable brush settings which can be saved and restored as 'Brush Presets'. Most settings are shared between the brush tools, these are outlined below:

{| 
|

=== [[File: ToolBrush.png|60px|caption|]] Paint Brush Tool===

:[[File:PaintBrushToolSettings.png|thumb| 280px |none|]]


The 'Paint' brush tool provides an interactive tool to manipulate the pixel colours of areas of the current [[Canvas]] layer. 


Brush stamps of the current tool colour will be produced at regular intervals on the current Canvas Layer to produce the illusion of a brushstroke based on the following settings:

| valign="top" style="width: 10%;" | 
| valign="top" style="width: 45%;" | 

=== [[File: ToolEraser.png|60px|caption|]] Eraser Brush Tool===

:[[File:EraserBrushToolSettings.png|thumb| 280px |none|]]


The 'Eraser' brush tool provides an interactive tool to manipulate the pixel transparency of areas of the current [[Canvas]] Layer. 


Brush stamps of reduced opacity will be produced at regular intervals on the current Canvas Layer to produce the illusion of a brushstroke based on the following settings:

|}


====Type====

Four brush types are provided that produce different results when using the cursor to interact with the canvas view.

* '''Freeform:''' Clicking and dragging the cursor in the canvas view will produce brush stamps under the cursor at regular intervals as it is moved.
* '''Line:''' Dragging the cursor between two points in the canvas view will produce a line comprising of brush stamps at regular intervals. A dashed line is provided during tool interaction to indicate where the output stamps will be produced. Holding the Shift key during tool interaction will snap the produced line to Horizontal or Vertical orientation. 
* '''Rectangle:''' Dragging the cursor between two points in the canvas view will produce a rectangle comprising of brush stamps at regular intervals. A dashed line is provided during tool interaction to indicate where the output stamps will be produced. Holding the Shift key during tool interaction will snap the produced rectangle to be a square. 
* '''Oval:''' Dragging the cursor between two points in the canvas view will produce an oval comprising of brush stamps at regular intervals. A dashed line is provided during tool interaction to indicate where the output stamps will be produced. Holding the Shift key during tool interaction will snap the produced rectangle to be a circle. 


====Flow====

The flow level controls the transparency of each individual brush stamps. A flow level of 100% will provide a strong brushstroke, a lower flow level will provide a more natural fluid brush stroke.


====Opacity====

The opacity level controls the transparency of the complete brush stroke. An opacity level lower than 100% provides maximum strength of the brushstroke, a lower opacity will not allow any element of a brushstroke to be above the specified opacity even if the same area interacts with multiple times.


====Radius====

The radius control specifies the maximum radius of brush stamps in pixels. If a pressure-sensitive input device is used and pressure sensitivity settings are active then the radius of brush stamps may be smaller than this specified radius. 


====Spacing====

The spacing level control specifies the spacing between brush stamps based on a brush stamps current radius. A level of 100% will cause no brush stamp overlapping, a low spacing level will cause the brush to overlap more tightly.



====Stabilisation====

Causes the removal of unstable movements in the brushstroke by limiting the maximum sample rate of cursor movement producing smoother brush curves.


====Behind (Oaint Only)====

When active the paintbrush output will be composited below the current layer pixel data.