Ondakit Logo

String Voice

SourcesstringvoiceHeavy CPU

Extended Karplus-Strong — plucked / bowed string tones.

What it does

Extended Karplus-Strong string voice (Rings flavour).

Wraps daisysp::StringVoice. A file-scope prev_trig snapshot detects rising edges; each edge is passed into Process(bool trigger) to pluck the string. Accent + Sustain are baked at init.

Parameters

  • Structure

    structure
    Default 0.1Range 0 … 1

    Selects what kind of string is being modelled. The bottom of the range, up to roughly a quarter, models a curved bridge, which gives the plummy quality of a struck or damped string; above that the parameter introduces dispersion, spreading the harmonics slightly out of tune with each other the way a stiff or thick string does. That upper region is what makes it sound like a piano or a heavy gauge rather than a nylon line.

  • Brightness

    brightness
    Default 0.5Range 0 … 1

    How much high-frequency content is in the pluck and how much survives each pass around the string. Low values are a soft fingertip near the fretboard; high values are a pick close to the bridge, with the bite that implies. It changes the attack most, though unlike Damping it also affects how the tone dulls as the note rings out.

  • Damping

    damping
    Default 0.5Range 0 … 1

    How much energy the string loses on each pass, which sets how long a note sustains. Low values are heavily muted, closer to a palm-muted or dead note; high values ring on and on. This is the difference between a percussive pluck and a sustained instrument, and it interacts with pitch — low notes naturally ring longer than high ones at the same setting.

  • Accent

    accent
    Default 0.5Range 0 … 1

    How hard the string is plucked, scaling the energy of the excitation. As on a real instrument a harder pluck is brighter as well as louder, so this affects timbre and not only level. ⚠ Baked at build time, so it is one fixed pluck strength for the whole patch rather than something velocity can vary.

  • Sustain (bowed)

    sustain
    Default false

    Replaces the single pluck with continuous noise excitation, which turns the string from plucked to bowed: it sounds continuously instead of decaying after each trigger. ⚠ Baked at build time. With this on the tile behaves as a drone source, and Trig stops being the thing that starts a note.

Wire a pad/gate to Trig — each rising edge plucks the string once. Structure picks the string type (0–.26 curved bridge, .26–1 dispersion), Brightness opens the tone, Damping sets sustain length. Freq / Structure / Brightness / Damping accept Mod sources; Accent + Sustain bake at boot. Sustain swaps the pluck for continuous noise excitation (a bowed drone).

Ports

In

  • Trig trigger
  • Freq frequency
  • Structure structure
  • Bright brightness
  • Damping damping

Out

  • Audio Out output

Audio Control

Inputs

Trig
Rising edge plucks the string.
Freq
String root frequency (Hz).
Structure
String type / nonlinearity, 0 → 1.
Bright
Brightness, 0 → 1.
Damping
Decay time, 0 → 1.

Outputs

Audio Out
String voice output.

Rules and gotchas

  • Accent + Sustain are baked at build time.