π Toolbox
ποΈ NoesisGUI βΈ π Noesis Studio βΈ π Toolbox
Overview
The Toolbox offers quick-access to tools that can be used to manipulate, and create Elements directly on the π Stage. These can be clicked directly in the Toolbox, but each also features a unique keyboard shortcut that can be pressed to activate each one.
Selection Tools
Noesis Studio offers two distinct selection tools that allow Elements to be selected and manipulated on the Stage; the π Selection Tool and the π Path Selection Tool. Between them, they each share similar π Selection Mechanics, but contain unique functions tailored to each distinct Element type.
Selection Tool
Arming the Selection Tool allows directly clicking on Elements on the π Stage.
Clicking on any Element using the Selection Tool, will also select it in the π Navigator Panel.
The Selection Tool can also be activated by pressing V on the keyboard.
Clicking and dragging an Element, or its adorners with the Selection Tool active also provides the same functionality as the π Move Tool.
Path Selection Tool
Arming the Path Selection Tool allows the selection, and manipulaion of a π Path Element.
Clicking on any Path Element, will also select it in the π Navigator Panel.
The Path Selection Tool can also be activated by pressing A on the keyboard.
Clicking and dragging an Element, or its adorners with the Path Selection Tool active also provides the same functionality as the π Move Tool.
With a Path Selected, and the Path Selection Tool active, all of the features of π Manipulating Paths also become available to use. These include the ability to select and re-position Path Points and Path Segments, as well as editing their respective BΓ©zier curves.
Selection Mechanics
What the Selection Tool and Path Selection Tool 'select' when a click is made on the π Stage, is based on the following, in order of priority:
- What Element is directly under the mouse cursor when the click is made.
- What is 'higher' in the visual hierarchy. For example, if a full-screen 'Foreground' layer completely superimposes a full-screen 'Background' layer, clicking on the Stage will select the 'Foreground'.
The following determine the ability to click on an Element with the Selection Tool or Path Selection Tool:
- An Element can be clicked provided it (or its internal Template) contains a 'Background' or 'Fill' Property value in the π Properties Panel.
- An Element's 'outline' can be clicked provided it (or its internal Template) contains a 'Stroke' or 'Border' Property value in the π Properties Panel.
- Any π Text Element can be clicked.
In the case where a click is made with either the Selection Tool or Path Selection Tool, and none of the above apply, the 'top-most' π Panel & Layout Element located under the mouse cursor when the click is made, will be selected.
Elements can be excluded from being clicked by the Selection Tool and Path Selection Tool by:
- Locking the Element in the π Navigator Panel, using the techniques outlined in π Locking Elements. It's important to note that this option only applies in the visual editor, and will not prevent an end-user from interacting with the Element during Playback.
- Isolating an Element in the π Navigator Panel using the techniques outlined in π Isolate. This will make all Elements other than the isolated one, unclickable in the visual editor whilst this isolation is active.
- Setting an Element to have a 'Visibility' Property in the π Properties Panel of 'Collapsed'. It is however important to note that this will also remove the Element from the screen during Playback.
- Removing an Element's 'Background' and 'Fill' values and/or its 'Stroke' and 'Border' values in the π Properties Panel.
It is furthermore important to note that Elements with a 0% Opacity whether within the 'Background', 'Fill', 'Stroke', or 'Border' Property values, or directly on the Element itself, as well as a setting the 'Visibility' Property to 'Hidden', will still be clickable with the Selection tool.
Path Tool
Selecting the Path Tool allows vector shapes to be drawn or modified directly on the π Stage using the mechanisms outlined in π Drawing Paths.
The Path Tool can also be activated by pressing P on the keyboard.
With a π Path Element first selected on the π Stage or in the π Navigator Panel, the Path Tool can also be used to add, or remove Path Points from the selected Path.
Move Tool
Selecting the Move Tool allows any Element first selected on the π Stage or in the π Navigator Panel to be moved and resized direcltly on the Stage.
The Move Tool can also be activated by pressing M on the keyboard.
Although these features are also included in the π Selection Tool and the π Path Selection Tool, one particular advantage of using the Move Tool, is that these operations will be 'locked' to the selected Element, without the risk of accidentally selecting a different Element throughout these operations.
Clicking-and-dragging an Element with the Move Tool will adjust two sets of Properties in the π Properties Panel:
- If the Element is within a π Grid Element, its 'Column', 'Column Span', 'Row', and 'Row Span' Property values will update to reflect the new space the Element occupies within its 'parent' Grid.
- The Element's 'Margin' Property values will update to reflect its new position within its 'parent' Element.
Clicking-and-dragging the 'draggers' on each side and corner of the Element's adorner can be used to change its 'Width' and 'Height' Property values, whilst also automatically adjusting its 'Margin' Property values to reflect its distance from each edge of its 'parent' Element.
Transform Tool
Selecting the Transform Tool allows an Element to have many of its Property values edited directly on the π Stage.
The Transform Tool can also be activated by pressing Y on the keyboard.
With the Transform Tool active:
- Clicking-and-dragging an Element can be used adjust its 'Render Transform: Translate X' and 'Render Transform: Translate Y' Property values.
- Clicking-and-dragging the 'draggers' on each side and corner of the Element's adorner can be used to adjust its its 'Render Transform: Scale X' and 'Render Transform: Scale Y' Property values.
- Hovering over any corner of an Element until the βΊ (Rotate) appears, then clicking-and-dragging can be used to adjust its 'Render Transform: Angle' value.
- Clicking-and-dragging the 'dragger' inside of an Element can be used to adjust its 'Render Transform: Origin' Property value.
- Clicking-and-dragging the 'draggers' outside of the adorners of the π Rectangle Element or π Border Element can be used to adjust its 'Radius X' and 'Radius Y' Property values and 'Corner Radius' values respectively.
Note
Render Transforms are unique, in that unlike Layout Transforms, value changes don't impact the layout, position, or alignment of any surrounding Elements throughout the operation.
Add Element Tool
The Add Element Tool visible in the Toolbox corresponds to the last Element selected in the π Add Element Panel, and selecting it allows the Element in question to be directly 'drawn' on the π Stage.
The Add Element Tool can also be activated by pressing E on the keyboard.
With the Add Element Tool selected, the Element displayed in the Toolbox can be added to the currently-open document by clicking-and-dragging on the π Stage in the desired location and at the desired size.
Following a release of the click-and-drag, the Element will be added to the π Navigator Panel, and similary to the mechanics found in the π Move Tool, its 'Margin' Properties will automatically be set to correspond to its distance away from the edges of its 'parent' Element.
Furthermore, if the Element is 'drawn' within a π Grid Element, its 'Column', 'Column Span', 'Row', and 'Row Span' Property values will automatically be set to reflect the cells within the Grid that the Element occupies inside of it.
Upon launching the application, the π Button Element will be the default Element set in the Toolbox. Changing the Element can be accomplished by simply clicking any Element in the π Add Element Panel. Making thiis selection will also automatically arm the Add Element Tool with the clicked Element type.
Gradient Tool
Selecting the Gradient Tool allows picking from a variety of powerful functions that allow the creation and customization of Gradients within Elements:
- Clicking on an Element with the Gradient Tool equipped, will instantly apply a default Linear Gradient to its 'Background' or 'Fill' Property, provided the Element offers one of these Properties.
- When a 'Background', 'Fill', 'Stroke', or 'Border' Property with a Linear Gradient or Radial Gradient is being modified in the π Properties Panel, the Gradient Tool will be automatically selected, and allow modifying the Gradient's Properties either within the Brush Editor, or directly on the π Stage, using the Gradient adorners.
The Gradient Tool can also be activated by pressing G on the keyboard.
With a Gradient applied to an Element Property, and the Gradient Tool active:
- Clicking-and-dragging the Gradient Spline's Start Point, or End Point can be used to change its angle, and length.
- Clicking along the Gradient's spline can be used to add additional Gradient Stops at the desired position.
- Clicking-and-dragging existing Gradients Stops can be used to reposition each stop along the Gradient's spline .
- Clicking an existing Gradient Stop, then either pressing Del on the keyboard, or dragging the Gradient Stop away from the spline, can be used to remove a Stop.
- Clicking an existing Gradient Stop can be used to select its Stop in the Brush Editor, from where it can be fine-tuned, including changing its Color.
Alignment Tool
Selecting the Alignment Tool allows multiple Elements to be aligned relative to each-other.
To activate the Alignment Tool, at least two conditions must be met:
- At least two Elements must be selected using the techniques outlined in π Multi-Selecting Elements
- All Elements present in the multi-selection must be 'siblings' that both share the same 'parent' Element.
Once the multi-selection is active, the selected Elements will be adorned with a 'common' frame around them, representing the shared area they occupy on the π Stage.
This 'common' frame forms the basis of the Alignment operation. As such, when an Alignment Mode is selected from the Alignment Tool, they will placed relative to this frame.
For example, selecting 'Align Left', will align the left edge of all selected Elements, to the left edge of their 'common' frame.
Setting an Alingment will adjust two sets of Properties in the π Properties Panel:
- If the Elements are located within a π Grid Element, their 'Column', 'Column Span', 'Row', and 'Row Span' Property values will update to reflect the new space the Elements occupy within their 'parent' Grid.
- The Elements 'Margin' Property values will update to reflect their new position within their shared 'parent' Element.