misc

Author: koppi

README.md

@@ -153,6 +153,154 @@ build/release/synth   # run the release build
 
 The application will open a window with the synthesizer GUI.
 
+## MIDI CC Control Mapping
+
+This synthesizer supports comprehensive MIDI CC (Continuous Controller) mapping for real-time parameter control. All MIDI CC messages are automatically scaled from MIDI range (0-127) to the appropriate parameter ranges.
+
+### Oscillator Parameters (CC 0-60)
+
+**Oscillator 1 (CC 0-7)**
+- CC 0: Pitch (-24.0 to +24.0 semitones)
+- CC 1: Detune (-1.0 to +1.0 cents)
+- CC 2: Gain (0.0 to 1.0)
+- CC 3: Phase (0.0 to 1.0)
+- CC 4: Waveform (0=SINE, 1=SAW, 2=SQUARE, 3=TRI, 4=NOISE)
+- CC 5: Pulse Width (0.0 to 1.0)
+- CC 6: Unison Voices (1 to 8 voices)
+- CC 7: Unison Detune (0.0 to 1.0)
+
+**Oscillator 2 (CC 8-15)**
+- CC 8: Pitch (-24.0 to +24.0 semitones)
+- CC 9: Detune (-1.0 to +1.0 cents)
+- CC 10: Gain (0.0 to 1.0)
+- CC 11: Phase (0.0 to 1.0)
+- CC 12: Waveform (0=SINE, 1=SAW, 2=SQUARE, 3=TRI, 4=NOISE)
+- CC 13: Pulse Width (0.0 to 1.0)
+- CC 14: Unison Voices (1 to 8 voices)
+- CC 15: Unison Detune (0.0 to 1.0)
+
+**Oscillator 3 (CC 16-23)**
+- CC 16: Pitch (-24.0 to +24.0 semitones)
+- CC 17: Detune (-1.0 to +1.0 cents)
+- CC 18: Gain (0.0 to 1.0)
+- CC 19: Phase (0.0 to 1.0)
+- CC 20: Waveform (0=SINE, 1=SAW, 2=SQUARE, 3=TRI, 4=NOISE)
+- CC 21: Pulse Width (0.0 to 1.0)
+- CC 22: Unison Voices (1 to 8 voices)
+- CC 23: Unison Detune (0.0 to 1.0)
+
+**Oscillator 4 (CC 24-31)**
+- CC 24: Pitch (-24.0 to +24.0 semitones)
+- CC 25: Detune (-1.0 to +1.0 cents)
+- CC 26: Gain (0.0 to 1.0)
+- CC 27: Phase (0.0 to 1.0)
+- CC 28: Waveform (0=SINE, 1=SAW, 2=SQUARE, 3=TRI, 4=NOISE)
+- CC 29: Pulse Width (0.0 to 1.0)
+- CC 30: Unison Voices (1 to 8 voices)
+- CC 31: Unison Detune (0.0 to 1.0)
+
+**Oscillator 5 - Bass (CC 53-60)**
+- CC 53: Pitch (-24.0 to +24.0 semitones)
+- CC 54: Detune (-1.0 to +1.0 cents)
+- CC 55: Gain (0.0 to 1.0)
+- CC 56: Phase (0.0 to 1.0)
+- CC 57: Waveform (0=SINE, 1=SAW, 2=SQUARE, 3=TRI, 4=NOISE)
+- CC 58: Pulse Width (0.0 to 1.0)
+- CC 59: Unison Voices (1 to 8 voices)
+- CC 60: Unison Detune (0.0 to 1.0)
+
+**Oscillator 6 - Percussion (CC 61-68)**
+- CC 61: Pitch (-24.0 to +24.0 semitones)
+- CC 62: Detune (-1.0 to +1.0 cents)
+- CC 63: Gain (0.0 to 1.0)
+- CC 64: Phase (0.0 to 1.0)
+- CC 65: Waveform (0=SINE, 1=SAW, 2=SQUARE, 3=TRI, 4=NOISE)
+- CC 66: Pulse Width (0.0 to 1.0)
+- CC 67: Unison Voices (1 to 8 voices)
+- CC 68: Unison Detune (0.0 to 1.0)
+
+### Mixer Parameters (CC 69-88)
+
+**Individual Oscillator Gains (CC 77-82)**
+- CC 77: OSC 1 Gain (0.0 to 1.0)
+- CC 78: OSC 2 Gain (0.0 to 1.0)
+- CC 79: OSC 3 Gain (0.0 to 1.0)
+- CC 80: OSC 4 Gain (0.0 to 1.0)
+- CC 81: OSC 5 Gain (0.0 to 1.0)
+- CC 82: OSC 6 Gain (0.0 to 1.0)
+
+**Master Mixer Controls (CC 83-88)**
+- CC 83: Master Volume (0.0 to 2.0)
+- CC 84: Compressor Threshold (-24.0 to 0.0 dB)
+- CC 85: Compressor Ratio (1.0 to 10.0:1)
+- CC 86: Compressor Attack (1.0 to 100.0 ms)
+- CC 87: Compressor Release (10.0 to 1000.0 ms)
+- CC 88: Compressor Makeup Gain (0.0 to 12.0 dB)
+
+### Arpeggiator Parameters (CC 89-94)
+
+- CC 89: Tempo (60.0 to 240.0 BPM)
+- CC 90: Enable/Disable (0=OFF, 1=ON)
+- CC 91: Mode (0=OFF, 1=CHORD, 2=UP, 3=DOWN, 4=UP/DOWN, 5=PENDULUM, 6=CONVERGE, 7=DIVERGE, 8=LEAPFROG, 9=THUMB-UP, 10=THUMB-DOWN, 11=PINKY-UP, 12=PINKY-DOWN, 13=REPEAT, 14=RANDOM, 15=RANDOM WALK, 16=SHUFFLE, 17=ORDER)
+- CC 92: Hold Function (0=OFF, 1=ON)
+- CC 93: Base Octave (0 to 4 octaves above played note)
+- CC 94: Octaves Spread (1 to 6 octaves of arpeggiated output)
+
+### Effects Parameters (CC 69-76)
+
+**Flanger Effects**
+- CC 72: Flanger Depth (0.0 to 1.0)
+- CC 73: Flanger Rate (0.0 to 5.0 Hz)
+- CC 74: Flanger Feedback (0.0 to 1.0)
+
+**Delay Effects**
+- CC 69: Delay Mix (0.0 to 1.0)
+- CC 70: Delay Feedback (0.0 to 1.0)
+- CC 71: Delay Time (0.0 to 1.0 seconds)
+
+**Reverb Effects**
+- CC 75: Reverb Size (0.0 to 1.0)
+- CC 76: Reverb Mix (0.0 to 1.0)
+
+## MIDI Implementation Details
+
+- **MIDI Channel**: Omnitone reception on all channels (1-16)
+- **Velocity Sensitivity**: Note velocity maps to amplitude (0/127 = silent, 127/127 = maximum)
+- **CC Resolution**: 7-bit MIDI CC scaled to float parameter ranges
+- **Real-time Response**: All parameter changes are applied immediately
+- **Preset Compatibility**: All MIDI CC mappings work with saved/loaded presets
+
+## Usage Examples
+
+### Basic Performance Setup
+```
+MIDI Controller → CC Mapping
+Modulation Wheel → CC 1 (OSC 1 Detune)
+Expression Pedal → CC 2 (OSC 1 Gain)
+Sustain Pedal → CC 92 (Arpeggiator Hold)
+Foot Controller 1 → CC 83 (Master Volume)
+Foot Controller 2 → CC 89 (Arpeggiator Tempo)
+```
+
+### Studio Production Workflow
+```
+Track 1 (Lead): CC 8-15  → OSC 2 controls
+Track 2 (Bass):  CC 53-60 → OSC 5 controls  
+Track 3 (Pads):  CC 24-31  → OSC 3 controls
+Track 4 (FX):    CC 69-76 → Effects automation
+Track 5 (Mix):    CC 77-88 → Mixer levels and dynamics
+```
+
+### Live Performance Control
+```
+Hands-free control: Assign commonly used parameters to accessible CC numbers
+Filter sweeps:     Map filter cutoff to CC for real-time sweeps
+Dynamic effects:   Use CC 69-76 for effect parameter automation
+Layer mixing:     Use individual OSC gain CCs for live mixing
+```
+
+This comprehensive MIDI CC implementation provides studio-level control over all synthesizer parameters, enabling both live performance and production automation workflows.
+
 ## Notes
 
 - MIDI input is mapped to numerous parameters (see `src/midi.c` for mapping).