Purpose

Map is the transfer stage for control signals: it takes a value in one range and delivers it in another, with a response curve on the way. Deadband and hysteresis clean up noisy sources, Steps quantizes, Attack and Release slew the result, and the Overflow mode decides what happens outside the range — clamp, wrap, fold, or pass through.

Use

Place Map between any control source (Macro, Function, Random, MIDI Learn) and the parameter it drives. Set Inmin/Inmax to the source’s range and Outmin/Outmax to the target’s, then bend the response with Curve. Use Attack and Release when the target should ease into changes.

Inputs and outputs

• Input 0: in — the control signal to map. Optional.
• Output 0: out — the mapped signal.

Controls

• Inmin / Inmax — expected input range.
• Outmin / Outmax — target output range.
• Curve — response exponent, 0.05 to 16. 1 is linear; below bends fast-then-slow, above slow-then-fast.
• Deadband — ignores small input changes, cleaning up jittery sources.
• Hysteresis — adds direction-dependent lag so a value hovering at a boundary does not chatter.
• Steps — quantizes the output into a set number of levels. 0 is continuous.
• Attack and Release — separate slew times for rising and falling output, in seconds.
• Overflow — out-of-range behavior: clamp, wrap, fold, or allow (pass through unmodified).
• Invert — flips the output direction.

Notes

• Map is deliberately the one op to reach for between “I have a signal” and “the parameter wants something else” — range, feel, and cleanup in one place.
• fold overflow bounces at the ends, useful for turning a ramp into a triangle within the target range.
• Attack/Release here means Map can double as the smoothing stage; a separate Smooth op is not required.

Ports

Inputs

• in row
  control_f32_v1

Outputs

• out row
  control_f32_v1

Parameters

Inmin (Inmin) Float op('map').par.Inmin

Default:

0

Range:

-100000 to 100000

Inmax (Inmax) Float op('map').par.Inmax

Default:

1

Range:

-100000 to 100000

Outmin (Outmin) Float op('map').par.Outmin

Default:

0

Range:

-100000 to 100000

Outmax (Outmax) Float op('map').par.Outmax

Default:

1

Range:

-100000 to 100000

Curve (Curve) Float op('map').par.Curve

Default:

1

Range:

0.05 to 16

Deadband (Deadband) Float op('map').par.Deadband

Default:

0

Range:

0 to 1

Hysteresis (Hysteresis) Float op('map').par.Hysteresis

Default:

0

Range:

0 to 1

Steps (Steps) Float op('map').par.Steps

Default:

0

Range:

0 to 1024

Attack (Attack) Float op('map').par.Attack

Default:

0

Range:

0 to 60

Release (Release) Float op('map').par.Release

Default:

0

Range:

0 to 60

Overflow (Overflow) Menu op('map').par.Overflow

Default:

0

Options:

clamp, wrap, fold, allow

Invert (Invert) Toggle op('map').par.Invert

Default:

Off

Options:

Off, On