Difference between revisions of "Canvas Brush Tools"

Latest revision as of 22:16, 6 June 2020

PanelForge provides 'Paint' and 'Erase' brush-type 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'.

A brushstroke is composed of a series of small 'stamps' that are 'spaced' apart at regular intervals to form the illusion of a continuous stroke.

Adjusting the settings of how and where these brush stamps are produced can simulate a multitude of brush styles, ranging from simple solid pens to complex textured paint like brushes. Many of these settings should be familiar to users of other drawing software, PanelForge provides the ability also import settings from the 'Adobe Photoshop' ABR brush file type.

PanelForge includes additional 'Palettes' to adjust and manage brush settings used with the 'Paint' and 'Erase' tools:

Brush Editor - Adjust the full range of the current Brush Tool settings.
Brush Presets - Manage Preset Brush Tool Settings. Import brush preset files (including 'Adobe Photoshop' ABR brush file type) and export brush preset files.

The 'Canvas Tools' Palette brush settings provide the most regularly used settings. Most of these settings are shared between the brush tools, they are outlined below:

Paint Brush Tool

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

Brush stamps will be drawn using the 'current tool colour' to the current Canvas Layer to produce the illusion of a brushstroke based on the brush settings.

Eraser Brush Tool

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

Brush stamps will remove opacity from the current Canvas Layer to produce the illusion of an eraser based on the brush 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.

Size

The size control specifies the maximum diameter 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.

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.

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 (Paint Only)

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

Lock Transparency (Paint Only)

When active the paintbrush output's transparency will be restricted to the corresponding areas transparency in the current layer.

Brush Editor & Brush Presets Toggle Buttons

Pressing these buttons will toggle the display of the Brush Editor or Brush Presets Palette windows.

