> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nomn.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# Enhancers

> Spatial effects, modulation, and temporal dynamics

This card adds spatial dimension, modulation, and temporal dynamics to your bubble sounds.

## Spatial Effects

| Knob             | What It Does                                                                                                                         |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| **Topology**     | Foam topology simulation — models how bubbles interact in a foam structure, including merging and rearrangement events.              |
| **Stereo Width** | Stereo spread of the bubble field. At 0, everything is mono-centered. At 100%, bubbles are distributed across the full stereo field. |
| **Mirror Depth** | Simulates acoustic reflection from a water surface. Creates comb-filtering and depth perception.                                     |

<Warning>
  **Topology** enables experimental foam physics simulation including coarsening dynamics and structural rearrangement events. While it creates interesting evolving textures, it can be CPU-intensive at high values. For most situations, leaving Topology at 0% is recommended.
</Warning>

## Motion Modulation

| Knob        | What It Does                                                                                                                                                                    |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Chaos**   | Randomizes unlocked parameters. Has two modes — see below. Right-click any knob to lock it from Chaos modulation.                                                               |
| **Drift**   | Slow Brownian-walk modulation over 30-120 seconds. Parameters gradually wander with velocity-smoothed random walks, creating evolving textures without sudden changes.          |
| **Scatter** | Per-voice random variation. Each simultaneous bubble gets slightly different parameter values (surface tension, viscosity, decay, radius), creating natural ensemble variation. |

### Chaos Modes (Jump vs LFO)

**Right-click the Chaos knob** to toggle between two modes:

| Mode               | Behavior                                                                                                                                                                                                               |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Jump** (default) | On every MIDI note-on, randomizes unlocked parameters by Chaos amount. Discrete jumps tied to playing.                                                                                                                 |
| **LFO**            | Continuous multi-rate LFO modulation of unlocked parameters. The label changes to "Chaos LFO" when active. Each parameter wobbles at its own slow rate, creating constantly evolving textures even on sustained notes. |

<Info>
  In **LFO mode**, the modulation runs whether you're playing or not — useful for ambient pads. In **Jump mode**, parameters only change at note-on events — useful for percussive variation.
</Info>

## Surge Modulator

Surge provides physics-based temporal envelopes that trigger on note-on, creating evolving foam events.

| Control        | What It Does                                        |
| -------------- | --------------------------------------------------- |
| **Surge Mode** | Selects the envelope shape                          |
| **Time**       | Total envelope duration (1-30 seconds)              |
| **Depth**      | How much the envelope modulates parameters (0-100%) |

### Surge Modes

| Mode       | Character                              |
| ---------- | -------------------------------------- |
| **Off**    | No temporal modulation                 |
| **Wave**   | Smooth sine-like swells                |
| **Pummel** | Aggressive attack, rhythmic pumping    |
| **Roil**   | Turbulent, chaotic modulation          |
| **Gush**   | Building intensity, like water surging |
| **Burst**  | Sharp attack, gradual decay            |

<Info>
  Surge modulates Rate among other parameters. If Rate is already at maximum, Surge has nowhere to push it higher. **Set Rate to 30-50%** so Surge can modulate in both directions for the full dynamic range of foam events.
</Info>