AdnActivation
The AdnActivation node is a dependency node that allows operations on a set of input values for the computation of a final value that can be used to drive, for example, muscle activations. An example of its use case could be the merging of the output value of various sensors together to activate a muscle given multiple poses.
How To Use
To create this node, follow these steps:
- Open the Node Editor from Windows > Node Editor.
- Press the Tab key, type AdnActivation and press Enter to create a new instance of this node.
The activation node can now be used to override, add, subtract, multiply or divide the activations from different sources (sensors) into one final activation value. For example, multiple distance sensors of a character can be merged together to produce different kinds of activations throughout the simulation.
To add new inputs to the AdnActivation node:
- Go to the Attribute Editor and press Add New Item.
- Set the desired Operator.
- Type in a fixed value in Value, animate it or connect the plug with an AdonisFX sensor's output.
All operators will be evaluated from top to bottom (starting from index 0 and ending on the last index used).
Operators
- Over (Override): Overrides the accumulated output activation value with Value. If the current accumulated activation value is 1.0 and Value is 2.0 then the new accumulated value will be 2.0.
- Add (Add): Adds the accumulated output activation value with Value. If the current accumulated activation value is 1.0 and Value is 2.0 then the new accumulated value will be 3.0.
- Sub (Subtract): Subtracts the accumulated output activation value with Value. If the current accumulated activation value is 1.0 and Value is 2.0 then the new accumulated value will be -1.0.
- Mult (Multiply): Multiplies the accumulated output activation value with Value. If the current accumulated activation value is 1.0 and Value is 2.0 then the new accumulated value will be 2.0.
- Div (Divide): Divides the accumulated output activation value with Value. If the current accumulated activation value is 1.0 and Value is 2.0 then the new accumulated value will be 0.5.
The final value can then be clamped using the output minimum and maximum sliders. For the example above this clamping has been disregarded.
Example
In the above setup we have the following characteristics:
- One AdnSensorRotation.
- One AdnSensorPosition.
- One AdnActivation.
- One AdnMuscle.
- Two inputs added to AdnActivation.
- Input 1 has an Over operator and is connected to the AdnSensorRotation.
- Input 2 has an Add operator and is connected to the AdnSensorPosition.
- The bypass option is unchecked for both inputs.
- Out Value will be: AdnSensorRotation Activation + AdnSensorPosition Activation.
Attributes
Inputs Attributes
The inputs attribute is presented as an array of 3 attributes which can be found below.
| Name | Type | Default | Animatable | Description |
|---|---|---|---|---|
| Bypass Operator | Boolean | True | ✓ | If enabled, it bypasses the current operator in the input list, which will not contribute to the final activation value. |
| Value | Float | 0.0 | ✓ | Activation value that will contribute, given the operator type, to the final activation. |
| Operator | Enum | 0 (Over) | ✓ | Operator used to contribute to the final activation. This can be: (0) Over; (1) Add; (2) Sub; (3) Mult; (4) Divide. |
Output Attributes
| Name | Type | Default | Animatable | Description |
|---|---|---|---|---|
| Output Min | Float | 0.0 | ✓ | Minimum supported output activation value. Has a range of [0.0, 10.0]. Lower and upper limit are soft, lower or higher values can be used. |
| Output Max | Float | 1.0 | ✓ | Maximum supported output activation value. Has a range of [0.0, 10.0]. Lower and upper limit are soft, lower or higher values can be used. |
Attribute Editor Template
