Difference between revisions of "Layers"

Revision as of 14:01, 3 July 2015 (view source) D.j.a.y (Talk | contribs) m (→‎{{l|Group Layer|Group layer}}: {{l|Lock Selection}}) ← Older edit		Latest revision as of 05:05, 6 January 2016 (view source) Jcome (Talk | contribs) (→‎{{l|Luma Key Layer|Luma Key}})
(6 intermediate revisions by one other user 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 1,011:		Line 1,012:
	| Canvas		| Canvas
	| Canvas to paste		| Canvas to paste
		+	|-
		+	| Speed
		+	| Adjust child layer playing speed
	|-		|-
	| Time Offset		| Time Offset
	| 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.
	|-		|-
Line 1,277:		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,283:		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,301:		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

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