Dystopian Waves Logo
DYSTOPIAN WAVES AUDIO ARCHITECTURE
WAVENGINE PRO
โ† BACK TO HOME
๐ŸŽน Aโ€“K TO PLAY

WAVENGINE PRO

COMPLETE OPERATIONAL REFERENCE & WORKFLOW MANUAL

0. Quick Start Workflows

WavEngine Pro gives you two primary approaches to building wavetables from scratch: **Hand-Sculpted Vector Morphing** or **Algorithmic Batch Automation**.

Workflow A: Hand-Sculpted Morphing

  1. Switch to **Curve Node Editor** (second button from the left on the canvas top bar).
  2. Ensure you are at **Index 0** using the bottom *Active Frame* slider.
  3. Use the **Point Node Tool** or **Freehand Tool** to draw your fundamental starting waveform. Adjust tension or apply DSP modifiers until satisfied.
  4. Click the **Fill Morph (Flask)** icon once in the top canvas toolbar. The indicator begins flashing red, locking Index 0 as your starting keyframe.
  5. Move the **Active Frame** slider to your destination index (e.g., the last index: 15, 63, or 255).
  6. Sculpt your ending waveform (e.g., add high harmonic spikes, wavefold it, or load a preset shape).
  7. Click **Fill Morph (Flask)** again. The engine calculates seamless intermediate transitions across every frame between your start and end points using the selected interpolation algorithm.
  8. Test the sweep using the **MORPH SWEEP** button in the header, then click **๐Ÿ’พ Export .WAV**.

Workflow B: Fully Automated Batch Generation

  1. Choose how dense you want your transitions to be by setting the **Random Batch Step** badge (e.g., 32).
  2. Click **๐ŸŽฒ Roll Random Wave**. The engine procedurally creates diverse algorithmic shapes at every 32nd frame (Index 0, 32, 64, 96...).
  3. Set the **Fill Batch Step** badge to the same interval (32), then click **Fill Morph**. The engine automatically bridges all intervals in sequence.
  4. 1-Click Shortcut: Set your batch step interval and click the **โšก Auto Gen & Fill** lightning bolt icon. The engine generates all keyframes and morphs the entire bank in a single operation.

1. Curve Node Editor (Drawing & Node Creation)

To enter vector drawing mode, click the **Curve Node Editor** button (the second icon from the left in the canvas top panel, depicting an angled vector line). When active, 9 editing and transformation tools appear in the center of the control bar.

Drawing Tools

  • Point Node Tool (1st middle icon): The precision vector pen tool.
    • Add Nodes: Click anywhere on the grid canvas to insert a new control node. The curve automatically links between neighboring nodes.
    • Move Nodes: Click and drag any node freely in both horizontal (time/phase) and vertical (amplitude) axes. The boundary points at $X=0.0$ and $X=1.0$ remain anchored horizontally to preserve loop phase coherency.
    • Delete Nodes: Double-click any interior node to remove it. (Interior points can also be deleted by right-clicking if enabled).
    • Curvature Easing (Ctrl + Drag on Node): Holding Ctrl (or Cmd on macOS) while dragging a node vertically modifies its mathematical interpolation curve between linear ramp and smooth cosine easing.
    • Segment Bowing (Ctrl + Drag on Segment): Hover over any line segment between two nodes, hold Ctrl, and drag. Dragging **vertically** adds peak arc/bow tension (upward or downward bow). Dragging **horizontally** shifts the arc's center of gravity left or right, creating complex asymmetrical parabolic curves.
  • Freehand Sketch Tool (2nd middle icon): Lets you draw continuous waveforms directly onto the screen.
    • Click and drag horizontally from left to right across the canvas. A live preview line traces your cursor.
    • Upon mouse release, the built-in **Ramer-Douglas-Peucker (RDP)** simplification algorithm analyzes your stroke, strips redundant samples, and generates a minimal set of clean bezier curve nodes.
    • If you start or end your stroke near existing points on the wave, the sketch automatically snaps into the existing waveform segment.

