Difference between revisions of "Layers"

From Synfig Studio :: Documentation
Jump to: navigation, search
m (→‎Distortions: Curve Warp Layer)
(→‎{{l|Luma Key Layer|Luma Key}})
 
(12 intermediate revisions by 2 users not shown)
Line 2: Line 2:
 
{{Title|Layers}}
 
{{Title|Layers}}
 
{{NewTerminology}}
 
{{NewTerminology}}
 +
{{TOCright}}
 
<!-- Page info end -->
 
<!-- Page info end -->
 
The following layer types are available in synfig:
 
The following layer types are available in synfig:
Line 244: Line 245:
 
|-
 
|-
 
| Invert Negative
 
| Invert Negative
−
|
+
| When checked invert the negative colors
 
|-
 
|-
 
| Clamp Ceiling
 
| Clamp Ceiling
−
|
+
| When checked the Ceiling value is used
 
|-
 
|-
 
| Ceiling
 
| Ceiling
−
|
+
| Upper boundary of the clamping
 
|-
 
|-
 
| Floor
 
| Floor
−
|
+
| Lower boundary of the clamping
 
|}
 
|}
  
Line 342: Line 343:
 
! Description
 
! Description
 
|-
 
|-
−
| Color
+
| Z Depth
−
| Color of checkers
+
|  
 
|-
 
|-
−
| Offset
+
| Amount
 
|
 
|
 
|-
 
|-
−
| Size
+
| Blend Method
−
| Size of checkers
+
|  
 
|}
 
|}
  
Line 965: Line 966:
 
|-
 
|-
 
| Time Offset
 
| Time Offset
−
| Time offset used for image sequence import.
+
| Time offset used for {{l|Doc:ListImporter|image sequence import}}.
 
|}
 
|}
  
Line 978: Line 979:
 
| Origin
 
| Origin
 
| Point where you want the origin to be.
 
| Point where you want the origin to be.
 +
|-
 +
| Transformation
 +
| Offset, Angle, Skew angle and Scale of the Group
 
|-
 
|-
 
| Canvas
 
| Canvas
Line 988: Line 992:
 
| Time to rewind (negative) or fast forward (positive) the animation of the canvas
 
| Time to rewind (negative) or fast forward (positive) the animation of the canvas
 
|-
 
|-
−
| Children Lock
+
| {{l|Lock Selection}}
 
| When checked on you cannot select a child layer by clicking on it.  
 
| When checked on you cannot select a child layer by clicking on it.  
 +
|}
 +
 +
=== {{l|Switch Group Layer|Switch Layer}} ===
 +
 +
Parameters:
 +
{| border="1"
 +
|-
 +
! Parameter
 +
! Description
 +
|-
 +
| Transformation
 +
| Offset, Angle, Skew angle and Scale of the Group
 +
|-
 +
| Enable Transformation
 +
| Enable or disable transformation
 +
|-
 +
| Canvas
 +
| Canvas to paste
 +
|-
 +
| Speed
 +
| Adjust child layer playing speed
 +
|-
 +
| Time Offset
 +
| Time to rewind (negative) or fast forward (positive) the animation of the canvas
 +
|-
 +
| {{l|Lock Selection}}
 +
| When checked on you cannot select a child layer by clicking on it.
 +
|-
 +
| Outline Grow
 +
| Exponential value to grow children Outline layers width
 +
|-
 +
| Active Layer Name
 +
| Only layer with specified name are visible
 
|}
 
|}
  
Line 1,053: Line 1,090:
 
| Bones
 
| Bones
 
| Static list of bones elements
 
| Static list of bones elements
 +
|}
 +
 +
=== {{l|Skeleton Deformation Layer|Skeleton Deformation}} ===
 +
{| border="1"
 +
|-
 +
! Parameter
 +
! Description
 +
|-
 +
| Bones
 +
| List of bones
 +
|-
 +
| Point 1
 +
| First corner of the bounds rectangle
 +
|-
 +
| Point 2
 +
| Second corner of the bounds rectangle
 +
|-
 +
| Horizontal subdivisions
 +
| Count of horizontal subdivisions of the transformation grid
 +
|-
 +
| Vertical subdivisions
 +
| Count of vertical subdivisions of the transformation grid
 +
|}
 +
 +
