Number
This node stores and manages a numeric value.
The Number node holds a number that can be updated, read, and monitored for changes.
The Number node is a variable container for numeric data. It stores a number (integer or float) and provides mechanisms to update it either immediately or upon a signal trigger.
Inputs
General
| Data | Description |
|---|---|
| Value | The number to store. Default: 0. |
Actions
| Signal | Description |
|---|---|
| Set | Triggers the update of the stored value. If connected, the Value input is buffered until this signal is received. |
Outputs
Data
| Data | Description |
|---|---|
| Value | The currently stored numeric value. |
Signals
| Signal | Description |
|---|---|
| Changed | Triggered whenever the stored value changes (i.e., new value is different from old value). |
| Stored | Triggered when the Set action is completed, regardless of whether the value changed. |
Usage
Use the Number node to store scores, counters, coordinates, or any other numeric state.
Modes of Operation
- Direct Update (Default):
- Leave the Set input disconnected.
- Any change to the Value input immediately updates the stored value and triggers the Changed signal.
- Explicit Update (Buffered):
- Connect a signal to the Set input.
- Changes to the Value input are "buffered" internally.
- The stored value only updates (and outputs change) when the Set signal is triggered.
Example Use Cases
- Score Keeping: Store the current player score.
- Settings: Store a volume level or brightness setting.
- Counters: Use with math nodes to create a counter (Current Value + 1 -> New Value).
Detailed Behavior
- Type Casting: Any input provided to Value is automatically converted to a number (
Number(value)). Non-numeric strings will result inNaN. - Change Detection: The Changed signal only fires if the new value is strictly different from the current value.
- Stored Signal: The Stored signal fires every time Set is triggered, even if the value remains the same.
Troubleshooting
- Value Not Updating: If you have connected a wire to the Set input, the node enters "Explicit Update" mode. You must trigger the Set signal for the value to update.
- NaN Result: If you pass a non-numeric string (like "hello") to the input, the value will become
NaN(Not a Number).