2. Select & Transform (Bounding Tools & Sliders)

Click the **Select & Transform Tool** (the 3rd middle icon, depicting a dashed selection square). In this mode, clicking and dragging on the canvas creates a marquee box to isolate nodes. Three physical sliding handles appear around the perimeter of the canvas:

  • Selection Marquee: Drag a box over any cluster of points. Selected nodes highlight in orange. You can click and drag any highlighted node to translate the entire selection block as a group in time ($X$) and amplitude ($Y$).
  • Left Vertical Slider (Depth Factor): Scales the vertical amplitude headroom of either the selected nodes or the entire waveform (if nothing is selected).
    • Pulling down attenuates the waveform down to 0% (silence).
    • Pushing up scales amplitude up to 200% overdrive into saturation.
  • Right Vertical Slider (Curvature Shaper): Bends all selected line segments simultaneously.
    • Moving the slider upward forces segments into exponential convex curves (softening the harmonics).
    • Moving downward pulls segments into sharp, aggressive logarithmic shapes (sharpening transients and punch).
  • Bottom Horizontal Slider (Time Stretch / Compress): Squeezes or stretches the selected node cluster horizontally across the timeline.
    • Drag left to compress the segment into a narrow pulse or transient strike.
    • Drag right to expand the segment, pushing adjacent nodes outward while keeping overall frame boundaries normalized.

3. Modifier Rack (Real-Time DSP Suite)

Click the **Modifier Rack Tool** (the 4th middle icon, depicting a target dial). This opens the real-time DSP manipulation environment, introducing **Left and Right vertical faders** on either side of the canvas and **7 DSP mode buttons** along the bottom edge. Adjusting handles renders immediate sample changes with live audio preview.

ModeDescriptionLeft Handle FunctionRight Handle Function
Hann / Wiggle Window Cosine-tapered windowing curve that forces the waveform edges smoothly down to zero to eliminate audio pop clicks. Left boundary crop / taper width. Right boundary crop / taper width.
Square Window Square-root envelope windowing. Produces aggressive curve attenuation at the boundaries while preserving center volume. Left square-taper envelope. Right square-taper envelope.
Linear Window Applies a straight ramp taper from the boundaries inward, yielding a triangular envelope crop. Left linear ramp length. Right linear ramp length.
Hard Rect Window Brickwall gate clipping. Immediately zeroes out all samples falling outside the left and right boundary thresholds. Left brickwall cutoff boundary. Right brickwall cutoff boundary.
Harmonic Wavefolder Buchla-style multi-stage wavefolding. When samples exceed 0 dB, they reflect back inward, introducing rich, metallic upper harmonics. DC Bias / Asymmetry offset (shifts where the folds occur). Fold Drive / Gain (increases the number of reflective harmonic folds).
Nonlinear Warper Dual-axis power warping that nonlinearly bends the phase time axis and amplitude power response. $X$-Axis Phase Warp (skews waveform energy toward start or end). $Y$-Axis Amplitude Warp (applies exponential/logarithmic transfer).
Mirror & Bit Quantize Lo-Fi digital degradation combining bilateral horizontal reflection with digital bit-depth reduction. Mirror blend amount (folds right half onto left half). Bit crush / Quantization step reduction (from 64 steps down to 2-step 1-bit square).

Note: When you switch tools or change modes, modified sample states automatically bake back into node points for continued editing.

4. Canvas Utility & Clipboard Tools