=== {{l|Sound Layer|Sound}} ===
 +
 +
Parameters:
 +
{| border="1"
 +
|-
 +
! Parameter
 +
! Description
 +
|-
 +
| Filename
 +
| File to import
 +
|-
 +
| Delay
 +
| Delay before play
 +
|-
 +
| Volume
 +
| Volume of sound
 
|}
 
|}
  
Line 1,204: Line 1,281:
 
|-
 
|-
 
| Depth of Bevel
 
| Depth of Bevel
−
| Bigger values produce bigger Bevel detph.
+
| Bigger values produce bigger Bevel depth.
 
|-
 
|-
 
| Softness
 
| Softness
Line 1,210: Line 1,287:
 
|-
 
|-
 
| Use Luma
 
| Use Luma
−
|
+
| Use the luminance to calculate the light of the bevel
 
|-
 
|-
 
| Solid
 
| Solid
−
|
+
| If checked simulate of solid bevel
 
|}
 
|}
  
Line 1,228: Line 1,305:
 
|-
 
|-
 
| Offset
 
| Offset
−
| Relative displacement of the shade respecto the shaded layer(s)
+
| Relative displacement of the shade respect to the shaded layer(s)
 
|-
 
|-
 
| Size
 
| Size

Latest revision as of 05:05, 6 January 2016

Languages Language: 

English • español • français • 日本語 • română



The following layer types are available in synfig:

Blurs

Blur

Parameters:

Parameter Description
Size Size of Blur
Type Type of blur to use

Example: ( youtube corresponding sif file )

Motion Blur

Parameters:

Parameter Description
Aperture Shutter Time

Radial Blur

Parameters:

Parameter Description
Origin Point where you want the origin to be
Size Size of blur
Fade Out

Example: ( youtube corresponding sif file )

Distortions

Curve Warp

Parameters:

Parameter Description
Origin Defines the where the center will be
Width How much is expanded the result perpendicular to the source line
Start Point First point of the source line
End Point Final point of the source line
Vertices List of Spline Points where the source line is curved to
Fast When checked, renders quickly but with artifacts

Inside Out

Parameters:

Parameter Description
Origin Defines the where the center will be

Noise Distort

Parameters:

Parameter Description
Displacement How much the distortion is displaced form its original position.
Size How much separated are two consecutive distortions .
Random Seed Defines the random generator number seed.
Interpolation What type of interpolation to use
Detail Lower/higher values produces less/more detailed distortions.
Animation Speed In times per second, defines the frequency of change of the distortion.
Turbulent When checked it produces turbulent distortions.

Example: ( youtube corresponding sif file )

Spherize

Parameters:

Parameter Description
Position The center (or axis) of the distortion.
Radius Defines the radious of the distortion (spherize) or a half of the bar (vertical or horizontal bar)
Amount Defines how much convex (positive) or concave (negative) the distortion is
Clip When checked it only distorts inside the Radious area.
Distort Type The direction of the distortion (spherize, horizontal bar, vertical bar).

Example: ( youtube corresponding sif file )

Stretch

Parameters:

Parameter Description
Amount Its distance to Center defines how much the image is stretched or is shrunk
Center The position from where the distortion is made.

Example: ( youtube corresponding sif file )

Twirl

Parameters:

Parameter Description
Center The position of the twirl distortion.
Radius This is the radius of the circle of the twirl distortion
Rotations Defines how many rotations (in DEG) the twirl produces.
Distort Inside Defines if the distortion is produced inside the radious area.
Distort Outside Defines if the distortion is produced outside the radious area.

Example: ( youtube corresponding sif file )

Warp

Parameters:

Parameter Description
Source TL Top Left point of the source to warp.
Source BR Bottom Right point of the source to warp.
Dest TL Top Left point of the destination where to warp.
Dest TR Top Right point of the destination where to warp.
Dest BR Bottom Right point of the destination where to warp.
Dest BL Bottom Left point of the destination where to warp.
Clip When checked it only renders what is inside the source rectangle.
Horizon A number to define when to stop rendering when do a perspective warp. High values produces far horizons.

Example: ( youtube corresponding sif file )

Filters

Clamp

Parameters:

Parameter Description
Invert Negative When checked invert the negative colors
Clamp Ceiling When checked the Ceiling value is used
Ceiling Upper boundary of the clamping
Floor Lower boundary of the clamping

Color Correct

Parameters:

Parameter Description
Hue Adjust
Brightness
Contrast
Exposure Adjust
Gamma Adjustment

Halftone 2

Parameters:

Parameter Description
Mask Offset
Mask Angle
Mask Size
Light Color
Dark Color
Type

Halftone 3

Parameters:

Parameter Description
Mask Size
Type
Subtractive Flag
<Channel Name>Color
<Channel Name>Mask Offset
<Channel Name>Mask Angle

Luma Key

Parameters:

Parameter Description
Z Depth
Amount
Blend Method

Fractals

Julia Set

Parameters:

Parameter Description
Inside Color Color of the Set
Outside Color Color outside the Set
Color Shift
Iterations
Seed Point
Bailout ValueBase
Distort Inside
Shade Inside
Solid Inside
Invert Inside
Color Inside
Distort Outside
Shade Outside
Solid Outside
Invert Outside
Color Outside
Color Cycle
Smooth Outside Smooth the coloration outside the set
Break Set Modify equation to achieve interesting results

Mandelbrot Set

Parameters:

Parameter Description
Iterations
Bailout ValueBase
Break Set Modify equation to achieve interesting results
Distort Inside
Shade Inside
Solid Inside
Invert Inside
Gradient Inside
Offset Inside
Loop Inside
Distort Outside
Shade Outside
Solid Outside
Invert Outside
Gradient outside
Smooth Outside Smooth the coloration outside the set
Offset Outside
Scale Outside

Geometry

Common Parameters

Parameters:

Parameter Description
Z Depth Relative displacement of the depth of the layer inside the canvas
Amount Overall alpha amount of the layer.
Blend Method Type of blend method.


Checkerboard

Parameters:

Parameter Description
Color Color of checkers.
Offset Displacement of the checkboard origin.
Size Size of checkers.

Circle

Parameters:

Parameter Description
Color Circle's color.
Radius Circle's radious.
Feather Circle feather amount.
Center Circle's center.
Invert Invert the circle
Falloff Determines the falloff function for the feather

Outline

Parameters:

Parameter Description
Color Outline's color.
Offset Displacement of the Outline from the (0,0).
Invert When checked it inverts alpha results of the layer.
Antialiasing When checked it produces antialiased renders for the layer.
Feather Outline feather amount.
Type of Feather Defines the type of feather.
Winding Style. Defines overlapping behavior.
Vertices A list of Spline Points
Outline Width Default widths of the points.
Expand Defines a value to add to the Outline width.
Sharp Cusps When chekced it produces sharp corners.
Rounded Begin Round off the begin tip
Rounded End Round off the end tip
Loopyness
Homogeneous


Advanced Outline

Parameters:

Parameter Description
Color Outline's color.
Offset Displacement of the Outline from the (0,0).
Invert When checked it inverts alpha results of the layer.
Antialiasing When checked it produces antialiased renders for the layer.
Feather Outline feather amount.
Type of Feather Defines the type of feather.
Winding Style. Defines overlapping behavior.
Vertices A list of Spline Points
Outline Width Default widths of the points.
Expand Defines a value to add to the Outline width.
Tip Type at Start Define the Tip Type of the first spline point when the spline is unlooped
Tip Type at End Define the Tip Type of the last spline point when the spline is unlooped
Cusps Type Determine Cusps Type
Smoothness Determine the interpolation between withpoints. (0) Linear, (1) Smooth
Homogeneous When true, witdhpoints position are spline length based.
Width Point List List of with point that defines the variable width
Fast When checked, outline render fast but less accurate
Dashed Outline When checked, outline is dashed
Dashed Item List List of dash items that defines the dashed outline
Dashed Item Offset Distance to Offset the Dash Items

Polygon

Parameters:

Parameter Description
Vector List A list of Vector points.

Rectangle

Parameters:

Parameter Description
Color Rectangle's color.
Point 1 Position of the first point of the diagonal
Point 2 Position of the second point of the diagonal.
Expand amount Amount of expansion around the rectangle's edge.
Invert the rectangle If checked on inverts the alpha value of the layer.

Region

Parameters:

