Counter | Provides integer values on demand or automatically in a customizable range. |
The Counter node represents an integer value that can be increased or decreased by triggering the Forward or Backward methods respectively. The valid interval of the integer value can be set by the Start and End properties and the amount to increase/decrease can be changed via Step. If EndExcl is activated, the last valid value is the one before the End. This is useful if the counter value is used to access arrays. If Loop is active, the counter will continue at the start value once it has reached the end value. If UseEventArguments is enabled, the Forward/Backward/Reset methods evaluate the argument if an event is bound to them. In this case Forward/Backward will increase/decrease by the argument value and Reset will set the Counter to the argument value.
Various output events are provided:
StartReached | Fired whenever value is equal to the start properties value. |
EndReached | Fired whenever value is equal to the end properties value. |
Overrun | Fired when value exceeds the range limits in Loop mode. |
Underrun | Fired when value under-runs the range limits in Loop mode. |
The Counter node also has an Autorun feature which triggers the Forward method based on either the number of frames or time that has passed. This is especially useful when output values should be generated on a frame by frame basis, e.g. for controlling the playback of image sequences. The Interval property defines the number of frames rendered by Ventuz before a subsequent value is generated by the Counter node.
Reset sets Value to the value defined by Start and stops autorun.