Spline Tool

From Synfig Studio :: Documentation
Jump to: navigation, search
m (Genete moved page BLine Tool to Spline Tool: New Terminology)
(Terminology Updated)
Line 1: Line 1:
 
<!-- Page info -->
 
<!-- Page info -->
{{Title|BLine Tool}}
+
{{Title|Spline Tool}}
 
{{Category|Tools}}
 
{{Category|Tools}}
 +
{{Category|NewTerminology}}
 
<!-- Page info end -->
 
<!-- Page info end -->
  
Line 9: Line 10:
 
==Introduction==
 
==Introduction==
  
{{l|BLine|Blines}} are the most used object in any normal animation done with Synfig, and the Bline tool allows you to create them.
+
{{l|Spline|Splines}} are the most used object in any normal animation done with Synfig, and the Splne tool allows you to create them.
  
 
==Usage==
 
==Usage==
  
The {{Literal|Bline Tool}} button puts you in a create Bline mode. To leave that mode just select another {{l|Category:Tools|tool}} from the {{l|Toolbox|toolbox}}.
+
The {{Literal|Spline Tool}} button puts you in a create Spline mode. 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:
  
Line 19: Line 20:
 
* Click and drag creates new vertices and allows the modification of the tangent value at that vertex. Extending the tangent smooths the corners.
 
* Click and drag creates new vertices 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 {{Literal|Bezier spline}} defined by the vertices's position and it's tangents.  
 
* Each new vertex is attached to the previous by a {{Literal|Bezier spline}} defined by the vertices's position and it's tangents.  
* The BLine is created sequentially; One vertex follows another.
+
* The Spline is created sequentially; One vertex follows another.
* The end point of the previous Bezier arc guides the next arc created until you close it.  The next created BLine will be independent of the previously created BLine.  
+
* 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 Spline.  
 
* You can tweak the newly created vertices by clicking on {{l|Duck|ducks}} and dragging them.  
 
* You can tweak the newly created vertices by clicking on {{l|Duck|ducks}} and dragging them.  
 
* You can also right click on a vertex duck or a tangent duck and it will provide a context menu:
 
* You can also right click on a vertex duck or a tangent duck and it will provide a context menu:
 
** For tangent ducks: "Split tangents" will split the tangent so that you can independently modify the arch of an end point of a beizer curve.  "Merge tangents" will merge the independent tangents so that you can align the arches of the end points of two connecting beizer curves.
 
** For tangent ducks: "Split tangents" will split the tangent so that you can independently modify the arch of an end point of a beizer curve.  "Merge tangents" will merge the independent tangents so that you can align the arches of the end points of two connecting beizer curves.
** For vertex ducks: {{Literal|Loop Bline}} or {{Literal|UnLoop Bline}} (depending on if it is already looped or not) allows you to close or open the bline. {{Literal|Delete vertex}} allows you to delete the vertex.
+
** For vertex ducks: {{Literal|Loop Spline}} or {{Literal|UnLoop Spline}} (depending on if it is already looped or not) allows you to close or open the spline. {{Literal|Delete vertex}} allows you to delete the vertex.
 