Parameter Description
Color Region's color.
Offset Displacement of the Region from the (0,0).
Invert When checked it inverts alpha results of the layer.
Antialiasing When checked it produces antialiased renders for the layer.
Feather Outline feather amount.
Type of Feather Defines the type of feather.
Winding Style. Defines overlapping behavior.
Vertices A list of Spline Points

Solid Color

Parameters:

Parameter Description
Color

Star

Parameters:

Parameter Description
Outer Radius The radius of the outer points in the star
Inner Radius The radius of the inner points in the star
Angle The orientation of the star
Points The number of points in the star

Gradients

Conical Gradient

Parameters:

Parameter Description
Gradient The gradient that's going to be mapped to the cone.
Center The center of the cone.
Angle The angle where the beginning and the end of the gradient join.
Symmetric Cheked on produces a symmetrical gradient.

Curve Gradient

Parameters:

Parameter Description
Offset Relative displacement of the gradient respect to the Spline.
Width Default width of the gradient.
Vertices A list of Spline Points
Gradient The gradient parameter
Loop If chekced on produces a looped gradient.
ZigZag When checked on it produces a double gradient.
Perpendicular If chekced on it produces a perpendicular gradient to Spline instead of parallel.
Fast When cheked on it produces a faster render but less accurate gradient.

Linear Gradient

Parameters:

Parameter Description
Point 1 First point of he gradient.
Point 2 Second point of the gradient.
Gradient The gradient parameter
Loop If chekced on produces a looped gradient.
ZigZag When checked on it produces a double gradient.

Noise Gradient

Parameters:

Parameter Description
Gradient The gradient parameter.
Random Seed Defines the random generator number seed.
Size How much separated are two consecutive distortions
Interpolation What type of interpolation to use
Detail Lower/higher values produces less/more detailed distortions.
Animation Speed In times per second, defines the frequency of change of the distortion.
Turbulent When checked on it produces turbulent distortions.
Do Alpha
Super Sampling When chekced on produces more accurate results but slower renders.

Radial Gradient

Parameters:

Parameter Description
Gradient The gradient parameter
Center The center of the radial gradient.
Radius This is the radius of the circle.
Loop When cheked on it produces a looped gradient.
Zig-Zag When checked on it produces a double gradient.

Spiral Gradient

Parameters:

Parameter Description
Gradient The gradient parameter
Center The center of the spiral gradient.
Radius This is the radius of the circle
Angle The amount of rotations of the spiral.
Clockwise When cheked on/off produces clockwise/counter-clockwise spiral gradient.

Other

Duplicate

Parameters:

Parameter Description
Index Copy Index

Import Image

Parameters:

Parameter Description
Filename File to import
Time Offset Time offset used for image sequence import.

Group layer

Parameters:

Parameter Description
Origin Point where you want the origin to be.
Transformation Offset, Angle, Skew angle and Scale of the Group
Canvas Canvas to paste
Zoom Amplification of the canvas (around the origin?)
Time Offset Time to rewind (negative) or fast forward (positive) the animation of the canvas
Lock Selection When checked on you cannot select a child layer by clicking on it.

Switch Layer

Parameters:

Parameter Description
Transformation Offset, Angle, Skew angle and Scale of the Group
Enable Transformation Enable or disable transformation
Canvas Canvas to paste
Speed Adjust child layer playing speed
Time Offset Time to rewind (negative) or fast forward (positive) the animation of the canvas
Lock Selection When checked on you cannot select a child layer by clicking on it.
Outline Grow Exponential value to grow children Outline layers width
Active Layer Name Only layer with specified name are visible

Plant

Parameters:

Parameter Description
Vertices A list of Spline Points
Gradient Gradient to be used for coloring the plant
Split Angle Angle by which each split deviates from its parent
Gravity Direction in which the shoots tend to face
Tangential Velocity Amount to which shoots tend to grow along the tangent to the Spline
Perpendicular Velocity Amount to which shoots tend to grow perpendicular to the tangent to the Spline
Stem Size Size of the stem
SizeAsAlpha If enabled, the alpha channel from the gradient is multiplied by the stem size, and an alpha of 1.0 is used when rendering
Step Measure of the distance between points when rendering
Seed Used to seed the pseudo-random number generator
Splits Maximum number of times that each sprout can sprout recursively
Sprouts Number of places that growth occurs on each Spline section
Random Factor Used to scale down all random effects. Set to zero to disable randomness
Drag Drag slows the growth

