Tool Options Panel

From Synfig Studio :: Documentation
Jump to: navigation, search
m (Text replace - '{{l|Category:' to '{{Category|')
m (intro section, minor rewrite intro)
 
(33 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
<!-- Page info -->
 
<!-- Page info -->
 
{{Title|Tool Options Panel}}
 
{{Title|Tool Options Panel}}
 +
{{TOCright}}
 
{{Category|Panels}}
 
{{Category|Panels}}
 +
{{NewTerminology}}
 
<!-- Page info end -->
 
<!-- Page info end -->
The Tool Options Panel displays the options you have available to apply to the current tool you're using. The icon of the panel is the current active tool is being used.  
+
=Introduction=
 +
The {{Literal|Tool Options Panel}} displays the options you have available to apply to the {{l|Toolbox|current tool}} you're using. For the tools that can create multiple layers at the same time the panel contextually display the available options for the selected type of layers.
  
The values of the Tool Options Panel parameters are stored between tool usages and between SynfigStudio sessions, so you can reuse them as may times as you like.
+
The icon for the Tool Options Panel always changes to what tool you're currently using.
 +
 
 +
The values of the {{Literal|Tool Options Panel}} parameters are stored between tool usages and between SynfigStudio sessions, so you can reuse them as may times as you like.
  
 
This is the list of available options for each tool:
 
This is the list of available options for each tool:
 +
==[[File:Tool Normal.png|30px]] {{l|Transform tool}}==
 +
<!-- Use of Template|TransformToolOptions -->
 +
{{TransformToolOptions}}
 +
 +
==[[File:Tool smooth move.png|30px]]{{l|Smooth Move Tool}}==
 +
<!-- Use of Template|SmoothMoveToolOptions -->
 +
{{SmoothMoveToolOptions}}
 +
 +
==[[File:Tool scale.png|30px]] {{l|Scale Tool}}==
 +
<!-- Use of Template|ScaleToolOptions -->
 +
{{ScaleToolOptions}}
 +
 +
==[[File:Tool rotate.png|30px]] {{l|Rotate Tool}}==
 +
<!-- Use of Template|RotateToolOptions -->
 +
{{RotateToolOptions}}
 +
 +
==[[File:Tool mirror.png|30px]] {{l|Mirror Tool}}==
 +
<!-- Use of Template|MirrorToolOptions -->
 +
{{MirrorToolOptions}}
 +
 +
==[[File:Tool circle icon.png|30px]] {{l|Circle Tool}}==
 +
<!-- Use of Template|CircleToolOptions -->
 +
{{CircleToolOptions}}
 +
 +
==[[File:Tool rectangle icon.png|30px]] {{l|Rectangle Tool}}==
 +
<!-- Use of Template|RectangleToolOptions -->
 +
{{RectangleToolOptions}}
 +
 +
==[[File:Tool star icon.png|30px]] {{l|Star Tool}}==
 +
<!-- Use of Template|StarToolOptions -->
 +
{{StarToolOptions}}
 +
 +
==[[File:Tool polygon icon.png|30px]] {{l|Polygon Tool}}==
 +
<!-- Use of Template|PolygonToolOptions -->
 +
{{PolygonToolOptions}}
 +
 +
==[[File:Tool gradient icon.png|30px]] {{l|Gradient Tool}}==
 +
<!-- Use of Template|GradientToolOptions -->
 +
{{GradientToolOptions}}
 +
 +
==[[File:Tool bline icon.png|30px]]{{l|Spline Tool}}==
 +
<!-- Use of Template:SplineToolOptions -->
 +
{{SplineToolOptions}}
 +
 +
==[[File:Tool draw icon.png|30px]] {{l|Draw Tool}}==
 +
<!-- Use of Template|DrawMoveToolOptions -->
 +
{{DrawToolOptions}}
 +
 +
==[[File:Tool cutout icon.png|30px]] {{l|Cutout Tool}}==
 +
<!-- Use of Template|CutoutToolOptions -->
 +
{{CutoutToolOptions}}
 +
 +
==[[File:Tool width icon.png|30px]] {{l|Width Tool}}==
 +
<!-- Use of Template|WidthToolOptions -->
 +
{{WidthToolOptions}}
 +
 +
==[[File:Tool fill icon.png|30px]] {{l|Fill Tool}}==
 +
<!-- Use of Template|FillToolOptions -->
 +
{{FillToolOptions}}
 +
 +
==[[File:Tool eyedrop icon.png|30px]] {{l|Eyedrop Tool}}==
 +
<!-- Use of Template|EyedropToolOptions -->
 +
{{EyedropToolOptions}}
 +
 +
==[[File:Tool text icon.png|30px]] {{l|Text Tool}}==
 +
<!-- Use of Template|TextToolOptions -->
 +
{{TextToolOptions}}
 +
 +
==[[File:Tool sketch icon.png|30px]] {{l|Sketch Tool}}==
 +
<!-- Use of Template|SketchToolOptions -->
 +
{{SketchToolOptions}}
 +
 +
==[[File:Tool brush icon.png|30px]] {{l|Brush Tool}}==
 +
<!-- Use of Template|BrushToolOptions -->
 +
{{BrushToolOptions}}
  
*{{l|Normal Tool}}
+
==[[File:Tool zoom icon.png|30px]] {{l|Zoom Tool}}==
**None
+
<!-- Use of Template|ZoomToolOptions -->
*{{l|Smooth Move Tool}}
+
{{ZoomToolOptions}}
**Radius (real number)
+
*{{l|Scale Tool}}
+
**Lock Aspect Ratio (boolean)
+
*{{l|Rotate Tool}}
+
**Allow Scale (boolean)
+
*{{l|Mirror Tool}}
+
**Horizontal (boolean exclusive)
+
**Vertical (boolean exclusive)
+
*{{l|Circle Tool}}
+
**New Layer's name (text)
+
**Feather (real)
+
**Type of feather (drop down list)
+
**Invert (boolean)
+
**Create Circle Layer (boolean)
+
**Create Outline BLine (boolean)
+
**Create Region BLine (boolean)
+
**Create Plant BLine (boolean)
+
**Create Curve Gradient BLine (boolean)
+
**Link BLine Origins (boolean)
+
**BLine points (integer)
+
**Point Angle Offset (angle)
+
*{{l|Rectangle Tool}}
+
**New Layer's name (text)
+
**Feather (real)
+
**Expansion (real)
+
**Invert (boolean)
+
**Create Rectangle Layer (boolean)
+
**Create Outline BLine (boolean)
+
**Create Region BLine (boolean)
+
**Create Plant BLine (boolean)
+
**Create Curve Gradient BLine (boolean)
+
**Link BLine Origins (boolean)
+
*{{l|Star Tool}}
+
**New Layer's name (text)
+
**Feather (real)
+
**Invert (boolean)
+
**Regular Polygon (boolean)
+
**Create Star Layer (boolean)
+
**Create Outline BLine (boolean)
+
**Create Region BLine (boolean)
+
**Create Plant BLine (boolean)
+
**Create Curve Gradient BLine (boolean)
+
**Link BLine Origins (boolean)
+
**Number of points (integer)
+
**Inner Tangent (real)
+
**Outer Tangent (real)
+
**Inner Width (real)
+
**Outer Width (real)
+
**Radius Ratio (real)
+
**Angle Offset (real)
+
*{{l|Gradient Tool}}
+
**New Layer's name (text)
+
**Gradient Type (drop down list)
+
*{{l|Polygon Tool}}
+
**New Layer's name (text)
+
**Create Polygon (action button)
+
**Clear Polygon (action button)
+
*{{l|BLine Tool}}
+
**New Layer's name (text)
+
**Create Outline BLine (boolean)
+
**Create Region BLine (boolean)
+
**Create Plant BLine (boolean)
+
**Create Curve Gradient BLine (boolean)
+
**Link BLine Origins (boolean)
+
**Auto Export (boolean)
+
**Feather (real)
+
*{{l|Text Tool}}
+
**New Layer's name (text)
+
**Multiline Editor (boolean)
+
**Size (2D vector)
+
**Orientation (2D vector)
+
**Family (text)
+
*{{l|Fill Tool}}
+
**None
+
*{{l|Eyedrop Tool}}
+
**None
+
*{{l|Zoom Tool}}
+
**None
+
*{{l|Draw Tool}}
+
**New Layer's name (text)
+
**Create Outline BLine (boolean)
+
**Create Region BLine (boolean)
+
**Auto Loop (boolean)
+
**Auto Link (boolean)
+
**Auto Extend (boolean)
+
**Auto Export (boolean)
+
**Pressure Width (boolean)
+
**Local Error (boolean)
+
**Min Pressure (boolean) & (real)
+
**Smooth (real)
+
**Feather (real)
+
**Fill Last Stroke (action button)
+
*{{l|Sketch Tool}}
+
**Show Sketch (boolean)
+
**Undo Last Stroke (action button)
+
**Clear Sketch (action button)
+
**Save Sketch As... (action button)
+
**Open a Sketch (action button)
+
*{{l|Width Tool}}
+
**Growth (real)
+
**Radius (real)
+
**Relative Growth (boolean)
+

Latest revision as of 10:08, 4 April 2016

Languages Language: 

English • français



Introduction

The "Tool Options Panel" displays the options you have available to apply to the current tool you're using. For the tools that can create multiple layers at the same time the panel contextually display the available options for the selected type of layers.

The icon for the Tool Options Panel always changes to what tool you're currently using.

The values of the "Tool Options Panel" parameters are stored between tool usages and between SynfigStudio sessions, so you can reuse them as may times as you like.

This is the list of available options for each tool:

Tool normal.png Transform Tool

  • None

Tool smooth move.pngSmooth Move Tool

  • Radius (real number)

Tool scale.png Scale Tool

Scale Tool Options.png

The Tool Options Panel allows you to specify:

  • Lock Aspect Ratio : Prevent from changing the ratio x:y of the bounding box of the selected Handles.


Tool rotate.png Rotate Tool

Rotate Tool Options.png
  • Allow Scale : Allow the selected Handles to be scaled and rotated at the same time.


Tool mirror.png Mirror Tool

Mirror Tool Options.png
  • Horizontal : Horizontal axis mirror.
  • Vertical : Vertical axis mirror.


Tool circle icon.png Circle Tool

Circle Tool Options.png

The Tool Options Panel allows you to specify:

  • Name : Used for the new layer; any number in this field will automatically increment with each layer created
  • Layer Type : Whether create Star Layer and/or Outline, Advanced Outline, Region, Plant and Curve Gradient layers (Splines)
  • Blend Method : 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 Outline width or the size of the gradient (only for Outline, Advanced Outline and Curve Gradient)
  • Spline Points : Specify the number of Spline Points that will be used in the new Splines (for other than Circle Layer)
  • Offset : Offset of the tangent of the Spline Points (for other than Circle Layer)
  • Invert : Whether invert the create(d) layer(s). Is related to his Invert.
  • Feather : Width of the area to be dissolved at the edge (not for Plant and Curve Gradient)
  • Falloff : Determines the falloff function for the feather (only for Circle Layer)
  • Link Origins : Whether Link the Offset of Splines
  • Spline Origins at Center : Set the origin of the layer at the center of the circle, else the center is set at the Canvas center


Tool rectangle icon.png Rectangle Tool

Rectangle Tool Options.png

The Tool Options Panel allows you to specify:


Tool star icon.png Star Tool

Star Tool Options.png

The Tool Options Panel allows you to specify:

  • Name : The name used for the new layer; any number in this field will automatically increment with each layer created
  • Layer Type  : Whether create Star Layer and/or Outline, Region, Plant and Curve Gradient layers (Splines)
  • Blend Method : How to combine the new layer with the background.
  • Opacity : Sets the Amount for new layers. Defaults to 1.00 (Completely opaque)
  • Brush Size : Sets the Outline width or the size of the gradient (only for Outline, Advanced Outline and Curve Gradient)
  • Star Points : The number of peaks of the star.
  • Offset : The rotation offset of the created star.
  • Radius Ratio : The ratio between the peaks and the troughs of the star
  • Regular Polygon : Whether create a regular polygon instead of a star.
  • For Splines only, the tangent lengths for outer and inner vertices. Outer is limited to [-3,10] and inner is limited to [-3,3]. (If you find useful open those limitations please write it in the talk page)
    • Inner Width
    • Inner Tangent
    • Outer Width
    • Outer Tangent
  • Invert : Whether invert the create(d) layer(s)
  • Feather : Width of the area to be dissolved at the edge (not for Plant and Curve Gradient)
  • Link Origins : Whether Link the Origin of Splines
  • Spline Origins at Center : Set the Origin of the layer at the center of the star, else the center is set at the Canvas center


Tool polygon icon.png Polygon Tool

Polygon Tool Options.png

The Tool Options Panel allows you to specify:


Tool gradient icon.png Gradient Tool

Gradient Tool Options.png

When you select the Gradient Tool, the Tool Options Panel will show the options for the Gradient Tool.

These allow you to:

  • Name : Set a name for the layer you are about to create. The name of the layer can always be changed later via the Layers Panel or the Parameters Panel if necessary, but the type of gradient needs to be chosen now.
  • Layer Type : Choose the type of gradient to create (Linear, Radial, Conical, Spiral).
  • Blend Method : The blending method used to composite on the layers below
  • Opacity : Sets the Amount for new layers. Defaults to 1.00 (Completely opaque)

For help with editing gradient colors see the section on Gradient Editor Dialog.

Tool bline icon.pngSpline Tool

Spline Tool Options.png

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)