* You can also right click in the middle of a beizer curve. {{Literal|Insert vertex}} allows insertion of a vertex (and set its tangents intelligently according to the neighboring vertices' values) where you clicked.
 
* You can also right click in the middle of a beizer curve. {{Literal|Insert vertex}} allows insertion of a vertex (and set its tangents intelligently according to the neighboring vertices' values) where you clicked.
  
To finish the Bline:
+
To finish the Spline:
 
# Select other {{l|Category:Tools|tool}}.
 
# Select other {{l|Category:Tools|tool}}.
 
# Or click on the gear button of the {{l|Tool Options Panel}}.
 
# Or click on the gear button of the {{l|Tool Options Panel}}.
  
To clear out the working Bline, press the {{Shortcut|Esc}} button.
+
To clear out the working Spline, press the {{Shortcut|Esc}} button.
  
 
==Options==
 
==Options==
Line 39: Line 40:
 
{{l|Image:Tool_Options.png}}
 
{{l|Image:Tool_Options.png}}
  
* BLine layer name. The name of the Bline that you will create is set by the text input box. In this case it is "Bline141". This input text will parse the end of the string if any integer number is found, increasing that number for the next time you create other Bline. If not number is found it adds a three digit number for the next Bline created.
+
* Spline Layer name. The name of the Spline that you will create is set by the text input box. In this case it is "Spline141". This input text will parse the end of the string if any integer number is found, increasing that number for the next time you create other Spline. If not number is found it adds a three digit number for the next Spline created.
 +
* Advanced Outline check box. If checked it creates an {{l|Advanced Outline Layer}}.
 
* Outline check box. If checked it creates an {{l|Outline Layer}}.
 
* Outline check box. If checked it creates an {{l|Outline Layer}}.
 
* Fill check box. If checked it creates a {{l|Region Layer}}.
 
* Fill check box. If checked it creates a {{l|Region Layer}}.
Line 45: Line 47:
 
* Gradient check box. If checked it creates a {{l|Curve Gradient Layer|Curved Gradient}}.
 
* Gradient check box. If checked it creates a {{l|Curve Gradient Layer|Curved Gradient}}.
 
* Link Offsets check box. If enabled it links the {{l|Offset Parameter}} for the Plant, Region or Outline if two of them (or all them) are checked.  
 
* Link Offsets check box. If enabled it links the {{l|Offset Parameter}} for the Plant, Region or Outline if two of them (or all them) are checked.  
* Auto Export check box. If checked it automatically exports the {{l|Vertices Parameter| Vertices parameter}} (that's a {{l|BLine|BLine}} type parameter)
+
* Auto Export check box. If checked it automatically exports the {{l|Vertices Parameter| Vertices parameter}} (that's a {{l|Spline|Spline}} type parameter)
 
* Feather numerical input field. There you set the {{l|Feather Parameter|feather parameter}} of the Region Layer or Outline Layer created.
 
* Feather numerical input field. There you set the {{l|Feather Parameter|feather parameter}} of the Region Layer or Outline Layer created.
  
Line 52: Line 54:
 
See this {{l|Video Tutorials|video tutorial}} to see it in action.
 
See this {{l|Video Tutorials|video tutorial}} to see it in action.
  
Read {{l|Doc:Creating Shapes}} which talks a little about the BLine tool.
+
Read {{l|Doc:Creating Shapes}} which talks a little about the Spline tool.
  
Read {{l|Bline Speed}} which explains about variations in the Amount parameter of BLines.
+
Read {{l|Spline Speed}} which explains about variations in the Amount parameter of Splines.

Revision as of 15:46, 6 February 2013

Languages Language: 

English • Deutsch • español • français • italiano • română • русский


Tool bline icon.png ALT-B


Introduction

Splines are the most used object in any normal animation done with Synfig, and the Splne tool allows you to create them.

Usage

The "Spline Tool" button puts you in a create Spline mode. To leave that mode just select another tool from the toolbox. It is easy to use this tool:

  • Single click creates new vertices. "Tangent" value is set to (0,0) and the vertex becomes a sharp corner.
  • Click and drag creates new vertices 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 "Bezier spline" defined by the vertices's position and it's tangents.
  • The Spline is created sequentially; One vertex follows another.
  • 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 Spline.
  • You can tweak the newly created vertices by clicking on ducks and dragging them.
  • You can also right click on a vertex duck or a tangent duck and it will provide a context menu:
    • For tangent ducks: "Split tangents" will split the tangent so that you can independently modify the arch of an end point of a beizer curve. "Merge tangents" will merge the independent tangents so that you can align the arches of the end points of two connecting beizer curves.
    • For vertex ducks: "Loop Spline" or "UnLoop Spline" (depending on if it is 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 beizer curve. "Insert vertex" allows insertion of a vertex (and set its tangents intelligently according to the neighboring vertices' values) where you clicked.

To finish the Spline:

  1. Select other tool.
  2. 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:

Image:Tool_Options.png

  • Spline Layer name. The name of the Spline that you will create is set by the text input box. In this case it is "Spline141". This input text will parse the end of the string if any integer number is found, increasing that number for the next time you create other Spline. If not number is found it adds a three digit number for the next Spline created.
  • Advanced Outline check box. If checked it creates an Advanced Outline Layer.
  • Outline check box. If checked it creates an Outline Layer.
  • Fill check box. If checked it creates a Region Layer.
  • Plant check box. If checked it creates a Plant Layer.
  • Gradient check box. If checked it creates a Curved Gradient.
  • Link Offsets check box. If enabled it links the Offset Parameter for the Plant, Region or Outline if two of them (or all them) are checked.
  • Auto Export check box. If checked it automatically exports the Vertices parameter (that's a Spline type parameter)
  • Feather numerical input field. There you set the feather parameter of the Region Layer or Outline Layer created.

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 Spline Speed which explains about variations in the Amount parameter of Splines.


Languages Language: 

English • Deutsch • español • français • italiano • română • русский