//----------------------------//
ArtMatic 1 in 2 out components
//----------------------------//

12 components act as either "dual filters" or "motion functions". Dual filters (such as Modulo & Int) implement two related functions (such as floating point modulo and integer quantize) one of which is passed out the left output and the other of which is passed out the right output. These are useful in cases where you need to perform two calculations on the same value. The Dual Filters versions are computationally more efficient than connecting two different 11 Filters to the same input. A few of the 12 components (such as Circular Motion) are motion functions and translate a value (usually time) into a position. The motion function allow you to set up trees where motion is automatically created by time.
An essential in-depth discussion of ArtMatic structures Trees and components is found in ArtMatic Designer References and in Building trees.

ArtMatic script function :Constant

parameters :
A : x (-16.0 : 16.0) E9 options
B : y (-16.0 : 16.0) E9 options

discussion :
This component generates a constant vector determined by Parameters 'x' and 'y'. The input value is ignored.

Script examples:
explicit: vec2 va = Constant(A1); //will create a constant tile without parameter, connected to A1
implicit: vec2 va =(1,2); //will create a constant tile with given parameters
you can also write vec2 cc = complex(0.8,0.23) to tag the result as a complex number

• Vector:
  script call : Constant.any
  Returns a 2D vector constant (x,y)
  
• Unity vector :
  script call : Constant.unity
  Returns a 2D vector in the range -1 +1
  
• Normalised vector :
  script call : Constant.normalized
  Return a normalized 2D vector (magnitude 1)
  
• Cx + time derivative :
  script call : Constant.time_dv
  Allows an creative arbitrary animation path where the orientation can follow the trajectory. It returns in output B the derivative of the constant value changing over time when parameter A is keyframed. If no curve animates the parameter B the derivative will be zero. The keyframes value itself is returned in output A; The parameter B 'Dv (derivative) gain' allows to scale the derivative magnitude to adjust for amount of rotation. Typically the B output will be connected to a Z rotation tile to orient the object along a path.
  
• Polar coordinates:
  script call : Constant.polar
  Sets the vector using polar coordinates with radius (parameter A) ranging 0 to 2 and Angle (parameter B) in degree. The result will have a norm of radius.
  This mode is often used to constrain the constant vector to be of a particular length and handy to set seeds for complex polynomials fractals.
  

ArtMatic script function :Scale_Vector

parameters :
A : A (-16.0 : 16.0) E9 options
B : B (-16.0 : 16.0) E9 options

discussion :
Scale Vector (Ax,Bx) coming soon

ArtMatic script function :Add

parameters :
A : A (-50.0 : 50.0) E9 options
B : B (-50.0 : 50.0) E9 options

discussion :
This component is sometimes referred to as Add Vector. The outputs are x+A, x+B. Add Vector can be useful for adding offsets to the same axis or to move several objects.

discussion :
2D derivative dx,dy returns the partial derivatives df/dX, df/dY. When Normalize is at 1 the vector is normalized and will have an unit length.
The derivatives are taken by evaluating the tree above several times using finite differences. The Derivative component has to "see" the function above which means it cannot be used within a CT to compute the derivative of a function depending on values computed outside. Practically if you create a CT for a function and needs its derivative, put the derivative component outside the CT and connect the derivative to the CT output.
When used with loopers the derivative component shall be placed outside the loop, that is, after a memory or accumulating component like 11 Memory Add or 21 Orbit_analyzer # .

ArtMatic script function :Math_tools

parameters :
A : Offset A (-50.0 : 50.0) E9 options
B : Offset B (-50.0 : 50.0) E9 options
C : Thickness N (0.0 : 10.0)
D : Thickness N (0.0 : 10.0)

discussion :
This component provides a few useful math functions selected by the algorithms popup.

• log(Ax + B) & exp(Ax + B):
  The left output is the log and the right output is the exponential.
  
• exp(x s) & exp(-x s) B :slope:
  Parameter B acts as a slope value. The left output returns the positive exponent and the right output the negative exponent. The two curves are symmetrical. When creating DFRM objects, the second output could be used, for example, to thin the field while the first output is being used to scale the y-axis.
  
• tan(x) & atan(x):
  returns tan(x) in output 1 and atan(x) in output 2.
  
• Offset & Abs:
  Provides 2 abs function with independent offsets and height. This operator does not scale space and is DF friendly.
  
• Offset & N-Abs:
  Provides 2 mirror function with independent offsets and height. This operator does not scale space and is DF friendly. N-Abs is basically the DF 2D line equation so you can think of Offset & N-Abs as a way to get 2 DF lines at once that you can position with the offsets A & B. A 2D xy DF line equation is actually a 3D DF plane, since it is infinite in z. Offset & N-Abs plot, Red curve is second output below:
  
  
  

ArtMatic script function :Modulo_n_int

parameters :
A : Real Modulo (x) (0.8 : 128.0)
B : Phase (-32.0 : 32.0)
C : Int Modulo (y) (2.0 : 32.0) E9 options

discussion :
This component provides a few different flavors of Modulo and Integer functions. The left output is a continuous floating point version of the modulo/remainder function (see 11 Modulo). The right output is the discontinuous integer modulo function (which is equivalent to the 11 Quantize component).

