Difference between revisions of "Convert"

From Synfig Studio :: Documentation
Jump to: navigation, search
m (ugh - 'linear' adds different parameters depending on the type being converted...)
m (filled in missing types from the source)
Line 3: Line 3:
 
To convert the value back to its original type, select "Disconnect" from its context menu.
 
To convert the value back to its original type, select "Disconnect" from its context menu.
  
−
Angle values can be converted to [[Convert#linear|linear]], [[Convert#reference|reference]], [[Convert#scale|scale]], and [[Convert#subtract|subtract]] types.
+
Angle values can be converted to [[Convert#Linear|Linear]], [[Convert#Reference|Reference]], [[Convert#Scale|Scale]], and [[Convert#Subtract|Subtract]] types.
  
−
BLine values can be converted to [[Convert#bline|bline]], [[Convert#dynamic_list|dynamic_list]], and [[Convert#reference|reference]] types.
+
BLine values can be converted to [[Convert#BLine|BLine]], [[Convert#Dynamic List|Dynamic List]], and [[Convert#Reference|Reference]] types.
  
−
Bool values can only be converted to the [[Convert#reference|reference]] type.
+
Bool values can only be converted to the [[Convert#Reference|Reference]] type.
  
−
Color values can be converted to [[Convert#composite|composite]], [[Convert#radial_composite|radial_composite]], [[Convert#reference|reference]], [[Convert#scale|scale]], and [[Convert#subtract|subtract]] types.
+
Color values can be converted to [[Convert#Composite|Composite]], [[Convert#Radial Composite|Radial Composite]], [[Convert#Reference|Reference]], [[Convert#Scale|Scale]], and [[Convert#Subtract|Subtract]] types.
  
−
Integer values can be converted to [[Convert#reference|reference]], [[Convert#scale|scale]], and [[Convert#subtract|subtract]] types.
+
Integer values can be converted to [[Convert#Reference|Reference]], [[Convert#Scale|Scale]], and [[Convert#Subtract|Subtract]] types.
  
 
RadialComposite values (like tangents) can be converted to the same types as vector values can (see below).
 
RadialComposite values (like tangents) can be converted to the same types as vector values can (see below).
  
−
Real values can be converted to [[Convert#linear|linear]], [[Convert#reference|reference]], [[Convert#scale|scale]], [[Convert#sine|sine]], and [[Convert#subtract|subtract]] types.
+
Real values can be converted to [[Convert#Linear|Linear]], [[Convert#Reference|Reference]], [[Convert#Scale|Scale]], [[Convert#Sine|Sine]], and [[Convert#Subtract|Subtract]] types.
  
−
Vector values can be converted to [[Convert#composite|composite]], [[Convert#linear|linear]], [[Convert#radial_composite|radial_composite]], [[Convert#reference|reference]], [[Convert#scale|scale]], [[Convert#segcalctangent|segcalctangent]], [[Convert#segcalcvertex|segcalcvertex]], and [[Convert#subtract|subtract]] types.
+
Vector values can be converted to [[Convert#Composite|Composite]], [[Convert#Linear|Linear]], [[Convert#Radial Composite|Radial Composite]], [[Convert#Reference|Reference]], [[Convert#Scale|Scale]], [[Convert#Seg Calc Tangent|Seg Calc Tangent]], [[Convert#Seg Calc Vertex|Seg Calc Vertex]], and [[Convert#Subtract|Subtract]] types.
  
−
== bline ==
+
== BLine ==
  
−
Converting a parameter to "bline" doesn't seem to change anything.  Perhaps that's the default type for lists of verticies, such as are found in outlines and regions?
+
Converting a parameter to "BLine" doesn't seem to change anything.  Perhaps that's the default type for lists of verticies, such as are found in outlines and regions?
  
−
== composite ==
+
== Composite ==
  
−
Converting a parameter to "composite" adds four real-valued sub-parameters called "Red", "Green", "Blue", and "Alpha".
+
Converting a parameter to "Composite" adds four real-valued sub-parameters called "Red", "Green", "Blue", and "Alpha".
  
−
== dynamic_list ==
+
== Dynamic List ==
  
−
Converting a parameter to "dynamic_list" seems to replace each of the "Vertex NNN" sub-parameters with "Item NNN" parameters which can't be expanded, but can be exported.
+
Converting a parameter to "Dynamic List" seems to replace each of the "Vertex NNN" sub-parameters with "Item NNN" parameters which can't be expanded, but can be exported.
  
−
== linear ==
+
== Gradient Rotate ==
  
−
Converting a real parameter to be 'linear' adds two real-valued sub-parameters "Rate" and "Offset" for controlling the parameter's value.
+
== Linear ==
 +
 
 +
Converting a real parameter to be 'Linear' adds two real-valued sub-parameters "Rate" and "Offset" for controlling the parameter's value.
  
 
The parameter's value will change linearly over time, start with the value specified by "Offset" at time zero, and increasing by the value specified by "Rate" every second.
 
The parameter's value will change linearly over time, start with the value specified by "Offset" at time zero, and increasing by the value specified by "Rate" every second.
  
−
However, converting a vector parameter to be 'linear' adds two vector sub-parameters called "Slope" and "Offset".  These work just like "Rate" and "Offset" above, but in two dimensions instead of one.  (So it looks like each of these subsections can behave differently depending on the type of the value being converted - so I'll probably have to re-arrange this page...)
+
However, converting a vector parameter to be 'Linear' adds two vector sub-parameters called "Slope" and "Offset".  These work just like "Rate" and "Offset" above, but in two dimensions instead of one.  (So it looks like each of these subsections can behave differently depending on the type of the value being converted - so I'll probably have to re-arrange this page...)
 +
 
 +
== Radial Composite ==
 +
 
 +
Converting a parameter to "Radial Composite" adds four sub-parameters called "Luma", "Saturation", "Hue", and "Alpha".  "Hue" is an angle value and the other three are real values.
 +
 
 +
== Reference ==
 +
 
 +
Converting a parameter to "Reference" adds a single real-valued sub-parameter called "Link".
 +
 
 +
== Scale ==
 +
 
 +
Converting a parameter to "Scale" adds two real-valued sub-parameters called "Link" and "Scalar".
  
−
== radial_composite ==
+
== Seg Calc Tangent ==
  
−
Converting a parameter to "radial_composite" adds four sub-parameters called "Luma", "Saturation", "Hue", and "Alpha".  "Hue" is an angle value and the other three are real values.
+
Converting a parameter to "Seg Calc Tangent" adds two sub-parameters called "Segment" and "Amount".  "Segment" is a composite type containing two vertices and two tangents.  "Amount" is a real value.
  
−
== reference ==
+
== Seg Calc Vertex ==
  
−
Converting a parameter to "reference" adds a single real-valued sub-parameter called "Link".
+
Converting a parameter to "Seg Calc Vertex" adds two sub-parameters called "Segment" and "Amount".  "Segment" is a composite type containing two vertices and two tangents.  "Amount" is a real value.
  
−
== scale ==
+
== Sine ==
  
−
Converting a parameter to "scale" adds two real-valued sub-parameters called "Link" and "Scalar".
+
Converting a parameter to "Sine" adds two sub-parameters: a angle value called "Angle" and a real-valued value called "Amplitude".
  
−
== segcalctangent ==
+
== Stripes ==
  
−
Converting a parameter to "segcalctangent" adds two sub-parameters called "Segment" and "Amount".  "Segment" is a composite type containing two vertices and two tangents.  "Amount" is a real value.
+
writeme
  
−
== segcalcvertex ==
+
== Subtract ==
  
−
Converting a parameter to "segcalcvertex" adds two sub-parameters called "Segment" and "Amount".  "Segment" is a composite type containing two vertices and two tangents.  "Amount" is a real value.
+
Converting a parameter to "Subtract" adds three real-valued sub-parameters called "LHS", "RHS", and "Scalar".
  
−
== sine ==
+
== Timed Swap ==
  
−
Converting a parameter to "sine" adds two sub-parameters: a angle value called "Angle" and a real-valued value called "Amplitude".
+
This conversion is currently disabled.
  
−
== subtract ==
+
== Two-Tone ==
  
−
Converting a parameter to "subtract" adds three real-valued sub-parameters called "LHS", "RHS", and "Scalar".
+
writeme

Revision as of 18:29, 5 September 2007

Languages Language: 

English • română


Right-clicking on a value in the Parameters dialog brings up a context menu which has a sub-menu called "Convert". The "Convert" menu allows you to specify that the parameter should be controlled automatically in various ways. Depending on the type of the parameter the Convert menu will contain different options.

To convert the value back to its original type, select "Disconnect" from its context menu.

Angle values can be converted to Linear, Reference, Scale, and Subtract types.

BLine values can be converted to BLine, Dynamic List, and Reference types.

Bool values can only be converted to the Reference type.

Color values can be converted to Composite, Radial Composite, Reference, Scale, and Subtract types.

Integer values can be converted to Reference, Scale, and Subtract types.

RadialComposite values (like tangents) can be converted to the same types as vector values can (see below).

Real values can be converted to Linear, Reference, Scale, Sine, and Subtract types.

Vector values can be converted to Composite, Linear, Radial Composite, Reference, Scale, Seg Calc Tangent, Seg Calc Vertex, and Subtract types.

BLine

Converting a parameter to "BLine" doesn't seem to change anything. Perhaps that's the default type for lists of verticies, such as are found in outlines and regions?

Composite

Converting a parameter to "Composite" adds four real-valued sub-parameters called "Red", "Green", "Blue", and "Alpha".

Dynamic List

Converting a parameter to "Dynamic List" seems to replace each of the "Vertex NNN" sub-parameters with "Item NNN" parameters which can't be expanded, but can be exported.

Gradient Rotate

Linear

Converting a real parameter to be 'Linear' adds two real-valued sub-parameters "Rate" and "Offset" for controlling the parameter's value.

The parameter's value will change linearly over time, start with the value specified by "Offset" at time zero, and increasing by the value specified by "Rate" every second.

However, converting a vector parameter to be 'Linear' adds two vector sub-parameters called "Slope" and "Offset". These work just like "Rate" and "Offset" above, but in two dimensions instead of one. (So it looks like each of these subsections can behave differently depending on the type of the value being converted - so I'll probably have to re-arrange this page...)

Radial Composite

Converting a parameter to "Radial Composite" adds four sub-parameters called "Luma", "Saturation", "Hue", and "Alpha". "Hue" is an angle value and the other three are real values.

Reference

Converting a parameter to "Reference" adds a single real-valued sub-parameter called "Link".

Scale

Converting a parameter to "Scale" adds two real-valued sub-parameters called "Link" and "Scalar".

Seg Calc Tangent

Converting a parameter to "Seg Calc Tangent" adds two sub-parameters called "Segment" and "Amount". "Segment" is a composite type containing two vertices and two tangents. "Amount" is a real value.

Seg Calc Vertex

Converting a parameter to "Seg Calc Vertex" adds two sub-parameters called "Segment" and "Amount". "Segment" is a composite type containing two vertices and two tangents. "Amount" is a real value.

Sine

Converting a parameter to "Sine" adds two sub-parameters: a angle value called "Angle" and a real-valued value called "Amplitude".

Stripes

writeme

Subtract

Converting a parameter to "Subtract" adds three real-valued sub-parameters called "LHS", "RHS", and "Scalar".

Timed Swap

This conversion is currently disabled.

Two-Tone

writeme


Languages Language: 

English • română

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