Function Category¶
- The following list shows the Function Category Magma nodes available in Krakatoa MX 2.x.
- These nodes implement various function operators for producing new values from other input values.
Blend¶
- The Blend operator has three inputs and one output.
Input 1: Value At 0 (Float or Vector)
Input 2: Value At 1 (Float or Vector)
- The first and second inputs must be of the same type - either Vector or Float. They have no default values when unconnected.
Input 3: Blend Amount (Float)
- The third float input defines the blend amount and has a default value of 0.0 which causes the first input to go out as the result.
Output 1: Blended Value (Float or Vector)
- The output is the blended value of the two inputs based on the third input’s value which should be in the range from 0.0 to 1.0.
- If the third input is outside of the valid range between 0.0 and 1.0, the output value will not be clamped automatically and will go outside the range defined by the two inputs.
- The output type depends on the type of the first two inputs.
Clamp¶
- The Clamp operator has three inputs and one output.
Input 1: Float
- The mandatory first input is the value to be clamped and must be a Float.
Input 2: Minimum (Float)
- The optional second input is the Minimum range value and has a default of 0.0 when unconnected.
Input 3: Maximum (Float)
- The optional third input is the Maximum range value and has a default of 1.0 when unconnected.
Output 1: Clamped Float
- The output is the first input clamped in the range between the second and third inputs.
Curve¶
- The Curve operator has one input and one output.
Input 1: Float
- The input must be a Float and has no default value when unconnected.
Output 1: Float
- The output will be the input float value mapped by the custom curve into another float value.
- The operator provides a button to open a dedicated Curve Editor dialog.
ExponentialRandom¶
Available in Krakatoa MX v2.6.1 and higher
- The ExponentialRandom operator has two inputs and one output.
Input 1: Seed (Integer)
- The first mandatory integer input controls the Random Seed which defines the deterministic pseudo-random value for the current particle - usually the ID or Index of the particle.
Input 2: Lambda (Float)
- The second optional float input defines the Lambda value - when not connected, it can be set to the same value for all particles. It defaults to 1.0.
Output 1: ExponentialRandom (Float)
- The output is a float exponential random value.
GaussianRandom¶
Available in Krakatoa MX v2.6.1 and higher
- The GaussianRandom operator has three inputs and one output.
Input 1: Seed (Integer)
- The first mandatory integer input controls the Random Seed which defines the deterministic pseudo-random value for the current particle - usually the ID or Index of the particle.
Input 2: Mean (Float)
- The second optional float input defines the Mean value - this is the position of the tip of the bell curve. It defaults to 0.0.
Input 3: Sigma (Float)
- The third optional float input defines the Sigma value - this controls the number of standard deviations left and right of the Mean value. It defaults to 1.0, resulting together with a Mean of 0.0 in Standard Normal Distribution.
Output 1: GaussianRandom (Float)
- The output is a float value part of a general normal distribution.
Noise¶
- The Noise operatror has two inputs and one output.
Input 1: Float or Vector
- The first mandatory input must be a Float or a Vector, and has no default value when unconnected.
Input 2: Phase (Float)
- The second optional input defines the Phase value of the Noise function and defaults to 1.0 when unconnected.
- Available in Krakatoa MX v2.6.1 and higher
- The operator exposes three internal properties not controllable via inputs - Num.Octaves, Lacunarity and Normalize.
Output 1: Noise (Float)
- The output is a Float noise value calculated based on the input value and the Octaves and Lacunarity parameters.
- If the Normalize option is checked, the output will be normalized in the range from -1.0 to 1.0.
TriangleRandom¶
Available in Krakatoa MX v2.6.1 and higher
- The TriangleRandom operator has four inputs and one output.
Input 1: Seed (Integer)
- The first mandatory integer input controls the Random Seed which defines the deterministic pseudo-random value for the current particle - usually the ID or Index of the particle.
Input 2: Minimum (Float)
- The second optional float input defines the Minimum value. It defaults to 0.0.
Input 3: Probable (Float)
- The third optional float input defines the Probable value. It defaults to 0.5.
Input 4: Maximum (Float)
- The fourth optional float input defines the Maximum value. It defaults to 1.0.
Output 1: TriangleRandom (Float)
- The output is a float triangle distribution value.
UniformOnSphere¶
Available in Krakatoa MX v2.6.1 and higher
- The UniformOnSphere operator has two inputs and one output.
Input 1: Seed (Integer)
- The first mandatory integer input controls the Random Seed which defines the deterministic pseudo-random value for the current particle - usually the ID or Index of the particle.
Input 2: Dimensions (Integer)
- The second optional integer input defines the Dimensions parameter - when not connected, it can be set to the same value for all particles. It defaults to 3.
Output 1: UniformOnSphere (Float)
- The output is a float exponential random value.
UniformRandom¶
Available in Krakatoa MX v2.6.1 and higher
- The UniformRandom operator has three inputs and one output.
Input 1: Seed (Integer)
- The first mandatory integer input controls the Random Seed which defines the deterministic pseudo-random value for the current particle - usually the ID or Index of the particle.
Input 2: Minimum (Float)
- The second optional float input defines the Minimum value. It defaults to 0.0.
Input 3: Maximum (Float)
- The third optional float input defines the Maximum value. It defaults to 1.0.
Output 1:UniformRandom (Float)
- The output is a float uniform distribution random value in the range between the Minimum and Maximum parameters.
VecNoise¶
- The VecNoise operatror has two inputs and one output.
Input 1: Vector
- The first mandatory input must be a Vector.
Input 2: Phase (Float)
- The second optional input defines the Phase value of the Noise function and defaults to 1.0 when unconnected.
- Available in Krakatoa MX v2.6.1 and higher
- The operator also exposes three internal properties not controllable via inputs - Num.Octaves, Lacunarity and Normalize.
Output 1: VecNoise (Vector)
- The output is a Vector noise value calculated based on the input values and the Octaves and Lacunarity parameters.
- If the Normalize option is checked, the output will be normalized in the range from -1.0 to 1.0.
VectorUniformRandom¶
Available in Krakatoa MX v2.6.1 and higher
- The VectorUniformRandom operator has three inputs and one output.
Input 1: Seed (Integer)
- The first mandatory integer input controls the Random Seed which defines the deterministic pseudo-random value for the current particle - usually the ID or Index of the particle.
Input 2: Minimum (Float)
- The second optional float input defines the Minimum value for each component of the resulting vector. It defaults to 0.0.
Input 3: Maximum (Float)
- The third optional float input defines the Maximum value for each component of the resulting vector. It defaults to 1.0.
Output 1: VectorUniformRandom
- The output is a vector value with uniform distribution random values as components, each of them in the range between the Minimum and Maximum parameters.
WeibullRandom¶
Available in Krakatoa MX v2.6.1 and higher
- The WeibullRandom operator has three inputs and one output.
Input 1: Seed (Integer)
- The first mandatory integer input controls the Random Seed which defines the deterministic pseudo-random value for the current particle - usually the ID or Index of the particle.
Input 2: Lambda (Float)
- The second optional float input defines the Lambda parameter. It defaults to 1.0.
Input 3: Kappa (Float)
- The third optional float input defines the Kappa parameter. It defaults to 1.0.
Output 1: WeibullRandom (Float)
- The output is a float Weibull distribution value.
