Difference between revisions of "Spline Tool"
From Synfig Studio :: Documentation
m (add Command: and create link to (TODO : all dead link to command pages)) |
(Cleaning) |
||
| (4 intermediate revisions by one other user not shown) | |||
| Line 1: | Line 1: | ||
<!-- Page info --> | <!-- Page info --> | ||
{{Title|Spline Tool}} | {{Title|Spline Tool}} | ||
| + | {{TOCright}} | ||
{{Category|Tools}} | {{Category|Tools}} | ||
{{NewTerminology}} | {{NewTerminology}} | ||
<!-- Page info end --> | <!-- Page info end --> | ||
| − | |||
{{l|Image:Bline_icon.png|64px}} <span style="font-size:150%">'''ALT-B'''</span> | {{l|Image:Bline_icon.png|64px}} <span style="font-size:150%">'''ALT-B'''</span> | ||
| − | |||
==Introduction== | ==Introduction== | ||
| − | {{l|Spline|Splines}} are the most used | + | {{l|Spline|Splines}} are the most used objects in any normal animation done with Synfig, and the Spline Tool allows you to create them. |
==Usage== | ==Usage== | ||
| − | + | Select the {{Literal|Spline Tool}} in the {{l|Category:Toolbox}} or use keyboard the shortcut {{shortcut|Alt|b}} to enable it. To leave that mode just select another {{l|Category:Tools|tool}} from the {{l|Toolbox|toolbox}}. | |
===It is easy to use this tool=== | ===It is easy to use this tool=== | ||
| − | * | + | * Each single click creates a new {{Literal|Vertex}}. Its {{Literal|Tangent}} values are set to (0,0) and the {{Literal|Vertex}} becomes a sharp corner. |
| − | * Click and drag creates new | + | * Click and drag creates a new {{Literal|Vertex}} and allows the modification of the {{Literal|Tangent}} value at that {{Literal|Vertex}}. Extending the {{Literal|Tangent}} smooths the corners. |
| − | * Each new | + | * Each new {{Literal|Vertex}} is attached to the previous by a {{Literal|Bézier Spline}} defined by the vertices' position and tangents. |
| − | * The Spline is created sequentially | + | * The {{Literal|Spline}} is created sequentially, one {{Literal|Vertex}} follows the previous one. |
| − | * The end point of the previous Spline arc guides the next arc created until you close it. | + | * The end point of the previous {{Literal|Spline}} arc guides the next arc created until you close it. The next created {{Literal|Spline}} will be independent of the previously created one. |
| − | * You can tweak the newly created | + | * You can tweak the newly created Vertices by clicking on their {{l|Handle|handles}} and dragging them. |
| − | * You can also right click on a | + | * You can also right click on a {{Literal|Vertex}} handle or a {{Literal|Tangent}} handle and it will provide a context menu: |
| − | ** For | + | ** For {{Literal|Tangent}} handles: {{Literal|Split Tangent's Angle}} and {{Literal|Split Tangent's Radius}} will split the {{Literal|Tangent}} so that you can independently modify the arch of an end point of a Bézier curve. On the opposite, {{Literal|Merge Tangent's Angle}} and {{Literal|Merge Tangent's Radius}} will merge the independent {{Literal|Tangents}} so that you can align the arches of the end points of two connecting Bézier curves. |
| − | ** For | + | ** For {{Literal|Vertex}} handles: {{Literal|Loop Spline}} or {{Literal|Unloop Spline}} (depending if already looped or not) allows you to close or open the {{Literal|Spline}}. {{Literal|Delete Vertex}} allows you to delete the {{Literal|Vertex}}. |
| − | * You can also right click in the middle of a | + | * You can also right click in the middle of a Bézier curve. {{Literal|Insert Vertex}} allows the insertion of a {{Literal|Vertex}} (and sets its Tangents intelligently according to the neighboring Vertices) where you clicked. |
===To finish the Spline=== | ===To finish the Spline=== | ||
| − | # Select | + | # Select another tool in the {{l|Category:Toolbox}}. |
# Or click on the gear button [[File:Gear icon.png]] of the {{l|Tool Options Panel}}. | # Or click on the gear button [[File:Gear icon.png]] of the {{l|Tool Options Panel}}. | ||
| Line 36: | Line 35: | ||
==Options== | ==Options== | ||
| − | + | <!-- Use of Template:SplineToolOptions --> | |
| − | + | {{SplineToolOptions}} | |
| − | + | ||
| − | {{ | + | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
==Other sources of information== | ==Other sources of information== | ||
| Line 57: | Line 44: | ||
Read {{l|Doc:Creating Shapes}} which talks a little about the Spline tool. | Read {{l|Doc:Creating Shapes}} which talks a little about the Spline tool. | ||
| − | Read {{l| | + | Read {{l|Dev:Spline_Bline}} about tangent internals computation. |
| + | |||
| + | Read {{l|Dev:Bline_Speed}} which explains about variations in the Amount parameter of Splines. | ||
Latest revision as of 19:23, 1 April 2020
ALT-B
Introduction
Splines are the most used objects in any normal animation done with Synfig, and the Spline Tool allows you to create them.
Usage
Select the "Spline Tool" in the Toolbox Panel or use keyboard the shortcut AltB to enable it. To leave that mode just select another tool from the toolbox.
It is easy to use this tool
- Each single click creates a new "Vertex". Its "Tangent" values are set to (0,0) and the "Vertex" becomes a sharp corner.
- Click and drag creates a new "Vertex" and allows the modification of the "Tangent" value at that "Vertex". Extending the "Tangent" smooths the corners.
- Each new "Vertex" is attached to the previous by a "Bézier Spline" defined by the vertices' position and tangents.
- The "Spline" is created sequentially, one "Vertex" follows the previous one.
- The end point of the previous "Spline" arc guides the next arc created until you close it. The next created "Spline" will be independent of the previously created one.
- You can tweak the newly created Vertices by clicking on their handles and dragging them.
- You can also right click on a "Vertex" handle or a "Tangent" handle and it will provide a context menu:
- For "Tangent" handles: "Split Tangent's Angle" and "Split Tangent's Radius" will split the "Tangent" so that you can independently modify the arch of an end point of a Bézier curve. On the opposite, "Merge Tangent's Angle" and "Merge Tangent's Radius" will merge the independent "Tangents" so that you can align the arches of the end points of two connecting Bézier curves.
- For "Vertex" handles: "Loop Spline" or "Unloop Spline" (depending if already looped or not) allows you to close or open the "Spline". "Delete Vertex" allows you to delete the "Vertex".
- You can also right click in the middle of a Bézier curve. "Insert Vertex" allows the insertion of a "Vertex" (and sets its Tangents intelligently according to the neighboring Vertices) where you clicked.
To finish the Spline
- Select another tool in the Toolbox Panel.
- Or click on the gear button
of the Tool Options Panel.
To clear out the working Spline, press the Esc button.
Options
This tool has the following options:
- Name: Sets the name of the Spline that you will create, in this case "Spline070". If the ending part of the string contains an integer number, this input text box will parse it and increase that number for the next created Spline. Otherwise, it will add a three digit number while creating the next one.
- Layer Type: Sets whether to create Region, Outline, Advanced Outline, Plant and/or Curve Gradient Layers.
- Blend Method: Sets the blending method used to composite on the layers below.
- Opacity: Sets the Amount for new layers. Defaults to 1.00 (Completely opaque).
- Brush Size: Sets the size of the line for Outline Layer and/or Advanced Outline Layer.
- Feather: Sets the feather parameter of the Region or Outline Layer created.
- Link Origin: If checked, links the Origin for the Plant, Region or Outline if two of them (or all them) are checked.
- Auto Export: If checked, exports automatically the Vertices parameter (that's a Spline type parameter)
Other sources of information
See this video tutorial to see it in action.
Read Creating Shapes which talks a little about the Spline tool.
Read Dev:Spline_Bline about tangent internals computation.
Read Dev:Bline_Speed which explains about variations in the Amount parameter of Splines.
