Noeud de Valeur

From Synfig Studio :: Documentation
Jump to: navigation, search
Languages Language: 

English • français • română • 中文(中国大陆)‎

         Cette page à besoin d'être traduite, soyez patient et/ou participez!

Un Noeud de Valeur est une valeur qui peut changer dans le temps.

A Noeud de Valeur 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 Noeud de Valeur - waypoints are how Animated ValueNodes work out what value to be at each point in time.

Each Noeud de Valeur (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 Noeud de Valeur's type is a real number in each case:

Noeuds de Valeurs Constants

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

"3.4, for ever"

Noeuds de Valeurs Animés

These have Points de Passages 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"

Noeuds de Valeurs Convertis

These are ValueNodes which have been Converted into sub-parameters, each of which is itself a Noeud de Valeur. Right-clicking on a parameter and selecting a type from the 'convert' sub-menu allows you to convert a Noeud de Valeur. 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


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


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 Noeud de Valeur is completely lost. Maybe other parameters still connected to the value node too, so it is not deleted.


Exporter, take a Noeud de Valeur (animated, constant or linkable) and labels it with a unique name. The exported Noeud de Valeur 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 Panneau Bibliothèque.


When a Exported Noeud de Valeur is selected in the Panneau Bibliothèque 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)


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)

Languages Language: 

English • français • română • 中文(中国大陆)‎