F_DRAWWAVE

F_DRAWWAVE — Draw Your Own Oscillator

Description:
F_DRAWWAVE is a versatile drawable wavetable oscillator that lets you sketch and sculpt your own waveforms on a high-resolution canvas. Your custom waveform plays in real-time and follows pitch CV (1V/oct).
Ideal for sound designers, experimental synthesis, and educational use.

Usage:
• Connect a 1V/oct pitch CV to the top-left input jack
• Connect the output jack to hear your waveform
• Draw on the canvas using your mouse:
– Left-click + drag: draw waveform
– Right-click + drag: erase to zero
– Shift + Left-drag: draw horizontal line segment

Canvas & Drawing:
• Real-time waveform visualization
• Smooth interpolation between points
• 1024-sample resolution (looped)
• Right-click erasing
• Shift for straight horizontal strokes
• Optional region selection using draggable handles

Edit Functions:
Clicking an edit button applies it to the selection (or full waveform if no selection).

Immediate (non-parameterized):
• INVERT: INV Flip vertically (negate)
• RECTIFY: RCT Make all values positive
• NORMALIZE: NRM Rescale to max ±1.0
• FLATTEN: FLT Set region to average value
• MIRROR: MIR Flip horizontally (left↔right)
• NOISEFILL: NSE Replace with random values
• REPEAT: RPT Duplicate selection once

Parameter-based (use knob + button):
• BOOST: BST Amplify waveform
• ATTENUATE: ATT Reduce amplitude
• LIMIT: LIM Hard clip at ±threshold
• FOLD: FLD Reflect values beyond threshold
• SMOOTH: SMT Low-pass style softening
• BEND: BND Shape curve via nonlinearity
• BLUR: BLR Moving average smoothing
• EMPHASIS: EMP Add harmonic content
• JITTER: JIT Small random variation
• QUANTIZE: QNT Snap to value steps
• STRETCH: STR Interpolate and expand selection

Controls:
Canvas: Draw or erase waveform
Clear: Reset waveform to silence
Undo: Revert last waveform change
Preset Selector: Load built-in waveforms
Transpose / Fine Tune: Shift pitch
Sync In: Retrigger phase
Scale: Adjust vertical display scaling
Select: Enable waveform region selection

Presets:
0 = None (flat)
1 = Sine
2 = Saw
3 = Triangle
4 = Square
5 = Stairs
6 = Random
7 = Pulse (10%)
8 = Half-Sine
9 = Spike
10 = Even Harmonics
11 = Bent Saw
12 = Sine Folded
13 = Clipped Sine
14 = Windowed Pulse
15 = Parabola
16 = Broken Line
17 = Double Sine
-1 = Custom (auto-set when you draw)

Saving & Reloading:
• Preset index and waveform are stored in the patch
• On reload, either preset or custom waveform is restored
• Custom waveforms are saved as 1024 floats

Undo:
• Press Undo to cancel the last edit
• Currently supports single-step undo

Tips:
• Use Smooth after drawing to clean up jagged lines
• Combine Mirror + Invert for symmetry
• Boost or Fold adds character to soft waves
• Use short strokes for precision
• Jitter or Quantize to add chaos or digital artifacts

Planned Features:
• Save/load custom waveform presets
• Morphing between two shapes
• Import/export waveform data (.wav/.csv)
• LFO mode / Audio toggle
• Grid overlays and zoom
• Multi-level Undo

-- at the moment there seems to be a glitch in handling cables moving over a canvas, where the screen distorts... question lies with Cherry