Difference between revisions of "Stage Tools"

From PanelForge 3 Documentation
 
(14 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
  
The 'Stage Tools' palette provides the ability to choose the current interactive tool in the stage workspace. This palette also makes available all the settings for the active stage workspace tool.
 
  
 +
The 'Stage Tools' palette provides the ability to choose the current interactive tool in the Stage workspace.
  
:[[File: StageToolsComp.png|thumb| 630px |none|]]
+
This palette also makes available all the settings for the active stage workspace tool.  
  
  
To set the active stage workspace tool select the corresponding tool icon button. The active stage tool settings can be displayed or hidden by clicking the active stage tool settings label below the stage tool icon buttons.
+
:[[File: StageTools.PNG|thumb| 570px |none|]]
  
The ability to quickly switch between different stage tools is provided by custom [[Keyboard Shortcuts]]. The current stage workspace tool can also be selected in the ’Tools’ sub menu of the ’Stage’ main application menu.
 
  
 +
To set the active stage workspace tool select the corresponding tool icon button.
  
==Select Tool==
+
The ability to quickly switch between different stage tools is provided by custom [[Keyboard Shortcuts]].
  
 +
The current stage workspace tool can also be selected in the ’Tools’ sub menu of the ’Stage’ main application menu.
  
:[[File:StageToolsSelect01.png|thumb| 219px |none|]]
 
  
 +
The active stage tool settings can be displayed or hidden by clicking the active stage tool settings label below the stage tool icon buttons.
  
The select tool provides a way to interactively select stage objects in the stage view.
 
  
Moving the mouse cursor over a stage object in the stage view and clicking will select the object replacing the current selected stage objects. When the mouse cursor is dragged over the stage view a bounding rectangle will be displayed where on mouse release the objects inside or overlapping the bounding rectangle will be selected replacing the currently selected stage objects.
+
===Stage Tool Buttons===
  
The tool behaviour of replacing the current stage object selection can be modified to adding to the current selection if the shift key is held during tool interaction. Alternatively holding the Alt key will remove the new selection from the previous stage selection.
+
Use the 'Detailed Information...' link in the below selections to view help about using each of the available Canvas Tools:
  
  
==Move Tool==
+
{|
 +
|
 +
====Select Tool====
 +
[[File: ToolMarqueeSelect.png|60px|left|caption|link=Stage_Tools_Select]]
 +
Select the Stage objects in a rectangular area of the Stage Viewport by dragging.
  
 +
[[Stage_Tools_Select|Detailed Information...]]
  
:[[File:StageToolsMove01.png|thumb| 215px |none|]]
+
====Rotate Tool====
 +
[[File: RotateTool.png|60px|left|caption|link=Stage_Tools_Move]]
 +
Interactively rotate the currently selected Stage objects by dragging the rotate manipulator in the Stage Viewport. Alternatively, select Stage Objects by dragging in the Stage Viewport.
  
 +
[[Stage_Tools_Move|Detailed Information...]]
  
The move tool will display a manipulator in the stage viewport which can be interacted with using the mouse cursor to move stage objects. The manipulator will not be shown if no stage objects are selected.  
+
====Move Pivot Tool====
 +
[[File: MovePivotTool.png|60px|left|caption|link=Stage_Tools_Move_Pivot]]
 +
Interactively move the pivot of the currently selected Stage objects by dragging the pivot manipulator in the Stage Viewport.
  
Interacting with the stage viewport area outside the move manipulator will behave as if using the select Tool described above.
+
[[Stage_Tools_Move_Pivot|Detailed Information...]]
  
The stage manipulator consists of three coloured axis arrows and a central blue square. Dragging these elements of the move manipulator will move the currently selected stage objects in the following ways:
+
| valign="top" style="width: 10%;" |
 +
| valign="top" style="width: 45%;" |
  
* '''Red arrow:''' X (left/right) coordinate axis.
+
====Move Tool====
* '''Green arrow:''' Y (up/down) coordinate axis.
+
[[File: TranslateTool.png|60px|left|caption|link=Stage_Tools_Move]]
* '''Blue arrow:''' Z (forward/backward) coordinate axis.
+
Interactively move the currently selected Stage objects by dragging the move manipulator in the Stage Viewport. Alternatively, select Stage Objects by dragging in the Stage Viewport.  
These interactions are performed in ‘object’ or ‘world’ coordinate space depending on the tool settings.
 
  
* '''Light Blue square:''' Move object in respect to the current camera view.
+
[[Stage_Tools_Move|Detailed Information...]]
  
 +
====Scale Tool====
 +
[[File: ScaleTool.png|60px|left|caption|link=Stage_Tools_Move]]
 +
Interactively scale the currently selected Stage objects by dragging the scale manipulator in the Stage Viewport. Alternatively, select Stage Objects by dragging in the Stage Viewport.
  
===Coordinate Space===
+
[[Stage_Tools_Move|Detailed Information...]]
  
The direction of the move manipulator coordinate axis can be set to align with different coordinate spaces. The following coordinate spaces are chosen:
+
====Magic Transform Tool====
 +
[[File: MagicTransformTool.png|60px|left|caption|link=Stage_Tools_Magic_Transform]]
 +
Press an object to Move and Rotate the object based on an object's surface in the Stage Viewport.
  
* '''Object Space:''' The coordinate axis used during the move operations will be angled with respect to selected stage objects rotation.
+
[[Stage_Tools_Magic_Transform|Detailed Information...]]
  
* '''World Space:''' The coordinate axis used during the move operations will be angled with respect to the stage world.
+
|}
 
 
 
 
===Manipulator positioning===
 
 
 
The position where the move manipulator is displayed in the stage viewport can be changed using the following settings:
 
 
 
* '''Manipulator at Last Selected:''' The move manipulator will be displayed at the position of the pivot point of the last selected of the selected stage objects.
 
 
 
* '''Manipulator at Selection Centre:''' The move manipulator will be displayed at the position of the average pivot point of all the selected stage objects.
 
 
 
 
 
==Nudge==
 
 
 
The move manipulator can be nudged (moved) using the keyboard arrow keys. The amount and direction of the nudge is controlled by the following settings in respect to the chosen coordinate space:
 
 
 
* '''XY Nudge:''' The right/left keys will move the selected stage objects in the X axis and up/down keys in the Y axis.
 
 
 
* '''XZ Nudge:''' The right/left keys will move the selected stage objects in the X axis and up/down keys in the Z axis.
 
 
 
* '''YZ Nudge:''' The right/left keys will move the selected stage objects in the Y axis and up/down keys in the Z axis.
 
 
 
 
 
===Nudge Value===
 
 
 
The value each press of an arrow key will nudge (move) the selected object.
 
 
 
 
 
 
 
==Rotate Tool==
 
 
 
 
 
:[[File:StageToolsRotate01.png|thumb| 219px |none|]]
 
 
 
 
 
The rotate tool will display a manipulator in the stage viewport which can be interacted with using the mouse cursor to rotate stage objects. The manipulator will not be shown if no stage objects are selected.
 
 
 
Interacting with the stage viewport area outside the move manipulator will behave as if using the select Tool described above.
 
 
 
The stage manipulator consists of four coloured circles. Dragging these elements of the rotate manipulator will rotate the currently selected stage objects in the following ways:
 
 
 
* '''Red circle:'''  Around X (left/right) coordinate axis.
 
* '''Green circle:''' Around Y (up/down) coordinate axis.
 
* '''Blue circle:''' Around Z (forward/backward) coordinate axis.
 
These interactions are performed in ‘object’ or ‘world’ coordinate space depending on the tool settings.
 
 
 
* '''Light Blue circle:''' Rotate object in respect to the current camera view.
 
 
 
===Coordinate Space===
 
 
 
The direction of the rotate manipulator coordinate axis can be set to align with different coordinate spaces. The following coordinate spaces are chosen:
 
 
 
* '''Object Space:''' The coordinate axis used during the rotate operations will be angled with respect to selected stage objects rotation.
 
 
 
* '''World Space:''' The coordinate axis used during the rotate operations will be angled with respect to the stage world.
 
 
 
===Manipulator positioning===
 
 
 
The position where the rotate manipulator is displayed in the stage viewport can be changed using the following settings:
 
 
 
* '''Manipulator at Last Selected:''' The rotate manipulator will be displayed at the position of the pivot point of the last selected of the selected stage objects.
 
 
 
* '''Manipulator at Selection Centre:''' The rotate manipulator will be displayed at the position of the average pivot point of all the selected stage objects.
 
 
 
 
 
 
 
==Scale Tool==
 
 
 
 
 
:[[File:StageToolsScale01.png|thumb| 224px |none|]]
 
 
 
 
 
The scale tool will display a manipulator in the stage viewport which can be interacted with using the mouse cursor to scale stage objects. The manipulator will not be shown if no stage objects are selected.
 
 
 
Interacting with the stage viewport area outside the move manipulator will behave as if using the select Tool described above.
 
 
 
The scale manipulator consists of three coloured axis ending with boxes and a central blue box. Dragging these elements of the move manipulator will scale the currently selected stage objects in the following ways:
 
 
 
* '''Red box:''' X (left/right) coordinate axis.
 
* '''Green box:''' Y (up/down) coordinate axis.
 
* '''Blue box:''' Z (forward/backward) coordinate axis.
 
These interactions are performed in ‘object’ or ‘world’ coordinate space depending on the tool settings.
 
 
 
* '''Light Blue box:''' Scale object uniformly in all axis.
 
 
 
Objects can only be scaled in their object space coordinates. Scaling a object in a other coordinate space may not result in the accepted result as this rule has to be maintained.
 
 
 
 
 
===Coordinate Space===
 
 
 
The direction of the move manipulator coordinate axis can be set to align with different coordinate spaces. The following coordinate spaces are chosen:
 
 
 
* '''Object Space:''' The coordinate axis used during the scale operations will be angled with respect to selected stage objects rotation.
 
 
 
* '''World Space:'''
 
The coordinate axis used during the scale operations will be angled with respect to the stage world.
 
 
 
 
 
===Manipulator positioning===
 
 
 
The position where the scale manipulator is displayed in the stage viewport can be changed using the following settings:
 
 
 
* '''Manipulator at Last Selected:''' The scale manipulator will be displayed at the position of the pivot point of the last selected of the selected stage objects.
 
 
 
* '''Manipulator at Selection Centre:''' The scale manipulator will be displayed at the position of the average pivot point of all the selected stage objects.
 

Latest revision as of 20:33, 22 September 2020


The 'Stage Tools' palette provides the ability to choose the current interactive tool in the Stage workspace.

This palette also makes available all the settings for the active stage workspace tool.


StageTools.PNG


To set the active stage workspace tool select the corresponding tool icon button.

The ability to quickly switch between different stage tools is provided by custom Keyboard Shortcuts.

The current stage workspace tool can also be selected in the ’Tools’ sub menu of the ’Stage’ main application menu.


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


Stage Tool Buttons

Use the 'Detailed Information...' link in the below selections to view help about using each of the available Canvas Tools:


Select Tool

caption

Select the Stage objects in a rectangular area of the Stage Viewport by dragging.

Detailed Information...

Rotate Tool

caption

Interactively rotate the currently selected Stage objects by dragging the rotate manipulator in the Stage Viewport. Alternatively, select Stage Objects by dragging in the Stage Viewport.

Detailed Information...

Move Pivot Tool

caption

Interactively move the pivot of the currently selected Stage objects by dragging the pivot manipulator in the Stage Viewport.

Detailed Information...

Move Tool

caption

Interactively move the currently selected Stage objects by dragging the move manipulator in the Stage Viewport. Alternatively, select Stage Objects by dragging in the Stage Viewport.

Detailed Information...

Scale Tool

caption

Interactively scale the currently selected Stage objects by dragging the scale manipulator in the Stage Viewport. Alternatively, select Stage Objects by dragging in the Stage Viewport.

Detailed Information...

Magic Transform Tool

caption

Press an object to Move and Rotate the object based on an object's surface in the Stage Viewport.

Detailed Information...