Difference between revisions of "Handle"

From Synfig Studio :: Documentation
Jump to: navigation, search
m (Choose your handles: Selection from Multiple Layers + multiple rectangle selection)
m (another table with handle)
 
(18 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
<!-- Page info -->
 
<!-- Page info -->
 
{{Title|Handle}}
 
{{Title|Handle}}
 +
{{TOCright}}
 
{{Category|Glossary}}
 
{{Category|Glossary}}
 
{{NewTerminology}}
 
{{NewTerminology}}
 
<!-- Page info end -->
 
<!-- Page info end -->
 
+
A {{Literal|Handle}} is a [https://en.wikipedia.org/wiki/Widget_%28GUI%29 widget] on {{l|Category:Canvas_Window}} that can be used to control some {{l|parameter}}s of a {{l|Layers|layer}}.
A 'handle' is a widget on {{l|Canvas}} window that can be used to control some {{l|parameter}}s of a {{l|Doc:Layers|layer}}.
+
  
 
For example, a circle will have one handle to control the position of its center, and another to control its radius.
 
For example, a circle will have one handle to control the position of its center, and another to control its radius.
  
Handles are displayed in the {{l|Work Area}} for all the currently selected layers and for all the currently selected {{l|ValueNodes}} in the {{l|Children Panel}}. If you are seeing handles you don't expect to see, check in the {{l|Children Panel}} - you probably have {{l|ValueNodes}} selected in there.
+
Handles are displayed in the {{l|WorkArea}} for all the currently selected layers and for all the currently selected {{l|ValueNodes}} in the {{l|Library Panel}}.  
 +
 
 +
 
 +
{| border="1"  align="center" style="border-collapse:collapse"
 +
|  align="center" | [[File:Duck_position_icon.png|32px]]
 +
|  align="center" | [[File:Duck_vertex_icon.png|32px]]
 +
|  align="center" | [[File:Duck_tangent_icon.png|32px]]
 +
|  align="center" | [[File:Duck_radius_icon.png|32px]]
 +
| align="center" |  [[File:Duck_width_icon.png|32px]]
 +
|  align="center" | [[File:Duck_angle_icon.png|32px]]
 +
|-
 +
| align="center" | Position
 +
| align="center" |  Vertex
 +
| align="center" |  Tangent
 +
| align="center" |  Radius
 +
| align="center" |  Width
 +
| align="center" |  Angle
 +
|}
 +
They have different color on depending on what they control : a position (green), a vertex point (orange), a tangent (yellow), a width point (purple), a radius (blue)...
 +
 
 +
[[File:Handle_example_current.png|frame|center|A shape with a position (green), some vertex points (orange), six tangents (yellow), a width point (purple) and three width points center (grey) handles]]
 +
 
 +
=Display by kind of type=
 +
By default, all but {{literal|Width handles}} are displayed.
 +
 
 +
From the {{c|<Menu>|<View>|Show/Hide Handles}} or the {{l|Category:Canvas Window}} you have can choose witch handles you want to be displayed.
 +
 
 +
{| border="1"  style="border-collapse:collapse"
 +
|  align="center" | [[File:Duck_position_icon.png|32px|Toggle display of "Position" Handles]]
 +
|  align="center" | [[File:Duck_vertex_icon.png|32px|Toggle display of "Vertex" Handles]]
 +
|  align="center" | [[File:Duck_tangent_icon.png|32px|Toggle display of "Tangent" Handles]]
 +
|  align="center" | [[File:Duck_radius_icon.png|32px|Toggle display of "Radius" Handles]]
 +
| align="center" |  [[File:Duck_width_icon.png|32px|Toggle display of "Width" Handles]]
 +
|  align="center" | [[File:Duck_angle_icon.png|32px|Toggle display of "Angle" Handles]]
 +
|-
 +
| align="center" | Position
 +
| align="center" |  Vertex
 +
| align="center" |  Tangent
 +
| align="center" |  Radius
 +
| align="center" |  Width
 +
| align="center" |  Angle
 +
|-
 +
|  align="center" |  {{Shortcut|Alt|1}}
 +
|  align="center" |  {{Shortcut|Alt|2}}
 +
|  align="center" |  {{Shortcut|Alt|3}}
 +
| align="center" |  {{Shortcut|Alt|4}}
 +
|  align="center" |  {{Shortcut|Alt|5}}
 +
|  align="center" | {{Shortcut|Alt|6}}
 +
|}
 +
 
 +
The {{Literal|Toggle Handles}} buttons group (see {{l|Category:Canvas Window}}), permit to individually toggle the visibility of handles by type.
 +
 
 +
If you are seeing handles you don't expect to see, check in the {{l|Library Panel}} - you probably have {{l|ValueNodes}} selected in there.
 +
 
 +
See also :
 +
* {{l|Keyboard_Shortcuts|Synfig keyboard shortcuts}}
 +
* {{l|Category:Canvas_Window|Toggle handles in canvas window}}
  
 
= Move the Handle =
 
= Move the Handle =
 +
== With the Mouse ==
 +
Click and drag the handles around to change the parameters.
  
Drag the handles around to change the parameters. Hold {{Shortcut|shift}} while dragging to constrain the movement to be either horizontal or vertical.
+
Hold {{Shortcut|shift}} while dragging to constrain the movement to be either horizontal or vertical.
 +
== With the keyboard==
 +
More precise control of the handles can be achieved using the cursor (also named arrow) keys : {{shortcut|←}}{{shortcut|↑}}{{shortcut|↓}}{{shortcut|→}}.
  
More precise control of the handles can be achieved using the cursor keys. The cursor keys will move the currently selected handle one pixel at a time, or ten pixels at a time if the {{Shortcut|shift}} key is pressed.
+
The cursor keys will move the currently selected handle '''1''' pixel at a time, or '''10''' pixels at a time if the {{Shortcut|shift}} key is pressed.
  
 
= Choose your handles =
 
= Choose your handles =
  
More than one handle can be selected at a time.  
+
Handle selection can be done one by one or by group.
* Hold {{Shortcut|control}} while clicking on a handle to toggle the selection on and off without affecting the selection status of the other handles.  
+
==One by one==
* Drag a rectangle around a group of handles to select them all and unselect the other handles.  
+
* Move your pointer near a {{l|Handle}} it will signal it by changing his shape. Click on it. The handle is now selected, reflected by a visual information, and any other previously selected handle will be unselected. Single click on a handle replace the current selection. 
* Hold {{Shortcut|control}} while dragging a rectangle around a group of handles to select them as well as the currently selected handles. You can repeat the operation, the new selected handles will be added to current selection.  
+
* Hold {{Shortcut|shift}} while clicking on a handle '''to add''' it to the current selection.  
* Hit {{Shortcut|control|A}} to select all non-position handles.
+
* Hold {{Shortcut|control}} while clicking on a handle '''to toggle''' the selection '''on''' and '''off''' without affecting the selection status of the other handles.  
 +
==By group==
 +
* Click on the {{l|WorkArea}} and '''drag a rectangle''' around a group of handles to select them all and unselect the other handles.  
 +
* Hold {{Shortcut|shift}} while dragging a rectangle around a group of handles to select them as well as the currently selected handles. You can repeat the operation, the new selected handles will be '''added''' to current selection.
 +
* Hold {{Shortcut|ctrl}} while dragging a rectangle around a group of handles to '''toggle''' them and keep the rest. You can repeat the operation.  
 +
* Hit {{Shortcut|control|A}} to select all '''non-position''' handles.  In a {{l|Lock_Selection|selection-locked}} {{l|Group Layer|group layers}} this will select the {{l|Group_Transformation_Widget}}'s handles.
 +
 
 +
==From multiple Layers==
 +
If you want to select handles from multiple {{l|Layer|Layers}}, in the {{l|Layers Panel}} or direct from the {{l|Canvas}} first select the layers you want, them select the handles by any combination of single of group selection.
  
If you want to select handles from multiple {{l|Layer|Layers}}, in the {{l|Layers Panel}} or direct from the {{l|Canvas}} first select the layers you want, them select the handles holding {{Shortcut|control}} while dragging some rectangles around to create the group you desire.
+
==Clear the current selection==
 +
To clear the current selection, in the {{l|WorkArea}} click out of any {{l|Handle}}. You may like also the {{shortcut|Control|D}} to Deselect all Handles.
  
 
= Old name of handles =
 
= Old name of handles =
  
[[Ducks|This is how the handles were called some time ago.]]
+
{{literal|Ducks}} : [[Ducks|This is how the handles were called some time ago.]]

Latest revision as of 22:51, 14 September 2016

Languages Language: 

English • français



A "Handle" is a widget on Canvas Window that can be used to control some Parameters of a layer.

For example, a circle will have one handle to control the position of its center, and another to control its radius.

Handles are displayed in the WorkArea for all the currently selected layers and for all the currently selected ValueNodes in the Library Panel.


Duck position icon.png Duck vertex icon.png Duck tangent icon.png Duck radius icon.png Duck width icon.png Duck angle icon.png
Position Vertex Tangent Radius Width Angle

They have different color on depending on what they control : a position (green), a vertex point (orange), a tangent (yellow), a width point (purple), a radius (blue)...

A shape with a position (green), some vertex points (orange), six tangents (yellow), a width point (purple) and three width points center (grey) handles

Display by kind of type

By default, all but "Width handles" are displayed.

From the "<Menu> → <View> → Show/Hide Handles" or the Canvas Window you have can choose witch handles you want to be displayed.

Toggle display of "Position" Handles Toggle display of "Vertex" Handles Toggle display of "Tangent" Handles Toggle display of "Radius" Handles Toggle display of "Width" Handles Toggle display of "Angle" Handles
Position Vertex Tangent Radius Width Angle
Alt1 Alt2 Alt3 Alt4 Alt5 Alt6

The "Toggle Handles" buttons group (see Canvas Window), permit to individually toggle the visibility of handles by type.

If you are seeing handles you don't expect to see, check in the Library Panel - you probably have ValueNodes selected in there.

See also :

Move the Handle

With the Mouse

Click and drag the handles around to change the parameters.

Hold ⇧ Shift while dragging to constrain the movement to be either horizontal or vertical.

With the keyboard

More precise control of the handles can be achieved using the cursor (also named arrow) keys : .

The cursor keys will move the currently selected handle 1 pixel at a time, or 10 pixels at a time if the ⇧ Shift key is pressed.

Choose your handles

Handle selection can be done one by one or by group.

One by one

  • Move your pointer near a Handle it will signal it by changing his shape. Click on it. The handle is now selected, reflected by a visual information, and any other previously selected handle will be unselected. Single click on a handle replace the current selection.
  • Hold ⇧ Shift while clicking on a handle to add it to the current selection.
  • Hold Control while clicking on a handle to toggle the selection on and off without affecting the selection status of the other handles.

By group

  • Click on the WorkArea and drag a rectangle around a group of handles to select them all and unselect the other handles.
  • Hold ⇧ Shift while dragging a rectangle around a group of handles to select them as well as the currently selected handles. You can repeat the operation, the new selected handles will be added to current selection.
  • Hold Ctrl while dragging a rectangle around a group of handles to toggle them and keep the rest. You can repeat the operation.
  • Hit ControlA to select all non-position handles. In a selection-locked group layers this will select the Group Transformation Widget's handles.

From multiple Layers

If you want to select handles from multiple Layers, in the Layers Panel or direct from the Canvas first select the layers you want, them select the handles by any combination of single of group selection.

Clear the current selection

To clear the current selection, in the WorkArea click out of any Handle. You may like also the ControlD to Deselect all Handles.

Old name of handles

"Ducks" : This is how the handles were called some time ago.


Languages Language: 

English • français