Tool draw icon.png Draw Tool

Draw Tool Options.png

The Tool Options Panel allows you to specify:

  • Name : Used for the new layer; any number in this field will automatically increment with each layer created
  • Layer Type : Whether create Outline and/or Advanced Outline, Region layers (Splines)
  • Blend Method : 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 Outline width or the size of the gradient (only for Outline, Advanced Outline and Curve Gradient)
  • Pressure Sensitive
    • Min Pressure : The value of this option clamps the lower end of the Pressure sensitivity to a specific value, essentially determining how thin the thinnest possible segment is relative to the Brush Size parameter in the Toolbox.
  • Smoothness : Determines how much tablet jitter is removed, and as a result, how many vertices the resulting splines are composed of. Could by Local or Global
    • Local : Adjust the Spline between the Splines points.
    • Global : Adjust the Spline globally.
  • Width Max Error : for advanced outline layer.
  • Round End : The ends of the spline will be rounded, only for Outline, Advanced Outline layers.
  • Auto Loop : When the stroke of the "Draw Tool" ends near the beginning of the stroke, automatically connect the last Handle to the first.
  • Auto Extend : When the stroke begins and/or end at or near an endpoint Handle of another outline, the resulting outline is simply appended to the existing Outline Layer
  • Auto Link : When the stroke begins and/or ends at or near a vertex Handle in another outline, and the outline isn't being extended by the "Auto Extend" option above, the first and/or last vertex of the resulting outline is linked to the Handle on the existing Outline Layer.
  • Feather : Set the Feather Parameter on the layer
  • Auto Export : Automatically Export the Spline list points into the Values Base Nodes of the Library Panel


