ProtoFlux:Increment

+ +

*

OnWritten

OnFail

Variable

null

∅

Actions

Increments take Variable (Variable Pseudo-generic) as a global, and will increase the value that Variable (Variable Pseudo-generic) points to by 1.

Keep in mind this node will only work if given variables that can be incremented. Trying to increment a non numeric value like a Boolean or an Enum will not work.

Increments are a way to change a specified value without driving it. Instead you can use Increments to change a value in a similar fashion to changing the value through the inspector. Using Increments helps with performance too, since the values provided to the node only evaluate for one game tick while the node is being impulsed vs a driver which evaluates every game tick. This can also be used to reduce the amount of times code is evaluated. If you have to search the entire root for your code to find a slot and then do an operation, using Increments with your operations will help with performance since you're only searching once and not every single game tick.

When it comes to Increments, you can drag any matching typed source onto the Variable field to set that as the variable target. When you want to write to a Local Variable Store, Data Model Variable Store, or a Store Variable Store, you can grab the Variable field on Increments nodes and then choose the one you want in your context menu. This can save considerable time spent trying to find the type you want in another node menu.

If you just need to add + 1 to your value using pure data, use the Value Inc node instead.

If you need to add more than + 1 to your value, use the Add node instead.

Inputs

* (Call)

Call this to write the value.

Outputs

OnWritten (Continuation)

sends an impulse after * (Call) has been impulsed and the value pointed to by Variable (Variable Pseudo-generic) has been incremented.

OnFail (Continuation)

sends an impulse after * (Call) has been impulsed and the value wasn't able to be incremented due to a missing target or Variable (Variable Pseudo-generic) not pointing to a valid IField`1.

Globals

Variable (Variable Pseudo-generic)

The numeric Variable to increment by 1.

Examples

• How to use a simple increment setup.
  How to use a simple increment setup.