@@ Line 1: / Line 1: @@
-<span style="color:#ff0000">'''This page is early work in progress draft. Information may be incorrect or incomplete.'''</span>
+__NOTOC__
+PanelForge provides 'Paint' and 'Erase' brush-type 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'.
-=== [[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 brush stroke based on the following settings:
+A brushstroke is composed of a series of small 'stamps' that are 'spaced' apart at regular intervals to form the illusion of a continuous stroke.
-====Type====
-Four brush types are provides that produce different results when using the cursor to interact with the canvas view.
+Adjusting the settings of how and where these brush stamps are produced can simulate a multitude of brush styles, ranging from simple solid pens to complex textured paint like brushes. Many of these settings should be familiar to users of other drawing software, PanelForge provides the ability also import settings from the 'Adobe Photoshop' ABR brush file type.
-* '''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.
+PanelForge includes additional 'Palettes' to adjust and manage brush settings used with the 'Paint' and 'Erase' tools:
+* [[Brush Editor]]  - Adjust the full range of the current Brush Tool settings.
+* [[Brush Presets]]  - Manage Preset Brush Tool Settings. Import brush preset files (including 'Adobe Photoshop' ABR brush file type) and export brush preset files.
-====Flow====
-The flow level controls the transparency of each individual brush stamps. A flow level of 100% will provide a strong brush stroke, a lower flow level will provide a more natural fluid brush stroke.
+The 'Canvas Tools' Palette brush settings provide the most regularly used settings. Most of these settings are shared between the brush tools, they are outlined below:
-====Opacity====
-The opacity level controls transparency of the complete brush stroke. An opacity level lower than 100% provides maximum strength of the brush stroke, a lower opacity will not allow any element of a brush stoke to be above the specified opacity even if the same area is interacted with multiple times.
+{|
+|
+=== [[File: ToolBrush.png|60px|caption|]] Paint Brush Tool===
-====Radius====
+:[[File:PaintBrushToolSettings.png|thumb| 280px |none|]]
-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.
-====Hardness====
-The hardness level controls the amount a brush stamp fades around it's edge. A hardness of 100% will mean no edge fading with happen. 0% hardness will produce a brush stamps opacity to fade from the completely way from centre to edge.
-====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 brush to overlap more tightly.
-====Smoothing====
-When the freeform brush type is active this mode optional provides a smooth quadratic interpolation between the input cursors sample points.
-Under normal operation this option is recommended to be active.
-====Stabilisation====
-Causes the removal of unstable movements in the brush stroke by limiting the maximum sample rate of cursor movement producing a smoother brush curves.
-====Pressure====
-If a pressure sensitive input device is being used such as a Wacom graphics tablet then these options allow the input pressure is dynamically affect the brush tool output. The following options are available:
-* '''Disabled:''' Even if a pressure sensitive input device is available the pressure input will be ignored.
+The 'Paint' brush tool provides an interactive tool to manipulate the pixel colours of areas of the current [[Canvas]] layer.
-* '''Flow:''' The amount of pressure input is multiplies brush flow amount. The result is updated as each brush stamp is produced.
-* '''Radius:''' The amount of pressure input is multiplies brush radius amount. The result is updated as each brush stamp is produced.
-* '''Flow and Radius:''' Both the flow and radius amounts of the brush are both modified as specified above.
-====Behind====
+Brush stamps will be drawn using the 'current tool colour' to the current Canvas Layer to produce the illusion of a brushstroke based on the brush settings.
-When active the paint brush output will be composited below the current layer pixel data.
+| valign="top" style="width: 10%;" |
+| valign="top" style="width: 45%;" |
 === [[File: ToolEraser.png|60px|caption|]] Eraser Brush Tool===
@@ Line 76: / Line 40: @@
-The eraser brush tool provides an interactive tool to manipulate the pixel transparency of areas of the current [[Canvas]] Layer.
+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 brush stroke based on the following settings:
+Brush stamps will remove opacity from the current Canvas Layer to produce the illusion of an eraser based on the brush settings.
+|}
 ====Type====
-Four brush types are provides that produce different results when using the cursor to interact with the canvas view.
+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.
+====Size====
+The size control specifies the maximum diameter 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.
 ====Flow====
-The flow level controls the transparency of each individual brush stamps. A flow level of 100% will provide a strong brush stroke, a lower flow level will provide a more natural fluid brush stroke.
+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 transparency of the complete brush stroke. An opacity level lower than 100% provides maximum strength of the brush stroke, a lower opacity will not allow any element of a brush stoke to be above the specified opacity even if the same area is interacted with multiple times.
+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.
-====Hardness====
-The hardness level controls the amount a brush stamp fades around it's edge. A hardness of 100% will mean no edge fading with happen. 0% hardness will produce a brush stamps opacity to fade from the completely way from centre to edge.
 ====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 brush to overlap more tightly.
+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====
-====Smoothing====
+Causes the removal of unstable movements in the brushstroke by limiting the maximum sample rate of cursor movement producing smoother brush curves.
-When the freeform brush type is active this mode optional provides a smooth quadratic interpolation between the input cursors sample points.
+====Behind (Paint Only)====
-Under normal operation this option is recommended to be active.
-====Stabilisation====
-Causes the removal of unstable movements in the brush stroke by limiting the maximum sample rate of cursor movement producing a smoother brush curves.
+When active the paintbrush output will be composited below the current layer pixel data.
+====Lock Transparency (Paint Only)====
-====Pressure====
+When active the paintbrush output's transparency will be restricted to the corresponding areas transparency in the current layer.
-If a pressure sensitive input device is being used such as a Wacom graphics tablet then these options allow the input pressure is dynamically affect the brush tool output. The following options are available:
+====Brush Editor & Brush Presets Toggle Buttons====
-* '''Disabled:''' Even if a pressure sensitive input device is available the pressure input will be ignored.
+Pressing these buttons will toggle the display of the [[Brush Editor]] or [[Brush Presets]] Palette windows.
-* '''Flow:''' The amount of pressure input is multiplies brush flow amount. The result is updated as each brush stamp is produced.
-* '''Radius:''' The amount of pressure input is multiplies brush radius amount. The result is updated as each brush stamp is produced.
-* '''Flow and Radius:''' Both the flow and radius amounts of the brush are both modified as specified above.