Tool cutout icon.png Cutout Tool

CutoutToolOptions.png
  • Smoothness : Adjust the Spline defining the Mask. Could be Local or Global
    • Local : Adjust the Spline between the Splines points.
    • Global : Adjust the Spline Globally.
  • Feather : Width of the area that is going to be dissolved at the edge of the mask.


Tool width icon.png Width Tool

WidthToolOptions.png
  • Growth - Defines how much a single mouse move will affect the line width. It must be non-zero for this tool to have an effect on the spline.
  • Radius - Defines the size of area around current cursor position in which a vertex will be affected. It is allows you to achieve a noticeable effect without having to follow the line precisely with the mouse. The Width Tool works fine on splines with lots of segments (such as those created with the Draw Tool), you will see it works on more than just the first vertex. It is a full circular area, other points may get in the way though.
  • Relative Growth - Doesn't really work very well unless the "Radius" parameter is set to some huge value (like a million).


Tool fill icon.png Fill Tool

  • None

Tool eyedrop icon.png Eyedrop Tool

  • None

Tool text icon.png Text Tool

The Tool Options Panel allows you to specify:

  • the Name used for the new layer; any number in this field will automatically increment with each layer created
  • "Multiline Editor" - whether to use a single or multi-line editor for entering the text. If a single line is used then the ↵ Enter key will submit the value. In the multi-line editor, you'll need to click the "OK" button with the mouse to confirm the text or hit Ctrl⇆ Tab to give focus to "OK" button.
  • "Size" X Y - the horizontal and vertical size of the text
  • "Orientation" X Y - the orientation of the text. The default (0.5, 0.5) means that the text will be centered around the point you clicked on. (0, 0) means that the top left corner of a box containing the text will be placed where you clicked. (1, 1) means that the bottom right corner of the text's bounding box will be placed where you clicked
  • "Family" - the font family to be used

