Doc:How Do I

Feel free to add your own questions here. Or put them on the Wiki Wish List.

Apply a gradient to an object instead of the entire canvas?

1. Create the region you want to fill with a gradient, and the gradient layer, if you haven't already.
2. Make sure that the gradient layer is above the region layer in the Layers Dialog.
3. Select both layers, right click, and select Encapsulate.
4. Expand the new Inline Canvas layer if it's not already, and select your gradient layer.
5. In the Params Dialog select the Blend Method parameter, and choose Onto from the drop-down menu.

The gradient will clip to the visible area of the region below it inside the Inline Canvas. (and any other layers in that section).

Show or hide a layer, or fade the effect of a blur?

In the Params Dialog, look for an option labeled Amount - this controls how much of the blended result of the layer is composited with the blend of the layers beneath it.

In other words, for a typical layer, this will 'fade it out'. For a Blur Layer set to "Straight", this will fade between the blurred version and the unblurred version of the canvas. If you want it to become less blurry, adjust the Blur Layer's 'size' parameter.

== Fill an outline? == (Requested by Karlb)

There are several options:

• The easiest way is to link a new region layer to the outline's shape.
  1. From the Layer Menu (either context-click on the Layers Dialog or use the Canvas Menu Caret) create a new Region Layer
  2. Make sure that the Region Layer is above the Outline Layer in the Layers Dialog - this affects which layer's shape remains after the link.
  3. Select both layers in the Layers Dialog This will display only the parameters shared by both layers in the Params Dialog.
  4. Context-click on the Vertices Parameter, and select Link.
  5. The Region Layer will snap to the shape of the Outline Layer.
• Similar to the above, but using a different method:
  1. Select the outline you want to fill.
  2. In the Params dialog, right-click the Verticies parameter, select "Export", enter a name for the shape, and hit return. This will export the shape of the outline, making it visible in the Children dialog.
  3. In the Children dialog, open the ValueBase Nodes tree and select the name you just saved the shape as.
  4. Create a new region layer as above, and leave it selected.
  5. In the parameter dialog, right-click the Verticies parameter and click "Connect".
• When you create an outline with the bline tool that you intend to be a filled area as well, make sure you select the Fill checkbox in the tool options dialog. Obviously, this doesn't help much if you realise later that you needed a fill here.
• If you are using the draw tool, there is a button at the bottom of the tool options dialog labeled "Fill Last Stroke", which creates a new Region Layer and links its shape to the previously drawn outline. Unfortunately, it doesn't work as of Synfig Studio v0.61.04
• Create a region with the same number of ducks, and manually link each duck. If you want a region that depends on multiple outline layers, this is really your only choice for now.

Dock Together Windows?

• To dock (join) separate windows into one you must drag the tab icons for each of the tools into another window.
• You can create subdivisions inside the windows by dragging the icons into the side tabs (located around the edges, the look like rectangles).
• Tool tabs inside the window can be arranged by dragging them on top of one another, therefore changing the order.

Use an external Bitmap?

• In the image menu (>) choose file-->import. PNG with alpha channel works fine.
• To animate it without accidental stretching, right-click on the layer and choose encapsulate. You can then animate the position of the new "Inline Canvas" layer instead of the bbox.

Close a bline?

• Right click on the starting point and then click on loop bline.

Note: It doesn't work unless the initial point has a tangent - ie the first segment is curved.

How do I transform encapsulated objects?

• Right click on the Encapsulated object in the Layer dialog and choose "select all child layers". Then you select the ducks you want to transform (usually just all of them, like for rotating the object), and the rotate or scale tool and do the work.