Skeleton Deformation Layer

From Synfig Studio :: Documentation
Jump to: navigation, search
m (following usage)
m (Usage of the Skeleton Deformation Layer: Specific parameters)
Line 77: Line 77:
 
== Usage of the Skeleton Deformation Layer ==
 
== Usage of the Skeleton Deformation Layer ==
  
=== Setup of the distortion area ===
+
=== Set the distortion area ===
  
 
The Skeleton Deformation Layer's bound rectangle define the distortion area. You can modify it by dragging the handles of the first and second corners ({{literal|Point 1}} up left and {{literal|Point 2}} down right).
 
The Skeleton Deformation Layer's bound rectangle define the distortion area. You can modify it by dragging the handles of the first and second corners ({{literal|Point 1}} up left and {{literal|Point 2}} down right).
Line 89: Line 89:
 
Once you have terminated to setup the bones of your skeleton, from the {{l|Layers Panel}}, right click on the {{l|Skeleton Deformation Layer}} and from the contextual menu choose {{literal|Reset Pose}} to create the initial pose (without deformation) of the skeleton.
 
Once you have terminated to setup the bones of your skeleton, from the {{l|Layers Panel}}, right click on the {{l|Skeleton Deformation Layer}} and from the contextual menu choose {{literal|Reset Pose}} to create the initial pose (without deformation) of the skeleton.
  
Now you can play with your skeleton.
+
Now you can animate your skeleton !
 +
 
 +
== Specific parameters for Skeleton Deformation Layers ==
 +
 
 +
Some of the parameters of Skeleton Deformation Layers are common parameter that are shared for several types of Layers. Click on the links to see their definitions. Only the particular parameters for the Skeleton Deformation Layers are described here.
 +
 
 +
=== Bones ===
 +
The {{literal|Bones}} parameter is a list of Bone elements.
 +
 
 +
The parameters of a {{literal|Bone}} are:
 +
 
 +
{|border="0" align="none" style="border-collapse"  cellpadding="3" cellspacing="0"
 +
|-style="background:#C0C0C0"
 +
|'''Name'''||'''Value'''||'''Type''' 
 +
|-style="background:#"
 +
||{{l|Image:Type_string_icon.png|16px}} Name
 +
||Bone 1
 +
||string
 +
 
 +
|-style="background:#eeeeee"
 +
|| {{l|Parent Parameter|Parent}}
 +
||No Parent
 +
||bone_valuenode
 +
 
 +
|-style="background:#"
 +
||{{l|Image:Type_vector_icon.png|16px}} {{l|Origin Parameter|Origin}}
 +
||0.00000, 0.00000
 +
||vector
 +
 
 +
|-style="background:#eeeeee"
 +
||{{l|Image:Type_angle_icon.png|16px}} {{l|Angle Parameter|Angle}}
 +
||0.00°
 +
||angle
 +
 
 +
|-style="background:#"
 +
||{{l|Image:Type_real_icon.png|16px}} {{l|Local Length Scale Parameter|Local Length Scale}}
 +
||1.00000
 +
||real
 +
 
 +
|-style="background:#eeeeee"
 +
||{{l|Image:Type_real_icon.png|16px}} {{l|Bone Width Parameter|Bone Width}}
 +
||0.10000
 +
||real
 +
 
 +
|-style="background:#"
 +
||{{l|Image:Type_real_icon.png|16px}} {{l|Recursive Length Scale Parameter|Recursive Length Scale}}
 +
||1.00000
 +
||real
 +
 
 +
|-style="background:#eeeeee"
 +
||{{l|Image:Type_real_icon.png|16px}} {{l|Tip Width Parameter|Tip Width}}
 +
||0.10000
 +
||real
 +
 
 +
|-style="background:#"
 +
||{{l|Image:Type_real_icon.png|16px}} {{l|Length Setup Parameter|Length Setup}}
 +
||1.00000
 +
||real
 +
 
 +
|}
 +
 
 +
