Array Processing
 | Float Array Fill | Fills a float array with a specific numeric value. |
 | Float Array Offset | Adds a specific value to every float array entry. |
 | Float Array Analysis | Analyses a float array and provides some characteristic values. |
 | Double Array Analysis | Analyses a double array and provides some characteristic values. |
 | Integer Array Analysis | Analyses a integer array and provides some characteristic values. |
 | String Array Analysis | Analyses a string array and provides some characteristic values. |
 | Array Indexer | Provides access to individual array elements. |
 | Array Mixer | Mixes up individual arrays. |
The Float Array Processing nodes either perform various operations on or extract information from Array Nodes of type Float.
Fill
Returns a new float array of the length specified with the Length property. Up to the length of the input float array, old values are copied over to the new array, all excessive elements will be set to the value of the Fill property.
Offset
Adds the value specified by the Offset property to all elements in the array.
Numeric Analysis
Provides a number of output properties containing useful information about the array in general.
All values except for Length are only based on the entries up to the first entry that is not a number (i.e. the NaN constant as for example achieved by a division by zero).
| Length | Length of the array. |
| ValidLength | Number of entries up to the very first NaN value (does not apply for Integer). |
| Min | The minimum value in the array. |
| Max | The maximum value in the array. |
| HasPositive | At least one value is higher than zero. |
| HasNegative | At least one value is lower than zero. |
| HasZero | True if at least one value is zero. |
| IsNull | True if array bound to the Input property is null. |
String Analysis
Provides a number of output properties containing useful information about the string array in general.
| Length | Length of the array. |
| ValidLength | Number of not-null entries. |
| LastValidIndex | Index of the last not-null entry. |
| Shortest | First shortest not-null string. |
| Longest | First longest not-null string. |
| ShortestIndex | Index of the first shortest not-null string. |
| LongestIndex | Index of the first longest not-null string. |
| ShortestLength | Length of the first shortest not-null string. |
| LongestLength | Length of the first longest not-null string. |
| HasNulls | True if at least one string is null. |
| IsNull | True if array bound to the Input property is null. |
Array Indexer
The Array Indexer node provides access to individual elements of an array or to a range of elements. This node is the equivalent to the Array node. The type of array and the number of elements which should be accessed have to be specified when the node is dragged to the Content Editor. Using the buttons on the bottom of the Property Editor you can add and remove elements from the array after the creation has been done. Allowed types are the same as in the Array node. The individual array elements are available as output properties (Value_0000 etc.). The NewArray property also provides these values as an Array property. The event Changed is fired if one of the output properties has changed. The input property IndexStart defines at which index in the source array the reading of the elements should begin. If the last elements in the source array are reached and there are not enough elements to fill all outputs of the Array Indexer, the remaining outputs are set to zero.
Note that the number of array elements is limited to 10000 for performance reasons!
Array Mixer
The Array Mixer is able to perform Insert, Remove and Overwrite operations on an incoming Array.
The type of array which should be modified has to be specified when the node is dragged to the Content Editor.
The initial array content, on which the operations are performed, is specified by the BaseArray property. AutoReset specifies if the output property ResultArray should be reset to BaseArray if the scene is loaded. A manual reset can be triggered by the Reset method. Note that all operation are cumulative and change the active array. All further operation are performed on the modified array!
To insert values to the active array one has to specify the InsertArray, the InsertIndex
at which the insertion begins and trigger the Insert method. If the insertion index is larger than the length of the current ResultArray, nothing is inserted!
To remove a range of values in the active array specify the RemoveIndex at which the removal should start and RemoveLength which defines the number of elements to remove. Remove triggers the remove operation.
There are two separated overwrite operations available to perform complex array updates. To overwrite a certain range of values specify the NewArray property, the WriteIndex at which the overwrite should start and trigger the according Overwrite method. Note that an overwrite beyond the end of the active array will not add elements to the active array.