Group Layer

From Synfig Studio :: Documentation
Revision as of 08:11, 31 December 2014 by Ciaran (Talk | contribs) (replace use of template:L with normal links)

Jump to: navigation, search
Languages Language: 

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


Layer other group icon.png

About Group Layers

The "Group Layer" is a special layer that can hold other layers. It is generated via the Group command accessed via the context menu in the Layers Panel or through the Layer Menu in the Canvas Menu Caret. As well as grouping a set of layers it can also translate them, scale them, and even modify the time for the layers it contains.

"Group Layers" can also be created through the New Layer Menu, using "<New Layer> → <Other> → Group Layer".

Parameters of Group Layers

The parameters of the "Group Layers" are:

Name Value Type
Type real icon.png Z Depth 0.000000 real
Type real icon.png Amount 1.000000 real
Type integer icon.png Blend Method Composite integer
Type vector icon.png Origin 0.000000u,0.000000u vector
Type canvas icon 0.63.06.png Canvas Parameter <No Image Selected> canvas
Type real icon.png Zoom 0.000000 real
Type time icon.png Time Offset Of time
Type bool icon.png Children Lock
bool (Static)
Type vector icon.png Focus Point 0.000000u,0.000000u vector
Type real icon.png Outline Grow 0.000000 real

Canvas Parameter

Type canvas icon 0.63.06.png

This is "Group" by default if the "Group Layers" was created by grouping other layers, or "No Image Selected" if it was created from the New Layer Menu. This parameter lets you select another canvas.

The canvas parameter presents a drop-down menu of the exported canvases, plus an extra entry called "Other...". Selecting "Other..." presents the user with a text entry box asking for the name of the canvas to use. The name typed should have the following format (where [ ] indicates an optional part, ( ) is for grouping, and * means "0 or more times"):

  [[filename]#][:]id(:id)*

In its simplest form, this is just an id, ie. the exported name of one of the child canvases of the current canvas.

Other possibilities are:

  • if a '#' is present, the part before the '#' is interpreted as the filename of an external .sif file to use.
  • if the '#' is the first character of the string (ie. the filename is blank) then the '#' is ignored, and the current canvas is used instead
  • if a ':' appears before the first id, it means to start at the root canvas of the current canvas
  • each subsequent :id steps down into the specified child

Examples:

  • /usr/share/doc/synfig/examples/business_card.sifz#:IndividualCard -- gives the absolute path to a .sifz file, and says to use the canvas that was exported from its root canvas as "IndividualCard"
  • ../../examples/business_card.sifz#:IndividualCard -- the same, but with a relative path to the .sifz file
  • #:sy:head:eyes:left -- look in the current composition, and starting from the root, navigate down through the canvas tree. Find a child canvas of the root canvas called 'sy', look in 'sy' for a child canvas called 'head', and so on.
  • :sy:head:eyes:left -- exactly as above. an empty filename is the same as not using the '#' at all
  • eyes:left -- without a ':' before the first id, this starts at the current canvas (presumably the Group in question is in the "head" subcanvas of the "sy" subcanvas of the root)

Outline Grow Parameter

This parameter allows to control thickness of all outline layers inside. Assigning positive value to this parameter makes all child outlines rendered thicker, while negative value makes them look thinner. This feature is very helpful for tuning outlines in complex artwork and it also allows to achieve some nice effects like constant outline width at any zoom level.

Note: The "Outline Grow" parameter can not be applied to exported and imported (external) Groups layers.

Paste-canvas-outline-grow-param.png


Languages Language: 

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