Tool sketch icon.png Sketch Tool

Sketch Tool Options.png

The Sketch Tool has the following in its Tool Options Panel :

  • Show Sketch: a checkbox for toggling the visibility of the sketch overlay On and Off.
  • Undo Last Stroke: cancels the most recent edit to the sketch overlay. Can be repeatedly clicked to cancel more edits.
  • Clear Sketch: clears the current workarea's sketch overlay.
  • Save Sketch As...: writes the sketch overlay from the current workarea to a .sketch file.
  • Open a Sketch: loads a previously saved .sketch file, overwriting any previously drawn or opened sketch in the current workarea.

Sketch uses the color of the default "foreground color" in the Toolbox.

Tool brush icon.png Brush Tool

Brush Tool Options.png
  • Eraser check box. When checked, the brush acts as a rubber.
  • Display the set of configured brushes (MyPaint brushes format). By default, Synfig is installed with a selected set of brushes from "Concept Design (C_D)" pack by Ramon Miranda.
    From the Preferences Dialog, you can configure the "Brush Presets Path" to use other brushes package (for example the ones listed by MyPaint)

The "Brush Tool" uses the color of the Outline Color and the Brush Size set in the Toolbox to paint.

Tool zoom icon.png Zoom Tool

  • None


Languages Language: 

English • français