Located immediately to the right of the editing tools in the Curve Node view:

  • Invert Phase (Y) [Vertical Arrows]: Flips the polarity of all control points upside down ($+1.0 \leftrightarrow -1.0$). Reverses curve and bow directions accordingly.
  • Reverse Time (X) [Horizontal Arrows]: Reverses the shape horizontally from end to start, creating retrograde waveforms without altering harmonic spectrum balance.
  • Copy / Paste [Double Squares]: If a marquee selection is active, copies only the selected node subset. If nothing is selected, copies the entire waveform shape. Click again on another wavetable frame to paste with automatic time-scale fitting.
  • Clear Frame [Crosshairs / X]: Resets the active frame back to a flat zero line, leaving boundary anchors intact.
  • Grid Snapping [Grid Square]: Cycles through 4 display & snap modes: Off → X-Grid (16 horizontal divisions) → Y-Grid (10 vertical amplitude divisions) → Full Grid.

5. Bank View & Audio DSP Tools

Click the **Wavetable Bank View** button (the very first icon on the left, displaying an audio waveform). In this mode, manual node manipulation is disabled so you can inspect pure rendered PCM audio data.

16-Frame Overview Mode

Click the **Grid Overview** icon (first icon in the center group). Instead of rendering only the active frame, the canvas splits into a multi-frame display showing 16 consecutive wavetable frames simultaneously side-by-side. The currently active frame is highlighted in translucent orange. Use the bottom dock's **Overview Page** stepper to page through blocks of 16 frames (Page 0 = 0โ€“15, Page 1 = 16โ€“31, etc.).

Batch Audio DSP Tools

These operations apply destructive audio cleanup across the frame range defined by the bottom dock's **Scope (From → To)** fields:

  • DC Offset Removal [Icon with offset line]: Calculates the average DC bias across every frame in the scope range and subtracts it. This centers the waveform vertically on 0.0, preventing clicks, asymmetric headroom loss, and low-frequency thumps in hardware amplifiers.
  • Peak Normalization (0 dB) [Icon with vertical arrows]: Scans all frames in the scope range for their absolute peak amplitude, determines the required headroom multiplier, and normalizes the audio to full digital scale ($\pm 1.0$) without clipping.
  • Anti-Aliasing Filter [Curved wave icon]: Applies a smoothing filter over steep sample transitions to suppress foldback frequencies above the Nyquist limit ($f_s / 2$), eliminating harsh digital aliasing during high-frequency note playback.

6. Procedural Generation & Fill Morph Engine

The right side of the canvas top bar houses the procedural synthesis and automatic interpolation engine.

Fill Morph System

  • Fill Batch Step Badge [Number Box: 1, 8, 16, 32, 64]: Defines the stride interval used when batch-interpolating frames.
    • 1: Pairwise manual mode. You manually choose a Start Frame and an End Frame.
    • 8 / 16 / 32 / 64: Batch mode. When clicked, the engine automatically assumes keyframes exist at every $N$th interval (e.g., 0, 32, 64...) and computes fills across every segment automatically.
  • Fill Morph Button [Flask Icon]: Initiates the fill process. In Step 1 mode, click once to mark the origin frame, navigate to the target frame, and click again to calculate transitions.
  • Interpolation Algorithms (Set via Bottom Dock):
    • Linear Crossfade: Uniform amplitude crossfade across frames.
    • Ease-In (Exp): Slow morphological evolution near the start, accelerating toward the end.
    • Ease-Out: Rapid initial change, slowing down as it reaches the destination frame.
    • Ease-In-Out: S-curve transition; slowest movement at extremes, fastest in the center.
    • Vector Path: Resamples curves into matching node counts and morphs control vertices directly across Euclidean space rather than blending raw audio samples.

Procedural Random Roll System

  • Random Batch Step Badge [Number Box: 1, 8, 16, 32, 64]:
    • 1: Generates a single algorithmic shape on the active frame only.
    • 8 / 16 / 32 / 64: Generates new procedural keyframes across the bank spaced at intervals of $N$ frames, preparing the wavetable for immediate batch filling.
  • Roll Random Wave [Dice Icon]: Procedurally generates a waveform using combinations of sine harmonics, fractal midpoint displacement noise, Chebyshev polynomials, wavefolding, and phase distortion.
  • Category Constraint (Set via Bottom Dock): The **Random Roll** dropdown in the bottom dock lets you constrain the random generator to a specific harmonic family (e.g., purely `Saw`, `Formant`, `Sinc`, or `Half Rect Sine`), or leave it on `Any (Wild)` for chaotic synthesis.