• Modulo & int Mod C:
  Left-output is the floating point (continuous) modulo. The right-output returns the integer part of the input. The parameter option provides tiling options that limit the number of steps. This output can be very useful for differentiating copies and making them behave differently.
  
• Modulo & integer part:
  Right-output: return a unique random value B for each step of the modulo function. The parameter option provides tiling options that limit the number of steps.
  
  
  With Modulo & Random Value a constant random value (in red) is associated with each ramp cycle
  
  
  
• Modulo & Random Value:
  Similar to "Modulo & integer part" but the step function is made continuous with smoothing of the steps. The modulo returned by the x-output is the modulo of the input's absolute value and so is symmetrical. This mode was used to animate the legs in Legs Mechanics ArtMatic Voyager example. The parameter option provides tiling options that limit the number of steps.
  
• |Modulo| & smooth step:
  

discussion :
Indexed Saw provides a saw wave where each saw is indexed and the index value is returned in output 2. Saw wave is an useful primitive to repeat symetrical shapes. Period sets the space between each repeats. When the index is further passed into random tiles it can be used to modify each saw instance separately or simply the index can give a particular color when passed into a color generating tile like 13 Main Gradient .


Example in Voyager Examples/DF Modelling/Geometry/CubeStar isaw.vy

ArtMatic script function :Index_to_Array

parameters :
A : Rows # (2 : 128) integer
B : input gain (1.0 : 16.0)
C : Period (0.4 : 100.0) E9 options
D : Randomize (0.0 : 1.0)

discussion :
Index to Array coming soon

discussion :
This component creates motion along a straight line when input is connected to time (w) or z input in 2D systems. The direction is given by the "Direction" angle parameter and will be (cos(angle), sin(angle)). The 'Speed' parameter scales the input time. When negative motion will proceed backward. The motion is at constant speed if the input is linear.
The tile has the option to set the angle in degree or radian.
For a linear motion in 3D use the Linear motion tile, available starting ArtMatic Engine 8.0.

ArtMatic script function :Circular_motion

parameters :
A : Radius (0.0 : 100.0) E9 options
B : Speed X (-10.0 : 10.0) E9 options
C : Speed Y (-10.0 : 10.0) E9 options

discussion :
When Speed X and Speed Y are the same and when the input is connected to time (w), the result is a circular motion. The motion will be elliptical when the Speed X and Speed Y parameters are different. The 'Radius' sets the radius of the circle.The 'Speed X or Y' parameters scales the input time. When negative motion will proceed backward. The motion position has to be added to the target coordinates usually with 4 in 2 out add tile.
The tile has the options to interpret the radius in various units.
For a 3D circular motion you can use the 13 Circular motion tile, available starting ArtMatic Engine 8.0.

ArtMatic script function :Random_motion

parameters :
A : Amplitude (0.0 : 100.0) E9 options
B : Speed % (-50.0 : 50.0) E9 options

discussion :
This component creates continuous random 2D motion when the input is connected to time (w).The 'Amplitude' sets the radius of the motion. The 'Speed' parameter scales the input time. When negative motion will proceed backward. The random positions are generated using a 1D vector valued (2D) perlin noise function. The motion position produced by Random motion has to be added to the target coordinates usually with a 4 in 2 out add tile when the target is a 3D object.
The tile has the options to interpret the radius in various units.
For a 3D random motion you can use the 13 Random motion tile, available starting ArtMatic Engine 8.0.

ArtMatic script function :Saw_motion

parameters :
A : Amplitude (-10.0 : 10.0) E9 options

discussion :
Saw motion uses two dephased triangle saw waves to create a 45° rotated square motion. Amplitude controls both frequency and size which means this component can also be used for DF 3D modeling. This tile is available starting ArtMatic Engine 8.0. The tile has the options to interpret the Amplitude in various units.

ArtMatic script function :Perlin_noise_DV

parameters :
A : Amplitude (-8.0 : 8.0)
B : Phase (-32.0 : 32.0) E9 options
C : Frequency (-8.0 : 100.0)

discussion :
The left-output is a 1D Perlin Noise function with its derivative provided from the second output. Derivative can be used to rotate an animated object while the the left-output value animates its position.
Here one can see the derivative in red crossing zero whenever the perlin noise is flat, as expected :

discussion :
Compiled Trees are groups of tiles that can be used in place of single tiles as a kind of macro or subroutine. 12 CT can hold any 1 input / 2 outputs tree and can be seen generally as a 2D vector valued 1D function.
12 CT are often used to define 2D coordinates derived from a single input (typically time). When input is time one can see the CT as the motion path equation or a 2D parametric curve of 't'. For example x=cos(t),y=sin(t) will define a circular motion. To efficiently render parametric curve ArtMatic Engine 8 offer a new component, 2D Motion Path render, that will work in tandem with 12 Compiled trees.

usage :
Select a 12 tile and use "New compiled tree" to create a new CT from the selection (Tree Edit menu or type 'n' key).
To save a CT on disk to use the function elsewhere use "Save compiled tree" from the Tree Edit menu.
You may also copy and paste the entire CT by using Copy Tile and Paste Tile from the Edit menu.
You may iterate the tree by "Iterations" number when the tree contains an Iterations tile to modify and accumulates various values. "Scale" provide an optional scaling of outputs which is set at 1 by default (no scaling).