Canvas Tools

From PanelForge 3 Documentation
Revision as of 20:51, 9 December 2018 by James (talk | contribs)


This page was made for PanelForge v1. Some details may be incomplete or have changed when referring to PanelForge v2.


The 'Canvas Tools' palette provides the ability to select the current interactive tool active in the Canvas workspace. The palette also makes available all the available settings to currently active canvas workspace tool.


CanvasToolsComp.png


To set the active Canvas workspace tool select the corresponding tool icon button. The ability to quickly switch between different Canvas tools is provided by custom Keyboard Shortcuts.

The active canvas tool settings can be displayed or hidden by clicking the active canvas tool settings label below the canvas tool icon buttons.


Hand Tool

CanvasToolsHand01.png

The hand tool provides ways to interactively navigate the canvas view.

  • Pan Canvas: Canvas view can be quickly panned by pressing and dragging the cursor in the Canvas Viewport area.


Zoom Tool

CanvasToolsZoom01.png

The zoom tool provides ways to interactively zoom the canvas view.

  • Drag Zoom: Canvas view can be quickly zoomed by dragging the cursor in the canvas viewport area. The current centre of the canvas view will be retained during zooming.


Paint Brush Tool

CanvasToolsPaintBrush01.png

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:


Type

Four brush types are provides 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 brush stroke, 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.


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.


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.
  • 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

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


Eraser Brush Tool

CanvasToolsEraserBrush01.png


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:


Type

Four brush types are provides 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 brush stroke, 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.


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.


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.
  • 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.


Fill Bucket Tool

CanvasToolsPaintBucketFill01.png


The fill bucket tool will flood areas of the current Canvas Layer of similar colours with the current Canvas tool colour radiating from a selected seed point. The seed point of the colour fill is specified by clicking the cursor on a point of the Canvas Viewport. The results of this tool can be controlled with the following settings:


Tolerance

The percentage level that controls the level of difference from the point selected on the current canvas layer that will be flooded with the tool. A value of 100% will flood all pixels in the current layer regardless of their difference from the seed point colour. A value of 0% will only allow pixels of the exact same value of the seed point to be flooded.


Restriction

The output area that can be flooded by the fill bucket tool will be restricted using one of the following options:

  • Restrict to Canvas Checkbox: Inside the Canvas area boundary.
  • Restrict to Range Checkbox: The entered width and height values centring around the seed point.


Eyedropper Tool

CanvasToolsEyeDropper01.png


Set the current Canvas Workspace colour by selecting an existing colour by clicking the cursor in the Canvas view. How this colour is determined can be controlled using the following settings:


Sample All Visible Layers

If this checkbox is deactivated the pixel colour sampling will be restricted to current Canvas Layer. When active the full composite of all the Canvas Layers will be used during colour sampling.


Move Tool

CanvasToolsMove01.png


Interactively move the currently selected Canvas Layer(s), alternatively if a selection is active then the area which the selection is covering of the current Canvas Layer will be moved.

The amount of offset used for the move is determined by the distance the cursor is clicked and dragged in the canvas view.

When the shift key is held down during tool interaction movement will be constrained to horizontal and vertical movement.

The 'Arrow' keys can also be pressed to 'Nudge' the Move Tool action a single pixel in the corresponding direction.


Show Boundary

If this checkbox is toggled active then a dashed box will encircle the boundary of the currently selected Canvas Layer(s) or active selection.


Free Transform Tool

CanvasToolsFreeTransform01.png


Interactively Move, Rotate and Scale the currently selected Canvas Layer(s), alternatively if a selection is active then this area of the currently Layer will be transformed.

A box bounding of the currently selection area or selected Canvas Layer(s) with handles at the corners and edge centres will be displayed in the Canvas View.

To perform transforms the following methods can be used, a corresponding cursor icon representing the method in the areas where available:

  • Move: Drag the cursor inside the bounding box. When the shift key is held movement will be constrained horizontally and vertically.
  • Rotate: Drag the cursor outside the bounding box.
  • Scale: Drag the cursor from any of the handles at the corners or edge centres of the bounding box. When the shift key is held and a corner handle is dragged the scale will be contained to the same amount in both width and height.

During interaction of the tool any transforms will be previewed using 'Bilinear interpolation'. When a transform operation is completed high quality 'Bicubic interpolation' is used.

To complete a transform operation the following methods can be used:

  • Press enter key.
  • Double click cursor in the transform area bounding box.
  • Switch to another Canvas Tool or perform another action (a confirmation Dialog Window will be displayed to confirm the transform).


Preset Transform Buttons

The following buttons will add the described transform to current. Pressing additional buttons will add further transforms to the previous:

  • Flip Horizontal.
  • Flip Vertical.
  • Rotate -45 Degrees Counter-clockwise.
  • Rotate +45 Degrees Clockwise.


Rectangle Selection Tool

CanvasToolsRectangleSelection01.png


Quickly change the current Canvas active selection with rectangular areas. Dragging an area with the cursor in Canvas view will replace the current Canvas selection with the specified rectangular area. Alternatively if the 'Shift' key is held during tool interaction the area will be added to the selection, similarly the 'Alt' (Mac: 'Option') key held will remove the area from the selection.


Lasso Selection Tool

CanvasToolsLassoSelection01.png


Interactively change the Canvas current active selection quickly with arbitrary shapes.

The default behaviour is to replace the current canvas selection, alternatively if the 'Shift' key is held during tool interaction the specified selection will be added to the active selection, similarly the 'Alt' (Mac: 'Option') key held will remove the specified selection from current active selection.

The following to tool modes are provided to perform selections:

  • Freeform: Dragging the cursor over the Canvas view will produce a continues boundary for the new selection area.
  • Polygonal: Clicking multiple points on the Canvas view in sequence will produce a selection boundary constructed from straight lines connecting the points. To complete a selection double click the cursor during the final point, alternatively press the 'Enter' key.


Magic Wand Selection Tool

CanvasToolsMagicWandSelection01.png


The magic wand selection tool will flood areas of the canvas selection where similar colours radiate from a selected seed point. The seed point of the magic wand selection is specified by clicking the mouse cursor on a point of the canvas view. The result of this tool can be controlled using the following settings:


Tolerance

The percentage level that controls the level of difference from the point selected on the current canvas layer that will be flooded with the tool. A value of 100% will flood all pixels in the current layer regardless of their difference from the seed point colour. A value of 0% will only allow pixels of the exact same value of the seed point to be flooded.


Restriction

The output area that can be selected by the Magic Wand Selection tool will be restricted using one of the following options:

  • Restrict to Canvas Checkbox: Inside the Canvas area boundary.
  • Restrict to Range Checkbox: The entered width and height values centring around the seed point.