Range

The Range node takes an input value and constrains it to lie within the interval defined by Range Min and Range Max. If the value is already within the range, it passes through unchanged and the rolled-over output is zero. If the value exceeds either end of the range, the Clipped Value output contains the nearest boundary value, and the Rolled-Over Value output contains the signed excess (positive if the value was above the maximum, negative if below the minimum).

The node automatically handles inverted ranges. If you set Range Min higher than Range Max, the node internally swaps them so the clamp always operates on a valid interval. This means you never need to worry about which value is larger when connecting dynamic range sources.

The node computes two values in a single step:

1. Clipped Value = clamp(Value, lo, hi), where lo = min(Range Min, Range Max) and hi = max(Range Min, Range Max).
2. Rolled-Over Value = Value - Clipped Value.

Examples

Notice in the last two rows: when Range Min and Range Max are swapped, the node still works correctly because it internally normalizes the range.

• Constraining parameter values: Prevent a slider or sensor value from exceeding safe bounds. For example, clamp a brightness value to [0, 1] before sending it to a renderer.
• Overflow detection: Use the Rolled-Over Value to detect and measure how much a signal exceeds its expected range. Connect it to a Compare node to trigger alerts when overflow occurs.
• Wrapping behavior: Feed the Rolled-Over Value back through another Range node or add it to a base value to create wrapping or modular arithmetic behavior.
• Soft limiting with feedback: Use the Rolled-Over Value as a feedback signal to apply back-pressure or adjustment to the source of the value.
• Safe MIDI/DMX output: Clamp computed values to [0, 127] for MIDI or [0, 255] for DMX before sending them to hardware output nodes, using the Rolled-Over Value to log any clipping.
• Data normalization preprocessing: Clamp raw sensor readings to a known valid range before feeding them into a Remap node for scaling.

• The Rolled-Over Value is signed: positive means the value was above the max, negative means it was below the min. You can use a Math node with the Abs operation to get the unsigned magnitude of the excess.
• When both outputs are summed together, they always equal the original input value: Clipped Value + Rolled-Over Value = Value. This identity can be useful for splitting a signal into its "in-range" and "out-of-range" components.
• If you only need simple clamping without the rolled-over output, you can still use this node and ignore the second output. There is no performance penalty for unused output ports.
• For creating a wrapping range (like a circular angle that wraps from 360 back to 0), use a Math node with the Modulo operation instead, as it provides true cyclic wrapping behavior.
• Connect a Time node to the Value input and set Range Min/Max to create a repeating time window. The Clipped Value will plateau at the bounds while the Rolled-Over Value shows how far past the window you are.