Exposable Array
Updated: 13 Dec 2024
Generates an Array passed through from a media server.
Exposable Array
Method #
This node allows you to take full control over the arrays directly from the media server when running back as a block. This is useful for when you are trying to design the interactive setup where the media server is the main hub of control for the hardware that is connected to it. When exposed, the media server is able to push an array into the node/block.
See the Array Sources node to see how this node is used in the nodegraph to multi-instance child nodes.
The output transform array may be used directly with a Array Cloner, or to clone other nodes within a Field System or Particle System.
JavaScript #
You can also programmatically address the Exposable Array using JavaScript with the following functions: SetTransformArrayPRS(), GetTransformArrayPRS(), SetTransformArrayColour(), GetTransformArrayColour(), SetTransformArrayUVScaleOffset() and GetTransformArrayUVScaleOffset().
Parameters
These properties control the 3D transforms of the node. Transforms will generally be inherited by child nodes, although they can be ignored through the Inherit Transform Channels attributes.
Parameter Details Position X
The objects position along the local x-axis.
Position Y
The objects position along the local y-axis.
Position Z
The objects position along the local z-axis.
Rotation Heading
The objects rotation around the local y-axis.
Rotation Pitch
The objects rotation around the local x-axis.
Rotation Bank
The objects rotation around the local z-axis.
Scale X
The objects scale along the local x-axis.
Scale Y
The objects scale along the local y-axis.
Scale Z
The objects scale along the local z-axis.
Control the inheritance of the transforms from the parent.
Parameter Details Position
Toggle inheritance of the Position from the parent.
Rotation
Toggle inheritance of the Rotation from the parent.
Scale
Toggle inheritance of the Scale from the parent.
World Position Only
Inherit the world position from the parent only, rotation and scale will be ignored. Overrides above properties.
Inherit Time
Toggle inheritance of time from the parent.
These properties control the core behaviours of the node.
Parameter Details Num Transforms
Max number of elements for this node to track.
Transform Mode
How the transform data is interpreted by Notch.
- Position : Rotation Eulers, Scale,
- Matrix 4x4 : 16 values in a 4x4 matrix
- Position : Rotation Quaternion, Scale
Transform Data
You must expose this value for the media server to be able to control the exposable array.
Apply Node Transforms To Array Elements Only
When Enabled, transform changes applied to this nodes transform properties will also be applied to the array elements, and carried onto any nodes this data is used.
Inputs
These properties control the 3D transforms of the node. Transforms will generally be inherited by child nodes, although they can be ignored through the Inherit Transform Channels attributes.
| Parameter | Details |
|---|---|
| Position X | The objects position along the local x-axis. |
| Position Y | The objects position along the local y-axis. |
| Position Z | The objects position along the local z-axis. |
| Rotation Heading | The objects rotation around the local y-axis. |
| Rotation Pitch | The objects rotation around the local x-axis. |
| Rotation Bank | The objects rotation around the local z-axis. |
| Scale X | The objects scale along the local x-axis. |
| Scale Y | The objects scale along the local y-axis. |
| Scale Z | The objects scale along the local z-axis. |
Control the inheritance of the transforms from the parent.
| Parameter | Details |
|---|---|
| Position | Toggle inheritance of the Position from the parent. |
| Rotation | Toggle inheritance of the Rotation from the parent. |
| Scale | Toggle inheritance of the Scale from the parent. |
| World Position Only | Inherit the world position from the parent only, rotation and scale will be ignored. Overrides above properties. |
| Inherit Time | Toggle inheritance of time from the parent. |
These properties control the core behaviours of the node.
| Parameter | Details |
|---|---|
| Num Transforms | Max number of elements for this node to track. |
| Transform Mode |
How the transform data is interpreted by Notch.
|
| Transform Data | You must expose this value for the media server to be able to control the exposable array. |
| Apply Node Transforms To Array Elements Only | When Enabled, transform changes applied to this nodes transform properties will also be applied to the array elements, and carried onto any nodes this data is used. |
| Name | Description | Typical Input |
|---|---|---|
| Transform Modifiers | Apply the transforms of another node to this node. | Null |
| Target Node | Modifiy the rotations of the node to always direct the z axis towards the input. | Null |
| Local Transform Override | Apply the transforms of another node to this node, relative to its parent. | Null |