Skeleton

Parameters:

Parameter Description
Bones Static list of bones elements

Skeleton Deformation

Parameter Description
Bones List of bones
Point 1 First corner of the bounds rectangle
Point 2 Second corner of the bounds rectangle
Horizontal subdivisions Count of horizontal subdivisions of the transformation grid
Vertical subdivisions Count of vertical subdivisions of the transformation grid

Sound

Parameters:

Parameter Description
Filename File to import
Delay Delay before play
Volume Volume of sound

Stroboscope

Parameters:

Parameter Description
Frequency Frequency of the Stroboscope in times per second


Super Sample

Parameters:

Parameter Description
Width Width of sample area (In pixels)
Height Height of sample area (In pixels)
Use Parametric Use the Parametric Renderer
Be Alpha Safe

Text

Parameters:

Parameter Description
Text Text to Render
Color Color of the text
Font Family You could use values "Sans", "Times" or "Courier" for system fonts here. If you have ttf font file in the same dir as your sif/sifz file, then you may specify it's name (without extension). If ttf font file is located in another directory, then you may specify absolute or relative path to it.
Style
Weight
Horizontal Spacing Describes how close glyphs are horizontally
Vertical Spacing Describes how close lines of text are vertically
Size Size of the text
Orientation Text Orientation. Set to 0.0 for left aligned, 0.5 for centered and/or 1.0 for right aligned.
Position Text Position
Kerning Enables/Disables font kerning (If the font supports it)
Sharpen Edges Turn this off if you are going to be animating the text
Invert

Fonts that appear to work under Linux - Courier, Times, Serif, Verdana, Sans Serif.
Fonts that appear to work under Windows - Arial, Times New Roman/Serif, Verdana/Sans Serif. Courier produces an interesting, but non-legible effect.
Sans Serif appears to be the default if Synfig doesn't recognize the font.

Time Loop

Parameters:

Parameter Description
Link Time Time where the loop starts.
Local Time Used to line up the Offset time of the time loop.
Duration Amount of time of the time loop.
Only For Positive Duration Disable the Time Loop layer if Duration is <= 0.
Symmetrical Provides compatibility for the previous Time Loop layer version.

Example : tutorial (youtube)

XOR Pattern

Parameters:

Parameter Description
Offset
Size

Stylize

Bevel

Parameters:

Parameter Description
Type Type of blur to use
Hi-Color High color (where the light comes from)
Lo-Color Low color (where the light goes to)
Light Angle Angle of the light of the Bevel.
Depth of Bevel Bigger values produce bigger Bevel depth.
Softness Blur amount of the Bevel.
Use Luma Use the luminance to calculate the light of the bevel
Solid If checked simulate of solid bevel

Shade

Parameters:

Parameter Description
Color Color of the shade
Offset Relative displacement of the shade respect to the shaded layer(s)
Size Size of blur of the shade
Type Type of blur to use
Invert When checked on inverts the alpha result of the shade.

Transform

Rotate

Parameters:

Parameter Description
Origin Point where you want the origin to be
Amount Amount of rotation in degrees.

Translate

Parameters:

Parameter Description
Origin Point where you want the origin to be

Scale

Parameters:

Parameter Description
Amount Amount to scale in
Center Point to scale in to

Not Available

These layers are examples to aid developers in creating more layer types, but aren't included in binary releases of Synfig.

Shape

Parameters:

Parameter Description
Color Layer_Shape Color
Offset
Invert
Antialiasing
Feather
Type of Feather Type of feathering to use
Winding Style Winding style to use

Metaballs

Parameters:

Parameter Description
Color
Points
Radii
Weights
Threshold

Simple Circle

Parameters:

Parameter Description
Color
Center
Radius This is the radius of the circle

Filled Rectangle

Parameters:

Parameter Description
Color
Point 1
Point 2
Feather X
Feather Y
Bevel
Keep Bevel Circular


Languages Language: 

English • español • français • 日本語 • română

Retrieved from "https://wiki.synfig.org/index.php?title=Layers&oldid=21128"