Auto Gen & Fill [โšก Lightning Bolt]

The master macro button. Reads your active batch step interval, procedural generator constraints, and fill algorithm, then generates all keyframes and morphs all intermediate frames in a single calculation.

Bank Frame Count Badge [e.g., "256 WTs"]

Located on the far right of the canvas bar. Click to cycle the active wavetable capacity through supported synthesizer sizes: 16, 32, 64, 100, 128, 256 (Serum/Vital standard), 512, or SCW (Single-Cycle Waveform, 1 frame).

7. Header Audition Station & File Management

The top application header houses real-time synthesis monitoring and file I/O controls.

Audition Controls

  • โ–ถ AUDITION: Toggles a continuous drone oscillator playing the active wavetable frame. Turning it on turns the button pink/red (โน STOP). Edits on the canvas update the audio drone in real time.
  • PITCH: Selects the fundamental frequency for the audition drone: A1 (55 Hz), C2 (65 Hz), A2 (110 Hz), C3 (131 Hz), A3 (220 Hz), or C4 (262 Hz).
  • MORPH SWEEP [SWEEP: OFF / ON]: Automates wavetable position scanning. When engaged, the engine scrubs back and forth continuously through your wavetable frames at 60 ms intervals, letting you hear your morphing trajectories.
  • VOL: Master audition volume slider with logarithmic gain taper.
  • Chromatic Keyboard Typing: When the manual dialog is closed, play notes polyphonically using your computer keyboard:
    A=C4, W=C#4, S=D4, E=D#4, D=E4, F=F4, T=F#4, G=G4, Y=G#4, H=A4, U=A#4, J=B4, K=C5, O=C#5, L=D5.

File & Buffer Management (Top Right)

  • ๐Ÿงน Clear All: Zeroes out every frame across the entire wavetable bank in memory.
  • ๐Ÿ“ฅ Import WAV: Loads any standard mono or stereo audio file via Web Audio decoding and maps it into the current wavetable bank.
  • ๐Ÿ’พ Export .WAV: Generates a broadcast-quality RIFF WAV file formatted specifically for software synthesizers and hardware samplers.

8. Bottom Dock & Export Specification

The bottom panel configures audio resolution, morphing parameters, and scope boundaries.

  • Audio Format Group:
    • Frame Size: Sets the sample resolution per single cycle: 512, 1024, 2048 (industry standard for Serum and Vital), or 4096 samples.
    • Bit Depth: Sets export quantization to 16-bit PCM, 24-bit PCM, or 32-bit Float (maximum dynamic range without digital clipping).
    • Sample Rate: Writes the master sample rate into the WAV header: 44.1 kHz, 48.0 kHz, or 96.0 kHz.
  • Batch Scope & View Group:
    • Scope (From → To): Number inputs setting the start and end frame indices affected by DC Removal, Peak Normalization, and Anti-Aliasing.
    • Overview Page: Chooses which block of 16 frames is rendered when in 16-Frame Overview mode.
  • WT Position Index (Center Dock):
    • Scrub the large slider or type directly into the number box to navigate to any wavetable frame index (from 0 up to your bank maximum).
    • The canvas immediately updates to display that frame's curve nodes and sample data, and the live audition synthesizer re-syncs instantly.
  • Generator Preset Suite (Bottom Right):
    • Shape Preset Dropdown: Provides mathematical archetypes: Sine, Saw, Triangle, Square, Sinc (ideal for band-limited impulses), Half/Full Rectified Sine, Pulse (narrow width), Super Saw (7 detuned unison saw oscillators), Formant (vocal vowels), S&H Steps, and Noise.
    • Apply Button: Immediately replaces the active frame's geometry with the selected archetype.