=== Point 1 ===
 +
The parameter {{literal|Point 1}} is a Vector point defining the upper left corner of the distortion area.
 +
 
 +
=== Point 2 ===
 +
The parameter {{literal|Point 2}} is a Vector point defining the bottom right corner of the distortion area.
 +
 
 +
=== Horizontal Subdivisions ===
 +
Horizontal definition of the meshes. This integer value affect the distortion quality.
 +
 
 +
=== Vertical Subdivisions ===
 +
Vertical definition of the meshes. This integer value affect the distortion quality.
 +
 
 +
== See also ==
 +
 
 +
Vector art specific {{l|Skeleton Layer}}.

Revision as of 10:44, 31 August 2014


Rewrite preparation for 0.65

  I'm a Draft please help me to be efficient ... 


64px

About Skeleton Deformation Layers

Skeleton Deformation Layer is for raster deformation (pixel level) and can be used to image layers or whatever is in the context of the skeleton deformation layer (the rendered result of what's below it).

Skeleton Deformation acts like a normal "raster" layer (i.e. Blur, Warp), it is a raster deformation.

The Skeleton Distortion layer allows to set the distortion area and mesh resolution.

The Layers Panel's Show/Hide checkbox of the Skeleton Deformation Layer activate/deactivate the deformation and the visibility of the distortion area.

Parameters of Skeleton Deformation Layers

The parameters of the Skeleton Deformation 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 integer icon.png Type Fast Gaussian Blur integer
16px Bones list
Type vector icon.png Point 1 vector
Type vector icon.png Point 2 vector
Type integer icon.png Horizontal subdivisions 32 integer
Type integer icon.png Vertical subdivisions 32 integer


Usage of the Skeleton Deformation Layer

Set the distortion area

The Skeleton Deformation Layer's bound rectangle define the distortion area. You can modify it by dragging the handles of the first and second corners ("Point 1" up left and "Point 2" down right).

Build the skeleton

To setup the bones of the Skeleton Deformation Layer, first, deactivate the deformation unchecking the "Show" checkbox of from the Layers Panel. Now you can move the first bone using his "Origin" handle, change his orientation with the "Angle" handle and his length using the "Local Length Scale" handle. Right click in any handle of bones and choose "Create Child Bone" to create another bone and adjust it with his handles. Any child bones will follow recursively his parents position.

Reset the Pose

Once you have terminated to setup the bones of your skeleton, from the Layers Panel, right click on the Skeleton Deformation Layer and from the contextual menu choose "Reset Pose" to create the initial pose (without deformation) of the skeleton.

Now you can animate your skeleton !

Specific parameters for Skeleton Deformation Layers

Some of the parameters of Skeleton Deformation Layers are common parameter that are shared for several types of Layers. Click on the links to see their definitions. Only the particular parameters for the Skeleton Deformation Layers are described here.

Bones

The "Bones" parameter is a list of Bone elements.

The parameters of a "Bone" are:

Name Value Type
Type string icon.png Name Bone 1 string
Parent No Parent bone_valuenode
Type vector icon.png Origin 0.00000, 0.00000 vector
Type angle icon.png Angle 0.00° angle
Type real icon.png Local Length Scale 1.00000 real
Type real icon.png Bone Width 0.10000 real
Type real icon.png Recursive Length Scale 1.00000 real
Type real icon.png Tip Width 0.10000 real
Type real icon.png Length Setup 1.00000 real

Point 1

The parameter "Point 1" is a Vector point defining the upper left corner of the distortion area.

Point 2

The parameter "Point 2" is a Vector point defining the bottom right corner of the distortion area.

Horizontal Subdivisions

Horizontal definition of the meshes. This integer value affect the distortion quality.

Vertical Subdivisions

Vertical definition of the meshes. This integer value affect the distortion quality.

See also

Vector art specific Skeleton Layer.