Difference between revisions of "ValueNode"

From Synfig Studio :: Documentation
Jump to: navigation, search
m (Text replace - ']]' to '}}')
m (Add data linking category)
 
(6 intermediate revisions by 5 users not shown)
Line 1: Line 1:
A ValueNode is a value that can change over time.
+
{{Category|Glossary}}
 +
{{NewTerminology}}
 +
{{Category|Data Linking}}
 +
<!-- End Page info -->
  
A ValueNode represents a description of a value and how it changes (or doesn't!) over time.
+
A {{l|ValueNode}} is a value that can change over time.
  
ValueNodes are the things we see as the value for every parameter of every layer.  The waypoints visible in the timetrack dialog are also part of the ValueNode - waypoints are how Animated ValueNodes work out what value to be at each point in time.
+
A {{l|ValueNode}} represents a description of a value and how it changes (or doesn't!) over time.
  
Each ValueNode (and hence each {{l|Parameter}} in Synfig has one of 13 {{l|Types}}.
+
{{l|ValueNode|ValueNodes}} are the things we see as the value for every parameter of every {{l|Layers|layer}}.  The {{l|Waypoint|waypoints}} visible in the {{l|Timetrack Panel}} are also part of the {{l|ValueNode}} - waypoints are how Animated {{l|ValueNode|ValueNodes}} work out what value to be at each point in time.
  
There are three kinds of ValueNodes in Synfig.  In the following examples the ValueNode's type is a [http://en.wikipedia.org/wiki/Real_number real number] in each case:
+
Each {{l|ValueNode}} (and hence each {{l|Parameter}} in Synfig has one of 13 {{l|Dev:Types|Types}}.
 +
 
 +
=Kinds of ValueNodes=
 +
 
 +
There are three kinds of {{l|ValueNode|ValueNodes}} in Synfig.  In the following examples the {{l|ValueNode}}'s type is a [http://en.wikipedia.org/wiki/Real_number real number] in each case:
  
 
== Constant ValueNodes ==
 
== Constant ValueNodes ==
  
These have a single value for all time, and no waypoints.  An example of such a ValueNode would be:
+
These have a single value for all time, and no waypoints.  An example of such a {{l|ValueNode}} would be:
  
 
  "3.4, for ever"
 
  "3.4, for ever"
Line 26: Line 33:
 
== Converted ValueNodes ==
 
== Converted ValueNodes ==
  
These are ValueNodes which have been {{l|Convert|Converted}} into sub-parameters, each of which is itself a ValueNode.  Right-clicking on a parameter and selecting a type from the 'convert' sub-menu allows you to convert a ValueNode.  Converted ValueNodes don't have waypoints themselves, but their sub-parameters may do.  An example would be:
+
These are {{l|ValueNode|ValueNodes}} which have been {{l|Convert|Converted}} into sub-parameters, each of which is itself a {{l|ValueNode}}.  Right-clicking on a parameter and selecting a type from the 'convert' sub-menu allows you to convert a {{l|ValueNode}}.  Converted {{l|ValueNode|ValueNodes}} don't have waypoints themselves, but their sub-parameters may do.  An example would be:
 
   "start at 3.4 and linearly increase by 1.2 per second"
 
   "start at 3.4 and linearly increase by 1.2 per second"
 +
 +
=Actions on ValueNodes=
 +
 +
==Convert==
 +
{{l|Convert|Converts}} a {{l|ValueNode}} into a Linkable type. It disconnects from the previous value node then creates a new Linkable {{l|ValueNode}} and connects the parameter to that new nalue node.
 +
 +
==Disconnect==
 +
Creates a Constant value node based on the value of the parameter at the frame where the action is executed. It disconnect from the previous value node and connect the parameter to that new constant value node.
 +
 +
{{l|ValueNode|ValueNodes}} are not discarded completely until all parameter that were connected to get disconnected. So when you disconnect from a value node it doesn't mean that the {{l|ValueNode}} is completely lost. Maybe other parameters still connected to the value node too, so it is not deleted.
 +
 +
==Export==
 +
{{l|Export}}, take a {{l|ValueNode}} (animated, constant or linkable) and labels it with a unique name. The exported {{l|ValueNode}} is now known at any place of the document (by any layer) so any other parameter can Connect to it. All exported {{l|ValueNode|ValueNodes}} are stored in the {{l|Library Panel}}.
 +
 +
==Connect==
 +
When a Exported {{l|ValueNode}} is selected in the {{l|Library Panel}} it is available to be {{l|Connect|connected}} to any parameter, so the parameter is plugged to that exported value node. When you Connect a parameter to an exported value node, the parameter is disconnected from the previous value node. Parameters and Exported value nodes can be Connected only of they are type compatible (i.e. angle with angle and not angle with vector)
 +
 +
==Link==
 +
When two or more parameters are selected at the same time (usually from two layers) it is possible to {{l|Linking|link}} the {{l|ValueNode|ValueNodes}}. In this case all except one of the selected previous parameters are disconnected from its value nodes and then connected to the value node selected from the selected. The decision on which value node is kept and used as link value node is taken inside the code and cannot be user decided (but it should be)

Latest revision as of 10:16, 27 January 2015


A ValueNode is a value that can change over time.

A ValueNode represents a description of a value and how it changes (or doesn't!) over time.

ValueNodes are the things we see as the value for every parameter of every layer. The waypoints visible in the Time Track Panel are also part of the ValueNode - waypoints are how Animated ValueNodes work out what value to be at each point in time.

Each ValueNode (and hence each Parameter in Synfig has one of 13 Types.

Kinds of ValueNodes

There are three kinds of ValueNodes in Synfig. In the following examples the ValueNode's type is a real number in each case:

Constant ValueNodes

These have a single value for all time, and no waypoints. An example of such a ValueNode would be:

"3.4, for ever"

Animated ValueNodes

These have Waypoints that specify their value at particular points in time. For times which don't have a value specified, the value is calculated by interpolating between the waypoints. An example would be:

"3.4 at the beginning of the animation,
move smoothly up to 7.6 at time = 10 seconds,
then jump instantly to 2.0
and stay there until the end of time"

Converted ValueNodes

These are ValueNodes which have been Converted into sub-parameters, each of which is itself a ValueNode. Right-clicking on a parameter and selecting a type from the 'convert' sub-menu allows you to convert a ValueNode. Converted ValueNodes don't have waypoints themselves, but their sub-parameters may do. An example would be:

 "start at 3.4 and linearly increase by 1.2 per second"

Actions on ValueNodes

Convert

Converts a ValueNode into a Linkable type. It disconnects from the previous value node then creates a new Linkable ValueNode and connects the parameter to that new nalue node.

Disconnect

Creates a Constant value node based on the value of the parameter at the frame where the action is executed. It disconnect from the previous value node and connect the parameter to that new constant value node.

ValueNodes are not discarded completely until all parameter that were connected to get disconnected. So when you disconnect from a value node it doesn't mean that the ValueNode is completely lost. Maybe other parameters still connected to the value node too, so it is not deleted.

Export

Export, take a ValueNode (animated, constant or linkable) and labels it with a unique name. The exported ValueNode is now known at any place of the document (by any layer) so any other parameter can Connect to it. All exported ValueNodes are stored in the Library Panel.

Connect

When a Exported ValueNode is selected in the Library Panel it is available to be connected to any parameter, so the parameter is plugged to that exported value node. When you Connect a parameter to an exported value node, the parameter is disconnected from the previous value node. Parameters and Exported value nodes can be Connected only of they are type compatible (i.e. angle with angle and not angle with vector)

Link

When two or more parameters are selected at the same time (usually from two layers) it is possible to link the ValueNodes. In this case all except one of the selected previous parameters are disconnected from its value nodes and then connected to the value node selected from the selected. The decision on which value node is kept and used as link value node is taken inside the code and cannot be user decided (but it should be)