Flesh out the preset library #97

Open
opened 2026-09-22 20:49:27 +00:00 by bcox · 20 comments
Owner

The bank needs a browse vocabulary before it needs more patches. This issue
holds the schema; the patches themselves get brainstormed into it as
follow-up comments.

Shape

Every patch carries exactly one primary category from a fixed,
opinionated list, plus open secondary tags. The primary category is what
a person browses when they know the part they need to play; the tags are
everything else — source family, material, character, motion, articulation,
expression, era — and they are free-form with a suggested vocabulary rather
than a closed set.

Primary categories

Ordered by role, not alphabet: pitched-melodic, then sustained-ensemble,
then rhythmic, then non-pitched, then utility. The order is part of the
schema — alphabetizing puts Abstract first and Voice last, which is
browse-hostile and makes a deliberate list look arbitrary.

# Category Holds Not
0 Unspecified — reserved; see growth rules
1 Bass sub, synth, reese, upright, bass guitar anything played above C3
2 Lead mono and poly melody voices, screamers plucks — the envelope decides
3 Pluck guitar, harp, koto, kalimba, synth plucks struck things
4 Keys piano, EP, clav, organ, harpsichord mallets
5 Mallets marimba, vibes, bells, glass, steel drum untuned struck things
6 Pad sustained chordal beds, warm to glassy to ominous anything with a bow in its story
7 Strings the violin family, solo and ensemble, whatever the hand is doing pads that merely sound stringy
8 Winds brass, reeds, flutes — everything blown
9 Voice choirs, solo vocal, formant and vowel models
10 Drums kick, snare, tom, clap — membrane and skin metal
11 Cymbals hats, rides, crashes, gongs, bells-as-percussion pitched bells, which are Mallets
12 Percussion hand drums, blocks, shakers, clicks
13 Atmosphere drones, beds, room tone, evolving non-melodic
14 Nature & Environment wind, water, rain, fire, insects, birds, and machines — vehicles, engines, working equipment beds that would sound the same whatever you played, which are Atmosphere
15 Hits & Risers risers, impacts, downlifters, transitions, stingers anything that processes an input
16 Abstract deliberately unplaceable sound design
17 Utility sine, saw at known level, pink noise, impulse
18 Effects reverbs, delays, modulation, saturation, resonators, granular and spectral processors one-shot sweeteners, which are Hits & Risers

Utility is in the list a person sees, not a developer-only value: someone
building their own reference and test patches needs the same home.

Effects is the one category whose patches process an input rather than
respond to notes, which makes it the only one gated on work not yet done:
effects are layer engines with load-time-reserved storage, insert placement
is still open, and a channel that takes audio in is not built. The category
is named now so the schema does not have to grow for it later. Its signature
members are the ones only this engine can offer — a modal plate or a
waveguide string excited by the input rather than by a note.

Naming: the category that holds risers and impacts is Hits & Risers
rather than FX, because FX and Effects one row apart would be two
true answers for a reverb.

Two rulings the table encodes:

  • Bells sit in two rows on purpose. A tubular bell you play a melody on
    is Mallets; a bell you strike once for color is Cymbals. The test is
    whether pitch is load-bearing. It is a test about metal and it does not
    reach into Drums: a timpani is a membrane drum that gets tuned, and it
    stays in Drums. Drums and Percussion are told apart by instrument
    family instead — the kit and its skins on one side, everything else
    struck, shaken or scraped on the other.
  • Sequence/arp is not a category. A patch whose interest is a rhythm is
    a patch plus a part, and the part belongs in the song. rhythmic is a
    secondary tag instead.
  • Category follows role, not signal path. The worked example is the
    808: its bass drum is a decaying sine with a pitch blip, so 808 Bass
    and 808 Kick are one synthesis voice with two jobs — tuned and held
    long, or tuned low and let go. Two patches, two categories. The same rule
    puts a bowed double bass in Bass when it is playing the bass line and
    in Strings when it is not.
  • An instrument-shaped patch goes to its instrument's category. This
    bounds the rule above rather than contradicting it. Lead is the only
    category named after a job in the arrangement, and every instrument plays
    the top line sometimes; if "plays the melody" decided it, Winds, Keys
    and Pluck would empty into Lead. So a modeled flute is Winds
    whatever part it plays, and a supersaw is Lead because there is nothing
    else it is. The 808 case is one voice with two jobs; this is one job with
    many instruments. Bass avoids the problem by being bounded by register,
    which is what lets an upright sit there.
  • Articulation does not move a patch. A pizzicato violin is a violin, so
    it is Strings and not Pluck — which is why row 7 reads "whatever the
    hand is doing" rather than "bowed". Pluck holds the instruments that are
    only ever plucked. Upright Pizz stays in Bass under the register rule.
  • Machines are environment. A helicopter, a passing car or an idling
    engine is not weather and not an instrument, and row 14 holds it — which
    is why that row is Nature & Environment rather than Nature. The bed a
    machine makes, a room of humming equipment, is still Atmosphere, under
    the same test that separates a pad from a drone: an object you hear is
    environment, a texture that would sound the same whatever you played is
    atmosphere.

Also merged away deliberately: brass and reeds into Winds (both blown,
both waveguide tubes, and either alone would hold three patches — brass,
reed, flute carry the distinction as tags); comps into Keys ("comp"
describes how you play, not what it is). Era is deliberately absent — real
as a tag, poison as a category, because "80s digital pad" forces a choice
between two true answers.

Secondary tags

Free-form, several per patch. Two are wanted on the factory bank from the
start and are the reason this issue names tags at all:

  • factory — shipped in the bank. Replaces any notion of a Factory
    category, and keeps "where did this come from" orthogonal to "what is it".
  • demo — there to show the instrument off rather than to be played in
    someone's song. An honest label; a bank that hides these wastes the
    person's time, and one that pretends they are workhorses wastes their
    trust.

Suggested vocabulary for the rest, not enforced: source family (additive,
fm, va, waveguide, modal, sample, hybrid), material (string,
bar, membrane, plate, tube, air), character (clean, gritty,
noisy, metallic, wooden, glassy, vocal, hollow, breathy),
motion (static, drifting, rhythmic, chaotic), articulation
(plucked, struck, bowed, blown, sustained), expression
(velocity, aftertouch, mpe, macro), and era where it helps.

Source family and material are close to free: the patch data already knows
both, so they can be derived rather than authored.

Format consequences

The category is user-visible metadata a user's own save writes, so it is
part of the compatibility promise from its first release, not advisory
factory decoration.

  • Reserve 0 = Unspecified. A reader that meets a value it does not know
    maps it to 0 and carries on. It never refuses the patch: a category is a
    browse hint, and refusing a whole patch over one would be the reader
    treating its input as hostile in the wrong place.
  • Growth is a minor bump, never a renumber. Once a value ships its
    meaning is frozen. Merging two categories later leaves the merged-away
    value reserved and unused forever.
  • The discipline starts now rather than at the first user save. Factory
    patches are Bazel targets with no saved corpus, so renumbering is free
    today — and stops being free the moment anyone saves a patch.

Next

Brainstorm the bank itself into this issue: what patches each category
should hold, which are demo and which are workhorses, and where the
current bank is thin.

The bank needs a browse vocabulary before it needs more patches. This issue holds the schema; the patches themselves get brainstormed into it as follow-up comments. ## Shape Every patch carries **exactly one primary category** from a fixed, opinionated list, plus **open secondary tags**. The primary category is what a person browses when they know the part they need to play; the tags are everything else — source family, material, character, motion, articulation, expression, era — and they are free-form with a suggested vocabulary rather than a closed set. ## Primary categories Ordered by role, not alphabet: pitched-melodic, then sustained-ensemble, then rhythmic, then non-pitched, then utility. The order is part of the schema — alphabetizing puts `Abstract` first and `Voice` last, which is browse-hostile and makes a deliberate list look arbitrary. | # | Category | Holds | Not | |---|---|---|---| | 0 | *Unspecified* | — | reserved; see growth rules | | 1 | Bass | sub, synth, reese, upright, bass guitar | anything played above C3 | | 2 | Lead | mono and poly melody voices, screamers | plucks — the envelope decides | | 3 | Pluck | guitar, harp, koto, kalimba, synth plucks | struck things | | 4 | Keys | piano, EP, clav, organ, harpsichord | mallets | | 5 | Mallets | marimba, vibes, bells, glass, steel drum | untuned struck things | | 6 | Pad | sustained chordal beds, warm to glassy to ominous | anything with a bow in its story | | 7 | Strings | the violin family, solo and ensemble, whatever the hand is doing | pads that merely sound stringy | | 8 | Winds | brass, reeds, flutes — everything blown | | | 9 | Voice | choirs, solo vocal, formant and vowel models | | | 10 | Drums | kick, snare, tom, clap — membrane and skin | metal | | 11 | Cymbals | hats, rides, crashes, gongs, bells-as-percussion | pitched bells, which are Mallets | | 12 | Percussion | hand drums, blocks, shakers, clicks | | | 13 | Atmosphere | drones, beds, room tone, evolving non-melodic | | | 14 | Nature & Environment | wind, water, rain, fire, insects, birds, and machines — vehicles, engines, working equipment | beds that would sound the same whatever you played, which are Atmosphere | | 15 | Hits & Risers | risers, impacts, downlifters, transitions, stingers | anything that processes an input | | 16 | Abstract | deliberately unplaceable sound design | | | 17 | Utility | sine, saw at known level, pink noise, impulse | | | 18 | Effects | reverbs, delays, modulation, saturation, resonators, granular and spectral processors | one-shot sweeteners, which are Hits & Risers | `Utility` is in the list a person sees, not a developer-only value: someone building their own reference and test patches needs the same home. `Effects` is the one category whose patches process an input rather than respond to notes, which makes it the only one gated on work not yet done: effects are layer engines with load-time-reserved storage, insert placement is still open, and a channel that takes audio in is not built. The category is named now so the schema does not have to grow for it later. Its signature members are the ones only this engine can offer — a modal plate or a waveguide string excited by the input rather than by a note. Naming: the category that holds risers and impacts is `Hits & Risers` rather than `FX`, because `FX` and `Effects` one row apart would be two true answers for a reverb. Two rulings the table encodes: - **Bells sit in two rows on purpose.** A tubular bell you play a melody on is `Mallets`; a bell you strike once for color is `Cymbals`. The test is whether pitch is load-bearing. It is a test about metal and it does not reach into `Drums`: a timpani is a membrane drum that gets tuned, and it stays in `Drums`. `Drums` and `Percussion` are told apart by instrument family instead — the kit and its skins on one side, everything else struck, shaken or scraped on the other. - **Sequence/arp is not a category.** A patch whose interest is a rhythm is a patch plus a part, and the part belongs in the song. `rhythmic` is a secondary tag instead. - **Category follows role, not signal path.** The worked example is the 808: its bass drum is a decaying sine with a pitch blip, so `808 Bass` and `808 Kick` are one synthesis voice with two jobs — tuned and held long, or tuned low and let go. Two patches, two categories. The same rule puts a bowed double bass in `Bass` when it is playing the bass line and in `Strings` when it is not. - **An instrument-shaped patch goes to its instrument's category.** This bounds the rule above rather than contradicting it. `Lead` is the only category named after a job in the arrangement, and every instrument plays the top line sometimes; if "plays the melody" decided it, `Winds`, `Keys` and `Pluck` would empty into `Lead`. So a modeled flute is `Winds` whatever part it plays, and a supersaw is `Lead` because there is nothing else it is. The 808 case is one voice with two jobs; this is one job with many instruments. `Bass` avoids the problem by being bounded by register, which is what lets an upright sit there. - **Articulation does not move a patch.** A pizzicato violin is a violin, so it is `Strings` and not `Pluck` — which is why row 7 reads "whatever the hand is doing" rather than "bowed". `Pluck` holds the instruments that are only ever plucked. `Upright Pizz` stays in `Bass` under the register rule. - **Machines are environment.** A helicopter, a passing car or an idling engine is not weather and not an instrument, and row 14 holds it — which is why that row is `Nature & Environment` rather than `Nature`. The *bed* a machine makes, a room of humming equipment, is still `Atmosphere`, under the same test that separates a pad from a drone: an object you hear is environment, a texture that would sound the same whatever you played is atmosphere. Also merged away deliberately: brass and reeds into `Winds` (both blown, both waveguide tubes, and either alone would hold three patches — `brass`, `reed`, `flute` carry the distinction as tags); comps into `Keys` ("comp" describes how you play, not what it is). Era is deliberately absent — real as a tag, poison as a category, because "80s digital pad" forces a choice between two true answers. ## Secondary tags Free-form, several per patch. Two are wanted on the factory bank from the start and are the reason this issue names tags at all: - **`factory`** — shipped in the bank. Replaces any notion of a `Factory` category, and keeps "where did this come from" orthogonal to "what is it". - **`demo`** — there to show the instrument off rather than to be played in someone's song. An honest label; a bank that hides these wastes the person's time, and one that pretends they are workhorses wastes their trust. Suggested vocabulary for the rest, not enforced: source family (`additive`, `fm`, `va`, `waveguide`, `modal`, `sample`, `hybrid`), material (`string`, `bar`, `membrane`, `plate`, `tube`, `air`), character (`clean`, `gritty`, `noisy`, `metallic`, `wooden`, `glassy`, `vocal`, `hollow`, `breathy`), motion (`static`, `drifting`, `rhythmic`, `chaotic`), articulation (`plucked`, `struck`, `bowed`, `blown`, `sustained`), expression (`velocity`, `aftertouch`, `mpe`, `macro`), and era where it helps. Source family and material are close to free: the patch data already knows both, so they can be derived rather than authored. ## Format consequences The category is user-visible metadata a user's own save writes, so it is part of the compatibility promise from its first release, not advisory factory decoration. - **Reserve 0 = Unspecified.** A reader that meets a value it does not know maps it to 0 and carries on. It never refuses the patch: a category is a browse hint, and refusing a whole patch over one would be the reader treating its input as hostile in the wrong place. - **Growth is a minor bump, never a renumber.** Once a value ships its meaning is frozen. Merging two categories later leaves the merged-away value reserved and unused forever. - The discipline starts now rather than at the first user save. Factory patches are Bazel targets with no saved corpus, so renumbering is free *today* — and stops being free the moment anyone saves a patch. ## Next Brainstorm the bank itself into this issue: what patches each category should hold, which are `demo` and which are workhorses, and where the current bank is thin.
Author
Owner

Category 1 — Bass

Grouped by what makes each patch exist, because a bank's bass section fails
by holding eight patches that are one idea at different cutoffs.

The subtractive spine — what people reach for

Patch What it is Tags
Pure Sub sine fundamental, tiny click transient, velocity→level va clean static
808 Bass pitch blip into the fundamental, long exponential decay, glide, saturation that grows harmonics so it survives a speaker that cannot reproduce the fundamental va struck mono glide
Ladder Round ladder low-pass mono, dark and thick, no drama va warm sustained
SH-101 Saw saw + pulse, env→cutoff — exists as sh101_bass va gritty
Acid Line resonant ladder, accent and slide off velocity va rhythmic mono
PWM Bass pulse-width motion, holds up played as chords va drifting
Reese detuned saw pair into a notch, slow phase drift va gritty drifting
Sync Bass hard sync swept by the envelope va metallic
Growl filter motion driven from a lane, formant-leaning va chaotic macro

Pure Sub and 808 Bass are not the same patch. Pure Sub does what its
envelope says and exists to sit under something else; the 808 is a specific
instrument you cannot get by playing Pure Sub differently.

Reese is named for Kevin Saunderson, who recorded under that alias —
one of the Belleville Three. The timbre is credited to his 1988 track
Just Another Chance on KMS, and producers sampling it through the 90s
jungle and drum'n'bass scene named the sound after the alias on the record.
The synth is widely reported to have been a Casio CZ-5000; that attribution
is passed along here, not verified. What makes the sound is two or more
sawtooths detuned just far enough to beat, so the phase relationship keeps
sliding and the timbre moves with no LFO at all.

FM — the timbres subtractive cannot reach

Patch What it is Tags
FM Slap DX-lineage electric bass, velocity→index fm plucked velocity
Bell Bass bell attack sitting on a sine fundamental fm metallic

Waveguide and modal — the signature section

The reason this bank is not another VA bank.

Patch What it is Tags
Upright Pizz plucked waveguide string with body resonance waveguide string plucked
Bass Guitar pick or finger decided by velocity waveguide string plucked velocity
Fretless portamento into a singing sustain waveguide string mpe
Bowed Bass bowed waveguide, slow attack waveguide string bowed

Additive and hybrid — mostly demo

Patch What it is Tags
Drawbar Bass few harmonics, organ-shaped, no filter at all additive clean
Harmonic Morph partials swept live additive drifting demo
Stacked Pluck modal attack layer over a sine sub hybrid modal demo

If the section ships thin first

Pure Sub, 808 Bass, Ladder Round, SH-101 Saw, Acid Line, Reese, FM Slap,
Upright Pizz, Bass Guitar. Electronic and acoustic both covered, and all
three main engines exercised.

Gaps

No wavetable engine, so there is no wavetable-scan bass, which is a real
hole in the modern end of the list. Anything wanting chorus or drive on the
patch itself — a chorused Juno bass — waits on Effects. Neither is a
reason to hold the section.

## Category 1 — Bass Grouped by what makes each patch exist, because a bank's bass section fails by holding eight patches that are one idea at different cutoffs. ### The subtractive spine — what people reach for | Patch | What it is | Tags | |---|---|---| | Pure Sub | sine fundamental, tiny click transient, velocity→level | `va` `clean` `static` | | 808 Bass | pitch blip into the fundamental, long exponential decay, glide, saturation that grows harmonics so it survives a speaker that cannot reproduce the fundamental | `va` `struck` `mono` `glide` | | Ladder Round | ladder low-pass mono, dark and thick, no drama | `va` `warm` `sustained` | | SH-101 Saw | saw + pulse, env→cutoff — exists as `sh101_bass` | `va` `gritty` | | Acid Line | resonant ladder, accent and slide off velocity | `va` `rhythmic` `mono` | | PWM Bass | pulse-width motion, holds up played as chords | `va` `drifting` | | Reese | detuned saw pair into a notch, slow phase drift | `va` `gritty` `drifting` | | Sync Bass | hard sync swept by the envelope | `va` `metallic` | | Growl | filter motion driven from a lane, formant-leaning | `va` `chaotic` `macro` | `Pure Sub` and `808 Bass` are not the same patch. Pure Sub does what its envelope says and exists to sit under something else; the 808 is a specific instrument you cannot get by playing Pure Sub differently. **Reese** is named for Kevin Saunderson, who recorded under that alias — one of the Belleville Three. The timbre is credited to his 1988 track *Just Another Chance* on KMS, and producers sampling it through the 90s jungle and drum'n'bass scene named the sound after the alias on the record. The synth is widely reported to have been a Casio CZ-5000; that attribution is passed along here, not verified. What makes the sound is two or more sawtooths detuned just far enough to beat, so the phase relationship keeps sliding and the timbre moves with no LFO at all. ### FM — the timbres subtractive cannot reach | Patch | What it is | Tags | |---|---|---| | FM Slap | DX-lineage electric bass, velocity→index | `fm` `plucked` `velocity` | | Bell Bass | bell attack sitting on a sine fundamental | `fm` `metallic` | ### Waveguide and modal — the signature section The reason this bank is not another VA bank. | Patch | What it is | Tags | |---|---|---| | Upright Pizz | plucked waveguide string with body resonance | `waveguide` `string` `plucked` | | Bass Guitar | pick or finger decided by velocity | `waveguide` `string` `plucked` `velocity` | | Fretless | portamento into a singing sustain | `waveguide` `string` `mpe` | | Bowed Bass | bowed waveguide, slow attack | `waveguide` `string` `bowed` | ### Additive and hybrid — mostly `demo` | Patch | What it is | Tags | |---|---|---| | Drawbar Bass | few harmonics, organ-shaped, no filter at all | `additive` `clean` | | Harmonic Morph | partials swept live | `additive` `drifting` `demo` | | Stacked Pluck | modal attack layer over a sine sub | `hybrid` `modal` `demo` | ### If the section ships thin first Pure Sub, 808 Bass, Ladder Round, SH-101 Saw, Acid Line, Reese, FM Slap, Upright Pizz, Bass Guitar. Electronic and acoustic both covered, and all three main engines exercised. ### Gaps No wavetable engine, so there is no wavetable-scan bass, which is a real hole in the modern end of the list. Anything wanting chorus or drive on the patch itself — a chorused Juno bass — waits on `Effects`. Neither is a reason to hold the section.
Author
Owner

Category 2 — Lead

A ruling this category forces

Lead is named after a job, not a thing. Every instrument category is a
potential lead: a flute plays the top line, a trumpet plays the top line, a
Rhodes plays the top line. If "plays the melody" put a patch here, Winds
and Keys would empty into Lead and the taxonomy would collapse into
arrangement roles.

So: an instrument-shaped patch goes to its instrument's category. Lead
holds the melody voices that have no instrument to be.
A modeled flute is
Winds whatever part it plays; a supersaw is Lead, because there is
nothing else it is.

This does not contradict the role ruling — it bounds it. The 808 case is one
synthesis voice with two jobs; this is one job with many instruments.
Bass escapes the same problem by being bounded by register instead, which
is why an upright can sit there.

Subtractive spine (VA)

Patch What it is Tags
Mono Saw the one everyone reaches for: saw, ladder, glide, legato retrigger off va mono glide
Supersaw Lead unison detune, wide, the trance top line va unison bright
Sync Screamer hard sync with the sync pitch on a macro and on velocity va sync aggressive velocity
PWM Lead pulse width under an LFO, hollow and moving va pwm hollow drifting
Square Octave square plus square an octave up, no detune — the clean one va hollow clean
Ring Lead ring modulation against a tracked second oscillator va ringmod metallic
Ribbon Lead two detuned near-square oscillators with mild PWM, glide long enough to hear as a slide, filter opening under it, and a bend range wide enough for a ribbon gesture va mono glide expressive
Filter Scream self-oscillating ladder, resonance on a macro, playable as a voice of its own va macro chaotic
Fifths Lead poly, fixed fifths, the organ-lead hybrid va poly wide

FM

Patch What it is Tags
FM Brass Lead the DX brass lead — index on velocity, the whole patch is that curve fm brass velocity
Glass Lead high ratio, short index decay, bright and hard-edged fm glassy bright
Bite Lead feedback on the modulator, gritty and nearly noisy at the top fm gritty

Additive

Patch What it is Tags
Formant Lead fixed formant peaks over a tracked harmonic series; vowel on a macro additive vocal macro
Partial Sweep a moving window over the partials — the additive engine doing what only it can additive demo drifting

Waveguide

Patch What it is Tags
Glass Tube a tube with no instrument at the end of it; blown-adjacent, deliberately not a flute waveguide hollow air

Waveguide and modal are thin here on purpose. A convincing waveguide melody
voice is almost always a recognizable instrument, and the ruling above sends
it to Winds or Pluck. What is left for Lead is the resonator with no
instrument attached.

Hybrid — markers for the multi-engine session

Patch What it is Tags
Saw + Bell VA saw core with an FM bell layer on the top octave, split by velocity hybrid demo
Breath Lead additive body, noise chiff, waveguide tail — three engines doing one voice's three parts hybrid breathy demo

These two are placeholders for the session on cross-engine patches, not
finished designs. Every category's list should carry one or two of these
rather than leaving that session a blank page.

Ships thin first

Mono Saw, Supersaw Lead, Sync Screamer, PWM Lead, Square Octave, FM Brass
Lead, Glass Lead, Formant Lead, Filter Scream. Nine, and they cover mono and
poly, all three main engines, and the four gestures a lead patch is judged on
— glide, velocity, filter, detune.

Gaps

  • No wavetable engine yet — one is coming but unspecced — and its
    absence costs Lead more than it cost Bass. The
    scanning digital lead — PPG, the Waldorf lineage, every "digital" top line
    since — has no home in this bank. Nothing here approximates it; the
    additive Partial Sweep is a different sound with a similar description.
  • No effects yet, and a lead is the patch most defined by what follows
    it. "Lead into a dotted-eighth delay" is an identity, not a decoration, and
    it waits on Effects.
  • Bend range is unresolved for Ribbon Lead. A ribbon gesture needs far
    more than two semitones, which is a claim about how the instrument is
    played. Whether that is patch data or channel data, I have not checked.
  • No sample-oscillator lead. One would cost a checked-in recording, which
    the bank carries forever; hold until a specific sound earns its bytes.

None of these is a reason to hold the section.

## Category 2 — Lead ### A ruling this category forces `Lead` is named after a job, not a thing. Every instrument category is a potential lead: a flute plays the top line, a trumpet plays the top line, a Rhodes plays the top line. If "plays the melody" put a patch here, `Winds` and `Keys` would empty into `Lead` and the taxonomy would collapse into arrangement roles. So: **an instrument-shaped patch goes to its instrument's category. `Lead` holds the melody voices that have no instrument to be.** A modeled flute is `Winds` whatever part it plays; a supersaw is `Lead`, because there is nothing else it is. This does not contradict the role ruling — it bounds it. The 808 case is one synthesis voice with two *jobs*; this is one job with many *instruments*. `Bass` escapes the same problem by being bounded by register instead, which is why an upright can sit there. ### Subtractive spine (VA) | Patch | What it is | Tags | |---|---|---| | Mono Saw | the one everyone reaches for: saw, ladder, glide, legato retrigger off | `va` `mono` `glide` | | Supersaw Lead | unison detune, wide, the trance top line | `va` `unison` `bright` | | Sync Screamer | hard sync with the sync pitch on a macro and on velocity | `va` `sync` `aggressive` `velocity` | | PWM Lead | pulse width under an LFO, hollow and moving | `va` `pwm` `hollow` `drifting` | | Square Octave | square plus square an octave up, no detune — the clean one | `va` `hollow` `clean` | | Ring Lead | ring modulation against a tracked second oscillator | `va` `ringmod` `metallic` | | Ribbon Lead | two detuned near-square oscillators with mild PWM, glide long enough to hear as a slide, filter opening under it, and a bend range wide enough for a ribbon gesture | `va` `mono` `glide` `expressive` | | Filter Scream | self-oscillating ladder, resonance on a macro, playable as a voice of its own | `va` `macro` `chaotic` | | Fifths Lead | poly, fixed fifths, the organ-lead hybrid | `va` `poly` `wide` | ### FM | Patch | What it is | Tags | |---|---|---| | FM Brass Lead | the DX brass lead — index on velocity, the whole patch is that curve | `fm` `brass` `velocity` | | Glass Lead | high ratio, short index decay, bright and hard-edged | `fm` `glassy` `bright` | | Bite Lead | feedback on the modulator, gritty and nearly noisy at the top | `fm` `gritty` | ### Additive | Patch | What it is | Tags | |---|---|---| | Formant Lead | fixed formant peaks over a tracked harmonic series; vowel on a macro | `additive` `vocal` `macro` | | Partial Sweep | a moving window over the partials — the additive engine doing what only it can | `additive` `demo` `drifting` | ### Waveguide | Patch | What it is | Tags | |---|---|---| | Glass Tube | a tube with no instrument at the end of it; blown-adjacent, deliberately not a flute | `waveguide` `hollow` `air` | Waveguide and modal are thin here on purpose. A convincing waveguide melody voice is almost always a recognizable instrument, and the ruling above sends it to `Winds` or `Pluck`. What is left for `Lead` is the resonator with no instrument attached. ### Hybrid — markers for the multi-engine session | Patch | What it is | Tags | |---|---|---| | Saw + Bell | VA saw core with an FM bell layer on the top octave, split by velocity | `hybrid` `demo` | | Breath Lead | additive body, noise chiff, waveguide tail — three engines doing one voice's three parts | `hybrid` `breathy` `demo` | These two are placeholders for the session on cross-engine patches, not finished designs. Every category's list should carry one or two of these rather than leaving that session a blank page. ### Ships thin first Mono Saw, Supersaw Lead, Sync Screamer, PWM Lead, Square Octave, FM Brass Lead, Glass Lead, Formant Lead, Filter Scream. Nine, and they cover mono and poly, all three main engines, and the four gestures a lead patch is judged on — glide, velocity, filter, detune. ### Gaps - **No wavetable engine yet** — one is coming but unspecced — and its absence costs `Lead` more than it cost `Bass`. The scanning digital lead — PPG, the Waldorf lineage, every "digital" top line since — has no home in this bank. Nothing here approximates it; the additive `Partial Sweep` is a different sound with a similar description. - **No effects yet**, and a lead is the patch most defined by what follows it. "Lead into a dotted-eighth delay" is an identity, not a decoration, and it waits on `Effects`. - **Bend range is unresolved for `Ribbon Lead`.** A ribbon gesture needs far more than two semitones, which is a claim about how the instrument is played. Whether that is patch data or channel data, I have not checked. - **No sample-oscillator lead.** One would cost a checked-in recording, which the bank carries forever; hold until a specific sound earns its bytes. None of these is a reason to hold the section.
Author
Owner

Category 3 — Pluck

Two boundary questions this category settles

Pizzicato belongs to the instrument, not to the hand. The schema's
Strings row says "bowed", which would send a pizz violin section here. The
instrument ruling from Lead wins instead: a pizzicato violin is a violin.
Strings should read the violin family, whatever the hand is doing, and
Pluck keeps the instruments that are only ever plucked. Upright Pizz
stays in Bass under the register rule, unchanged.

Kalimba and music box are bars, and they still live here. It is a plucked lamellophone —
modal bar material, plucked excitation — and nothing strikes it, so it is
not Mallets. A music box comb is the same story at a smaller size. A worked example that material is a tag and the category is
about the instrument and the gesture, not the physics.

The instruments

Patch What it is Tags
Nylon Guitar round, soft attack, short-ish decay waveguide string plucked
Steel Strings bright, long sustain, audible pick noise waveguide string bright
Clean Electric thinner string, pickup-shaped spectrum, long decay waveguide string clean
Dobro string into a metal cone — resonator, slide-friendly, nasal midrange hybrid string plate metallic
Banjo short bright string into a drum head; decay measured in tenths of a second hybrid string membrane bright
Harp wide range, long decay, no fret buzz waveguide string
Koto the bend after the pluck is the instrument waveguide string expressive
Oud fretless, fast decay, doubled courses waveguide string
Kalimba modal bar, plucked; inharmonic and short modal bar plucked
Music Box plucked steel comb: high, very short, slightly inharmonic modal bar plucked metallic

Dobro and Banjo are cross-engine by nature rather than by ambition: a
dobro is a string driving a metal plate and a banjo is a string driving a
membrane, and this bank can state that literally where a sample library can
only record the result. They are the category's hybrid exemplars, and they
earn it by being real instruments rather than demonstrations.

Synth plucks (VA)

Patch What it is Tags
Saw Pluck the workhorse: saw, fast filter env, no sustain va clean
Resonant Blip short env with resonance high enough to be a pitch of its own va metallic
Sync Pluck sync with the attack carrying all of the brightness va sync gritty
PWM Pluck hollow, narrow pulse, plastic in a good way va pwm hollow

FM and additive

Patch What it is Tags
Digital Pluck high ratio, index decaying faster than amplitude fm glassy
Harmonic Pluck per-partial decay rates — upper partials die first, which is what a string does and what only additive states directly additive string
Glass Pluck authored partial set with no acoustic referent additive glassy demo

Digital Pluck sits near the Mallets boundary. The bells test holds: if the
patch is a bell you play tunes on it is Mallets; if its identity is the
attack and the tone is incidental, it is a pluck.

Hybrid marker

Patch What it is Tags
Pluck to Pad VA pluck attack crossfading into an additive sustain — one key, two instruments hybrid demo

Ships thin first

Nylon Guitar, Steel Strings, Banjo, Harp, Kalimba, Koto, Saw Pluck, Resonant
Blip, Harmonic Pluck. Banjo displaces a second synth pluck because a
cross-engine instrument is worth showing early.

Gaps

  • No amp or cab, so Clean Electric is half an instrument. An electric
    guitar without an amplifier is a DI take. This is a sharper Effects
    dependency than the lead's delay: that one is decoration, this one is the
    instrument.
  • Damping. Palm mute and hand damping want a continuous control on the
    resonator's loss, and pluck position and excitation shape want to be
    playable. What the waveguide engine actually exposes has not been checked
    here — read the engine before designing the patches.
  • The bundle question. A convincing guitar is six monophonic channels
    feeding a group, which is a fabric arrangement rather than a patch. The
    preset schema describes one patch; whether the library ever ships a
    multi — named channels with their patches, their routing and their group
    — is unanswered. This is the second time the answer to "how is this really
    played" has landed outside a single .tymp. Not a blocker for any list.
  • No sample-oscillator patches, for the usual reason: a checked-in recording
    is bytes the bank carries forever.

Strum is deliberately not a gap. A strum is a gesture, so it belongs to the
part, under the same ruling that says a rhythm is a patch plus a part.

## Category 3 — Pluck ### Two boundary questions this category settles **Pizzicato belongs to the instrument, not to the hand.** The schema's `Strings` row says "bowed", which would send a pizz violin section here. The instrument ruling from `Lead` wins instead: a pizzicato violin is a violin. `Strings` should read *the violin family, whatever the hand is doing*, and `Pluck` keeps the instruments that are only ever plucked. `Upright Pizz` stays in `Bass` under the register rule, unchanged. **Kalimba and music box are bars, and they still live here.** It is a plucked lamellophone — modal `bar` material, plucked excitation — and nothing strikes it, so it is not `Mallets`. A music box comb is the same story at a smaller size. A worked example that material is a tag and the category is about the instrument and the gesture, not the physics. ### The instruments | Patch | What it is | Tags | |---|---|---| | Nylon Guitar | round, soft attack, short-ish decay | `waveguide` `string` `plucked` | | Steel Strings | bright, long sustain, audible pick noise | `waveguide` `string` `bright` | | Clean Electric | thinner string, pickup-shaped spectrum, long decay | `waveguide` `string` `clean` | | Dobro | string into a metal cone — resonator, slide-friendly, nasal midrange | `hybrid` `string` `plate` `metallic` | | Banjo | short bright string into a drum head; decay measured in tenths of a second | `hybrid` `string` `membrane` `bright` | | Harp | wide range, long decay, no fret buzz | `waveguide` `string` | | Koto | the bend after the pluck is the instrument | `waveguide` `string` `expressive` | | Oud | fretless, fast decay, doubled courses | `waveguide` `string` | | Kalimba | modal bar, plucked; inharmonic and short | `modal` `bar` `plucked` | | Music Box | plucked steel comb: high, very short, slightly inharmonic | `modal` `bar` `plucked` `metallic` | `Dobro` and `Banjo` are cross-engine by nature rather than by ambition: a dobro is a string driving a metal plate and a banjo is a string driving a membrane, and this bank can state that literally where a sample library can only record the result. They are the category's hybrid exemplars, and they earn it by being real instruments rather than demonstrations. ### Synth plucks (VA) | Patch | What it is | Tags | |---|---|---| | Saw Pluck | the workhorse: saw, fast filter env, no sustain | `va` `clean` | | Resonant Blip | short env with resonance high enough to be a pitch of its own | `va` `metallic` | | Sync Pluck | sync with the attack carrying all of the brightness | `va` `sync` `gritty` | | PWM Pluck | hollow, narrow pulse, plastic in a good way | `va` `pwm` `hollow` | ### FM and additive | Patch | What it is | Tags | |---|---|---| | Digital Pluck | high ratio, index decaying faster than amplitude | `fm` `glassy` | | Harmonic Pluck | per-partial decay rates — upper partials die first, which is what a string does and what only additive states directly | `additive` `string` | | Glass Pluck | authored partial set with no acoustic referent | `additive` `glassy` `demo` | `Digital Pluck` sits near the `Mallets` boundary. The bells test holds: if the patch is a bell you play tunes on it is `Mallets`; if its identity is the attack and the tone is incidental, it is a pluck. ### Hybrid marker | Patch | What it is | Tags | |---|---|---| | Pluck to Pad | VA pluck attack crossfading into an additive sustain — one key, two instruments | `hybrid` `demo` | ### Ships thin first Nylon Guitar, Steel Strings, Banjo, Harp, Kalimba, Koto, Saw Pluck, Resonant Blip, Harmonic Pluck. Banjo displaces a second synth pluck because a cross-engine instrument is worth showing early. ### Gaps - **No amp or cab, so `Clean Electric` is half an instrument.** An electric guitar without an amplifier is a DI take. This is a sharper `Effects` dependency than the lead's delay: that one is decoration, this one is the instrument. - **Damping.** Palm mute and hand damping want a continuous control on the resonator's loss, and pluck position and excitation shape want to be playable. What the waveguide engine actually exposes has not been checked here — read the engine before designing the patches. - **The bundle question.** A convincing guitar is six monophonic channels feeding a group, which is a fabric arrangement rather than a patch. The preset schema describes one patch; whether the library ever ships a *multi* — named channels with their patches, their routing and their group — is unanswered. This is the second time the answer to "how is this really played" has landed outside a single `.tymp`. Not a blocker for any list. - No sample-oscillator patches, for the usual reason: a checked-in recording is bytes the bank carries forever. Strum is deliberately not a gap. A strum is a gesture, so it belongs to the part, under the same ruling that says a rhythm is a patch plus a part.
Author
Owner

Category 4 — Keys

The boundary this one strains, and the ruling

Keys is a family, not a gesture: a harpsichord is plucked and a clavinet is
struck, and both are here because they are keyboard instruments. That holds
until an instrument is a keyboard and a struck bar. Celesta and toy piano
are both.

Ruling: the instrument's own family decides, and the test is what an
arranger calls it.
A celesta is scored in the percussion section, so it is
Mallets. A toy piano is a piano, badly, so it is Keys. This is the
weakest boundary drawn so far and it is recorded as a decision rather than a
derivation.

Acoustic

Patch What it is Tags
Tack Piano tacks on the hammers; bright metallic attack over a modal string hybrid string plate bright
Upright short, honky, a little detuned in the middle hybrid string plate wooden
Soft Grand pedal down, played quietly — the one register where a model is convincing hybrid string plate
Toy Piano struck rods, no sustain, inharmonic modal bar
Harpsichord plucked, no dynamics, the release as loud as the attack waveguide string
Clavichord tangent-stopped string, very quiet; aftertouch bends it sharp, so Bebung is a playable gesture rather than a historical note waveguide string aftertouch expressive

A piano is a string driving a plate, so the whole acoustic block is hybrid by
nature the way the dobro and banjo were: the soundboard is not an effect on
the sound, it is half the instrument.

The hard one, stated plainly: a convincing concert grand is the hardest patch
in any synthesizer and this bank will not have one early. Soft Grand is
scoped to the register where a model holds up. The tack piano and the upright
are more characterful and more achievable, which is why they lead.

The clavichord earns its own row rather than being a clavinet variant,
because the tangent staying in contact with the string makes finger pressure
a pitch control. That is an expression mapping this bank can do honestly
and a sampled clavichord cannot.

Electric

Patch What it is Tags
Tine EP Rhodes: index rising with velocity until it barks fm velocity clean
Reed EP Wurlitzer: grittier, narrower, bites earlier fm gritty velocity
Digital EP the DX7 one — bell-tinged, glassy, mixed loud in 1985 fm glassy bright
Electric Grand CP-70: struck string through a pickup, bright and thin hybrid string metallic
Clavinet rubber tangent on a string, pickup-shaped, percussive waveguide string gritty

Clavinet is the Superstition patch, and dry it will only be most of the
way there. The rest of that sound is an amplifier and a wah, so the patch is
deliberately shipped as the instrument and not as the record; the authentic
version waits on Effects, alongside the guitar amp the Clean Electric
pluck is waiting for.

Organ

Patch What it is Tags
Drawbar Organ fixed ratios, authored amplitudes, key click, percussion on the second and third additive clean
Full Organ every drawbar out additive bright
Pipe Organ principal, flute and reed stops as authored partial sets additive hollow
Combo Organ Vox/Farfisa: bright, reedy, a bit rude va hollow gritty
Harmonium free reed, sustained, slow to speak waveguide reed breathy

The drawbar organ is the cleanest engine-to-instrument fit in the bank.
Drawbars are partial amplitudes at fixed ratios; the additive engine does
not approximate a tone generator here, it does the same arithmetic.

Hybrid markers

Patch What it is Tags
Drawbar Morph registration as a macro sweep — one gesture, the whole stop list additive demo macro
Hammer + Air struck string attack into a blown tube sustain; a keyboard instrument that cannot exist hybrid demo

Ships thin first

Tine EP, Reed EP, Digital EP, Drawbar Organ, Combo Organ, Clavinet,
Harpsichord, Tack Piano, Pipe Organ. The concert grand is deliberately out of
the core: shipping a mediocre one is worse than shipping none.

Gaps

  • No Leslie, and a Hammond without one is not a Hammond. Same shape as
    the guitar amp — the cabinet is the instrument, not a sweetener. Both
    drawbar patches are provisional until Effects. The electric pianos want
    tremolo and phaser for the same reason, and the clavinet wants a wah, but
    all three survive dry better than the organ does.
  • No sympathetic resonance, and it is architectural. Voices are
    independent; a piano with the pedal down is a coupled system where every
    struck string excites every other. Nothing in the voice model expresses
    cross-voice coupling. Soft Grand is the patch that most wants it and the
    one that will most obviously lack it. This deserves its own issue rather
    than a line in a patch list.
  • Pedal behavior. Half-pedal, sostenuto and una corda are the difference
    between a piano patch and a piano. What is handled of CC64 today has not
    been checked here.
  • No sample-oscillator piano, for the usual bytes reason — though if any
    patch in this bank ever justifies a checked-in recording, it is this one.
## Category 4 — Keys ### The boundary this one strains, and the ruling `Keys` is a family, not a gesture: a harpsichord is plucked and a clavinet is struck, and both are here because they are keyboard instruments. That holds until an instrument is a keyboard *and* a struck bar. Celesta and toy piano are both. **Ruling: the instrument's own family decides, and the test is what an arranger calls it.** A celesta is scored in the percussion section, so it is `Mallets`. A toy piano is a piano, badly, so it is `Keys`. This is the weakest boundary drawn so far and it is recorded as a decision rather than a derivation. ### Acoustic | Patch | What it is | Tags | |---|---|---| | Tack Piano | tacks on the hammers; bright metallic attack over a modal string | `hybrid` `string` `plate` `bright` | | Upright | short, honky, a little detuned in the middle | `hybrid` `string` `plate` `wooden` | | Soft Grand | pedal down, played quietly — the one register where a model is convincing | `hybrid` `string` `plate` | | Toy Piano | struck rods, no sustain, inharmonic | `modal` `bar` | | Harpsichord | plucked, no dynamics, the release as loud as the attack | `waveguide` `string` | | Clavichord | tangent-stopped string, very quiet; aftertouch bends it sharp, so *Bebung* is a playable gesture rather than a historical note | `waveguide` `string` `aftertouch` `expressive` | A piano is a string driving a plate, so the whole acoustic block is hybrid by nature the way the dobro and banjo were: the soundboard is not an effect on the sound, it is half the instrument. The hard one, stated plainly: a convincing concert grand is the hardest patch in any synthesizer and this bank will not have one early. `Soft Grand` is scoped to the register where a model holds up. The tack piano and the upright are more characterful and more achievable, which is why they lead. The clavichord earns its own row rather than being a clavinet variant, because the tangent staying in contact with the string makes finger pressure a *pitch* control. That is an expression mapping this bank can do honestly and a sampled clavichord cannot. ### Electric | Patch | What it is | Tags | |---|---|---| | Tine EP | Rhodes: index rising with velocity until it barks | `fm` `velocity` `clean` | | Reed EP | Wurlitzer: grittier, narrower, bites earlier | `fm` `gritty` `velocity` | | Digital EP | the DX7 one — bell-tinged, glassy, mixed loud in 1985 | `fm` `glassy` `bright` | | Electric Grand | CP-70: struck string through a pickup, bright and thin | `hybrid` `string` `metallic` | | Clavinet | rubber tangent on a string, pickup-shaped, percussive | `waveguide` `string` `gritty` | `Clavinet` is the *Superstition* patch, and dry it will only be most of the way there. The rest of that sound is an amplifier and a wah, so the patch is deliberately shipped as the instrument and not as the record; the authentic version waits on `Effects`, alongside the guitar amp the `Clean Electric` pluck is waiting for. ### Organ | Patch | What it is | Tags | |---|---|---| | Drawbar Organ | fixed ratios, authored amplitudes, key click, percussion on the second and third | `additive` `clean` | | Full Organ | every drawbar out | `additive` `bright` | | Pipe Organ | principal, flute and reed stops as authored partial sets | `additive` `hollow` | | Combo Organ | Vox/Farfisa: bright, reedy, a bit rude | `va` `hollow` `gritty` | | Harmonium | free reed, sustained, slow to speak | `waveguide` `reed` `breathy` | The drawbar organ is the cleanest engine-to-instrument fit in the bank. Drawbars *are* partial amplitudes at fixed ratios; the additive engine does not approximate a tone generator here, it does the same arithmetic. ### Hybrid markers | Patch | What it is | Tags | |---|---|---| | Drawbar Morph | registration as a macro sweep — one gesture, the whole stop list | `additive` `demo` `macro` | | Hammer + Air | struck string attack into a blown tube sustain; a keyboard instrument that cannot exist | `hybrid` `demo` | ### Ships thin first Tine EP, Reed EP, Digital EP, Drawbar Organ, Combo Organ, Clavinet, Harpsichord, Tack Piano, Pipe Organ. The concert grand is deliberately out of the core: shipping a mediocre one is worse than shipping none. ### Gaps - **No Leslie, and a Hammond without one is not a Hammond.** Same shape as the guitar amp — the cabinet is the instrument, not a sweetener. Both drawbar patches are provisional until `Effects`. The electric pianos want tremolo and phaser for the same reason, and the clavinet wants a wah, but all three survive dry better than the organ does. - **No sympathetic resonance, and it is architectural.** Voices are independent; a piano with the pedal down is a coupled system where every struck string excites every other. Nothing in the voice model expresses cross-voice coupling. `Soft Grand` is the patch that most wants it and the one that will most obviously lack it. This deserves its own issue rather than a line in a patch list. - **Pedal behavior.** Half-pedal, sostenuto and una corda are the difference between a piano patch and a piano. What is handled of CC64 today has not been checked here. - No sample-oscillator piano, for the usual bytes reason — though if any patch in this bank ever justifies a checked-in recording, it is this one.
Author
Owner

Category 5 — Mallets

Modal synthesis's home category. Almost everything here is a bar or a tube of
a known material, which is the one case where the bank builds an instrument
from a handful of authored numbers instead of a recording.

Bars and resonators

Patch What it is Tags
Marimba rosewood bar over a tuned tube; warm, the resonator doing audible work modal bar tube wooden
Xylophone harder, shorter, brighter — the same instrument in a hurry modal bar wooden bright
Vibraphone aluminum bar, tube, and the motor modal bar tube metallic
Glockenspiel steel bar, no resonator, rings for a long time modal bar metallic bright
Celesta felt hammers on steel bars over wooden resonators — here by the ruling in the Keys comment, not by the cabinet modal bar metallic
Crotales thick bronze discs, very high, very long modal bar metallic

The vibraphone's motor is patch data, not an effect. Rotating vanes open and
close the resonator tubes, so it is amplitude modulation inside the
instrument
and per note: an LFO on the layer's amplitude, with the depth and
rate the player sets. One of the few places the authentic thing arrives
before Effects rather than after.

Bells

Patch What it is Tags
Tubular Bells struck tube, long decay, the strike note a pitch no partial actually occupies modal tube metallic
Church Bell hum, prime, tierce, quint, nominal — the tierce a minor third, which is why a big bell sounds minor modal metallic
Hand Bells small, clean, short modal metallic clean

Both of those — the tubular bell's absent fundamental and the church bell's
minor-third tierce — are standard bell acoustics passed along here, not
measured in this repo. They are recorded because they are authoring
instructions: a bell built on a harmonic series sounds wrong in a way no
amount of envelope work repairs, and the partial ratios are the patch.

A single struck bell used for color belongs in Cymbals, under the
pitch-is-load-bearing test. These three are the ones melodies are played on.

Metal and glass

Patch What it is Tags
Steel Drum tuned regions of a stretched plate; the "pang" is the plate's own inharmonicity modal plate metallic
Glass Harmonica rubbed glass, pure and slow to speak modal glassy bowed

Glass Harmonica is the only patch here that is not struck: the excitation is
sustained friction. That exciter exists — dsp/junction.h's
JunctionCurve::kFriction, inside the modal loop, which is what
patches/bowed_plate.h and patches/cuica.h already use. Not blocked.

A music box is a plucked comb, so it sits in Pluck beside the kalimba.
Filed there by gesture, not here by material.

Synthetic

Patch What it is Tags
FM Bell inharmonic ratio, index decaying faster than amplitude fm metallic
Additive Bell an authored inharmonic partial set with a decay rate per partial additive metallic
Mallet Synth the FM marimba: short, woody, velocity into index fm wooden velocity
Glass Bells authored partials with no acoustic referent, long and shimmering additive glassy demo

Hybrid markers

Patch What it is Tags
Bar into Plate a marimba bar driving a steel plate instead of a tube — a resonator the instrument was never built with hybrid demo
Struck Air bar attack into a blown tube that keeps ringing after the bar has died hybrid demo

Ships thin first

Marimba, Xylophone, Vibraphone, Glockenspiel, Celesta, Tubular Bells, Steel
Drum, FM Bell, Additive Bell.

Gaps

  • Mallet hardness and strike position are the two controls this category
    lives on.
    Yarn to rubber to plastic changes the excitation spectrum;
    striking at a node rather than an antinode changes which partials receive
    energy at all. Both belong to the exciter, and what the modal engine
    exposes has not been checked. If they are not playable, every patch here is
    one static mallet.
  • The vibraphone pedal is the sustain-pedal question from the Keys
    comment, arriving from another direction.
  • Room. Mallet instruments are heard in rooms and a dry marimba sounds
    like a sample. That is Effects, graded honestly: a want here, not the
    Leslie's must.
  • Rolls are not a gap. A roll is a gesture, so it belongs to the part —
    the same ruling that keeps strum out of the guitar patches.
## Category 5 — Mallets Modal synthesis's home category. Almost everything here is a bar or a tube of a known material, which is the one case where the bank builds an instrument from a handful of authored numbers instead of a recording. ### Bars and resonators | Patch | What it is | Tags | |---|---|---| | Marimba | rosewood bar over a tuned tube; warm, the resonator doing audible work | `modal` `bar` `tube` `wooden` | | Xylophone | harder, shorter, brighter — the same instrument in a hurry | `modal` `bar` `wooden` `bright` | | Vibraphone | aluminum bar, tube, and the motor | `modal` `bar` `tube` `metallic` | | Glockenspiel | steel bar, no resonator, rings for a long time | `modal` `bar` `metallic` `bright` | | Celesta | felt hammers on steel bars over wooden resonators — here by the ruling in the `Keys` comment, not by the cabinet | `modal` `bar` `metallic` | | Crotales | thick bronze discs, very high, very long | `modal` `bar` `metallic` | The vibraphone's motor is patch data, not an effect. Rotating vanes open and close the resonator tubes, so it is amplitude modulation *inside the instrument* and per note: an LFO on the layer's amplitude, with the depth and rate the player sets. One of the few places the authentic thing arrives before `Effects` rather than after. ### Bells | Patch | What it is | Tags | |---|---|---| | Tubular Bells | struck tube, long decay, the strike note a pitch no partial actually occupies | `modal` `tube` `metallic` | | Church Bell | hum, prime, tierce, quint, nominal — the tierce a minor third, which is why a big bell sounds minor | `modal` `metallic` | | Hand Bells | small, clean, short | `modal` `metallic` `clean` | Both of those — the tubular bell's absent fundamental and the church bell's minor-third tierce — are standard bell acoustics passed along here, not measured in this repo. They are recorded because they are authoring instructions: a bell built on a harmonic series sounds wrong in a way no amount of envelope work repairs, and the partial ratios *are* the patch. A single struck bell used for color belongs in `Cymbals`, under the pitch-is-load-bearing test. These three are the ones melodies are played on. ### Metal and glass | Patch | What it is | Tags | |---|---|---| | Steel Drum | tuned regions of a stretched plate; the "pang" is the plate's own inharmonicity | `modal` `plate` `metallic` | | Glass Harmonica | rubbed glass, pure and slow to speak | `modal` `glassy` `bowed` | `Glass Harmonica` is the only patch here that is not struck: the excitation is sustained friction. That exciter exists — `dsp/junction.h`'s `JunctionCurve::kFriction`, inside the modal loop, which is what `patches/bowed_plate.h` and `patches/cuica.h` already use. Not blocked. A music box is a plucked comb, so it sits in `Pluck` beside the kalimba. Filed there by gesture, not here by material. ### Synthetic | Patch | What it is | Tags | |---|---|---| | FM Bell | inharmonic ratio, index decaying faster than amplitude | `fm` `metallic` | | Additive Bell | an authored inharmonic partial set with a decay rate per partial | `additive` `metallic` | | Mallet Synth | the FM marimba: short, woody, velocity into index | `fm` `wooden` `velocity` | | Glass Bells | authored partials with no acoustic referent, long and shimmering | `additive` `glassy` `demo` | ### Hybrid markers | Patch | What it is | Tags | |---|---|---| | Bar into Plate | a marimba bar driving a steel plate instead of a tube — a resonator the instrument was never built with | `hybrid` `demo` | | Struck Air | bar attack into a blown tube that keeps ringing after the bar has died | `hybrid` `demo` | ### Ships thin first Marimba, Xylophone, Vibraphone, Glockenspiel, Celesta, Tubular Bells, Steel Drum, FM Bell, Additive Bell. ### Gaps - **Mallet hardness and strike position are the two controls this category lives on.** Yarn to rubber to plastic changes the excitation spectrum; striking at a node rather than an antinode changes which partials receive energy at all. Both belong to the exciter, and what the modal engine exposes has not been checked. If they are not playable, every patch here is one static mallet. - **The vibraphone pedal** is the sustain-pedal question from the `Keys` comment, arriving from another direction. - **Room.** Mallet instruments are heard in rooms and a dry marimba sounds like a sample. That is `Effects`, graded honestly: a want here, not the Leslie's must. - **Rolls are not a gap.** A roll is a gesture, so it belongs to the part — the same ruling that keeps strum out of the guitar patches.
Author
Owner

Category 6 — Pad

Two tests this category needs

Pad versus Atmosphere. If the notes played determine the harmony, it is a
Pad; if it would sound substantially the same whatever was played, it is
Atmosphere. A pad is a chordal instrument that happens to be slow; a drone
is furniture.

String machines are pads. A Solina or ARP ensemble is not a violin model
— it is a divide-down organ through a bucket-brigade chorus, modeled on
nothing. The instrument ruling asks whether a patch is shaped like an
instrument, and a string machine is shaped like a product. Strings keeps
the violin family.

Subtractive (VA)

Patch What it is Tags
Warm Pad two detuned saws, slow attack, lowpass, one slow LFO — the reference pad va warm drifting
PWM Pad the Juno: pulse width under an LFO, hollow and wide va pwm hollow drifting
Supersaw Pad unison stack, wide and bright, the modern one va unison bright wide
Dark Pad low, filtered almost shut, slow — ominous without being a sound effect va hollow warm
Sweep Pad the filter opening over four bars, on a macro and on a slow envelope va macro
Solina divide-down ensemble; a string machine, not a string section va ensemble wide
Thin Pad deliberately cheap: few voices, few partials, no unison va clean

Thin Pad exists for a reason beyond taste. Pads are where the voice budget
goes — long releases, high polyphony, unison multiplying all of it — and a
bank whose only pads are expensive ones leaves nothing to reach for when the
budget is tight. One honest cheap pad is worth more than a tenth lush one.

FM

Patch What it is Tags
Glass Pad high ratio, low index, bright and cold fm glassy bright
Metal Pad inharmonic ratios held at low index — ominous, faintly bell-like fm metallic
Digital Pad bell attack over a soft sustain fm glassy bright

Additive — the showcase

Patch What it is Tags
Morphing Pad every partial's amplitude on its own slow LFO at an unrelated rate, so the spectrum never repeats additive drifting
Odd Harmonics odd partials only — hollow and clarinet-adjacent, but chordal additive hollow
Spectral Drift a partial set slowly walking somewhere else and never arriving additive drifting demo

Morphing Pad is the patch that most justifies having an additive engine at
all. A sample library cannot do it, a wavetable can only loop it, and a
filter can only shape what is already there. Independent per-partial motion
is the one thing additive does that nothing else approximates.

Resonant

Patch What it is Tags
Shimmer Plate a modal plate with the loss turned nearly off, excited continuously rather than struck modal plate glassy
Breathing Pad noise-excited tube — air with a pitch in it waveguide tube breathy

Hybrid marker

Patch What it is Tags
Evolving Stack additive sustain, VA filter movement, modal plate tail — three engines splitting one voice's job hybrid demo

This is the candidate for the bank's flagship demo patch when the
cross-engine session happens. A pad is the best showcase for layered engines
because it is the one patch long enough for a listener to hear the layers
hand off to each other.

Ships thin first

Warm Pad, PWM Pad, Supersaw Pad, Dark Pad, Sweep Pad, Thin Pad, Glass Pad,
Metal Pad, Morphing Pad.

Gaps

  • Chorus, and Solina is blocked by it the way the Hammond is blocked by
    the Leslie.
    A string machine without its bucket-brigade chorus is a buzzy
    organ. Every other pad here is improved by chorus and reverb; that one is
    constituted by them.
  • Stereo width is not a gap, and that is worth stating: layers carry
    their own left/right and pan, so per-layer detune spread is patch data
    already, not an effect being waited on.
  • Long releases versus voice stealing. A pad with a four-second release
    is exactly where stealing becomes audible, and this is the category that
    will exercise the degradation ladder first. Not a patch problem — a thing
    to listen for when these are built.
  • Wavetables, when they land, will want a pad or two here as much as they
    want a lead.
## Category 6 — Pad ### Two tests this category needs **Pad versus Atmosphere.** If the notes played determine the harmony, it is a `Pad`; if it would sound substantially the same whatever was played, it is `Atmosphere`. A pad is a chordal instrument that happens to be slow; a drone is furniture. **String machines are pads.** A Solina or ARP ensemble is not a violin model — it is a divide-down organ through a bucket-brigade chorus, modeled on nothing. The instrument ruling asks whether a patch is shaped like an instrument, and a string machine is shaped like a *product*. `Strings` keeps the violin family. ### Subtractive (VA) | Patch | What it is | Tags | |---|---|---| | Warm Pad | two detuned saws, slow attack, lowpass, one slow LFO — the reference pad | `va` `warm` `drifting` | | PWM Pad | the Juno: pulse width under an LFO, hollow and wide | `va` `pwm` `hollow` `drifting` | | Supersaw Pad | unison stack, wide and bright, the modern one | `va` `unison` `bright` `wide` | | Dark Pad | low, filtered almost shut, slow — ominous without being a sound effect | `va` `hollow` `warm` | | Sweep Pad | the filter opening over four bars, on a macro and on a slow envelope | `va` `macro` | | Solina | divide-down ensemble; a string machine, not a string section | `va` `ensemble` `wide` | | Thin Pad | deliberately cheap: few voices, few partials, no unison | `va` `clean` | `Thin Pad` exists for a reason beyond taste. Pads are where the voice budget goes — long releases, high polyphony, unison multiplying all of it — and a bank whose only pads are expensive ones leaves nothing to reach for when the budget is tight. One honest cheap pad is worth more than a tenth lush one. ### FM | Patch | What it is | Tags | |---|---|---| | Glass Pad | high ratio, low index, bright and cold | `fm` `glassy` `bright` | | Metal Pad | inharmonic ratios held at low index — ominous, faintly bell-like | `fm` `metallic` | | Digital Pad | bell attack over a soft sustain | `fm` `glassy` `bright` | ### Additive — the showcase | Patch | What it is | Tags | |---|---|---| | Morphing Pad | every partial's amplitude on its own slow LFO at an unrelated rate, so the spectrum never repeats | `additive` `drifting` | | Odd Harmonics | odd partials only — hollow and clarinet-adjacent, but chordal | `additive` `hollow` | | Spectral Drift | a partial set slowly walking somewhere else and never arriving | `additive` `drifting` `demo` | `Morphing Pad` is the patch that most justifies having an additive engine at all. A sample library cannot do it, a wavetable can only loop it, and a filter can only shape what is already there. Independent per-partial motion is the one thing additive does that nothing else approximates. ### Resonant | Patch | What it is | Tags | |---|---|---| | Shimmer Plate | a modal plate with the loss turned nearly off, excited continuously rather than struck | `modal` `plate` `glassy` | | Breathing Pad | noise-excited tube — air with a pitch in it | `waveguide` `tube` `breathy` | ### Hybrid marker | Patch | What it is | Tags | |---|---|---| | Evolving Stack | additive sustain, VA filter movement, modal plate tail — three engines splitting one voice's job | `hybrid` `demo` | This is the candidate for the bank's flagship demo patch when the cross-engine session happens. A pad is the best showcase for layered engines because it is the one patch long enough for a listener to hear the layers hand off to each other. ### Ships thin first Warm Pad, PWM Pad, Supersaw Pad, Dark Pad, Sweep Pad, Thin Pad, Glass Pad, Metal Pad, Morphing Pad. ### Gaps - **Chorus, and `Solina` is blocked by it the way the Hammond is blocked by the Leslie.** A string machine without its bucket-brigade chorus is a buzzy organ. Every other pad here is *improved* by chorus and reverb; that one is *constituted* by them. - **Stereo width is not a gap**, and that is worth stating: layers carry their own left/right and pan, so per-layer detune spread is patch data already, not an effect being waited on. - **Long releases versus voice stealing.** A pad with a four-second release is exactly where stealing becomes audible, and this is the category that will exercise the degradation ladder first. Not a patch problem — a thing to listen for when these are built. - Wavetables, when they land, will want a pad or two here as much as they want a lead.
Author
Owner

Category 7 — Strings

The violin family, solo and ensemble, whatever the hand is doing.

The question that decides whether this category is possible

A bowed string is a stick-slip friction interaction: the bow grabs the
string, the string tears free, and that repeats hundreds of times a second.
It is nonlinear, it is the entire instrument, and it is a different exciter
from a pluck or a strike in kind rather than in degree. Everything acoustic
here depends on the waveguide engine having a bow exciter.

The bow already exists, but not where this category needs it.
dsp/junction.h has JunctionCurve::kFriction — the Stribeck curve, which
is the stick-slip model — and it is used inside the modal loop by
patches/bowed_plate.h and patches/cuica.h. What
dsp/waveguide_layer.h offers as drives is kBurst, kReed, kJet, kLip
and kInput: no friction.

So the requirement is narrow and precise rather than large and vague: a
friction drive for the waveguide string. Bowed plate yes, bowed violin not
yet.

Articulations are playing, not patches

Sample libraries ship Sustain, Staccato, Spiccato and Marcato as
separate patches behind keyswitches, because a recording cannot interpolate
between two bowing techniques. A model can. Bow speed, bow pressure and note
length are continuous inputs, so one Solo Violin should play legato when
played legato and spiccato when played short and hard.

That collapses what would be forty patches into a dozen and produces a better
instrument. The exception is pizzicato, a genuinely different exciter: put
bow-versus-pluck on a macro or a velocity split inside the patch, and ship
Pizz Section separately only if that crossfade does not hold up.

Tremolo is the middle case. It is rapid bow reversal, but no part written in
sixteenths reproduces the sound, so it is a bow-speed LFO inside the patch —
the same argument that makes the vibraphone's motor patch data.

Solo

Patch What it is Tags
Solo Violin bowed string, vibrato on aftertouch with a delayed onset, bow position on a macro waveguide string bowed aftertouch
Solo Viola darker, thicker, the middle voice waveguide string bowed
Solo Cello the widest dynamic range in the family waveguide string bowed expressive

Bowed double bass is not here: it is Bowed Bass in the Bass comment, under
the register rule. That exposes something about the role ruling worth
recording — it has to be applied once, at authoring time. The alternative is
shipping one instrument twice under two categories, which the
one-primary-category rule exists to prevent.

Ensemble

Patch What it is Tags
Violin Section many players, uncorrelated vibrato, slight pitch spread waveguide string bowed ensemble
Cello Section the same trick, an octave and a half down waveguide string bowed ensemble
Chamber Strings small and close — few players rather than many waveguide string ensemble
Full Ensemble the tutti, wide waveguide string ensemble wide
Tremolo Strings bow-speed LFO; tension, not a part anyone could write waveguide string ensemble
Pizz Section only if the in-patch crossfade does not hold up waveguide string plucked ensemble

Additive

Patch What it is Tags
Additive Ensemble the section effect from first principles: N detuned voices, each with its own vibrato rate and depth, none in phase additive ensemble

Worth building even if the waveguide bow works perfectly. A string section
is uncorrelated vibrato plus pitch spread — that is what makes eight
violins sound unlike one violin turned up — and additive states it directly
rather than imitating its result.

Hybrid markers

Patch What it is Tags
Bowed Bar the bow exciter on a modal bar; an instrument nobody built hybrid demo bowed
Strings + Voice section with vocal formants over it — the film cheat, made honest hybrid vocal demo

Ships thin first

Solo Violin, Solo Cello, Violin Section, Cello Section, Chamber Strings, Full
Ensemble, Tremolo Strings, Additive Ensemble, Pizz Section — all of it
contingent on the bow.

Gaps

  • The bow exciter. Stated above; it is the category.
  • Legato transitions. A violinist slides between notes on one bow stroke:
    the string never stops vibrating and the envelope never restarts. That is a
    legato voice-allocation mode rather than an envelope setting, and whether
    one exists has not been checked.
  • Sections are a polyphony multiplier. One key on Full Ensemble is
    eight detuned players; a four-note chord is thirty-two voices. A worse
    budget consumer than pads, and the category most likely to force the
    degradation ladder's hand.
  • Vibrato should be a player control with a delayed onset, not a fixed
    LFO — a real player's vibrato starts after the note does. Small, and most
    of what separates a convincing string patch from a synthetic one.
  • Room and section reverb want Effects. A want, not a must.
## Category 7 — Strings The violin family, solo and ensemble, whatever the hand is doing. ### The question that decides whether this category is possible A bowed string is a stick-slip friction interaction: the bow grabs the string, the string tears free, and that repeats hundreds of times a second. It is nonlinear, it is the entire instrument, and it is a different exciter from a pluck or a strike in kind rather than in degree. Everything acoustic here depends on the waveguide engine having a bow exciter. **The bow already exists, but not where this category needs it.** `dsp/junction.h` has `JunctionCurve::kFriction` — the Stribeck curve, which is the stick-slip model — and it is used inside the modal loop by `patches/bowed_plate.h` and `patches/cuica.h`. What `dsp/waveguide_layer.h` offers as drives is `kBurst`, `kReed`, `kJet`, `kLip` and `kInput`: no friction. So the requirement is narrow and precise rather than large and vague: a friction drive for the waveguide string. Bowed plate yes, bowed violin not yet. ### Articulations are playing, not patches Sample libraries ship `Sustain`, `Staccato`, `Spiccato` and `Marcato` as separate patches behind keyswitches, because a recording cannot interpolate between two bowing techniques. A model can. Bow speed, bow pressure and note length are continuous inputs, so one `Solo Violin` should play legato when played legato and spiccato when played short and hard. That collapses what would be forty patches into a dozen and produces a better instrument. The exception is pizzicato, a genuinely different exciter: put bow-versus-pluck on a macro or a velocity split inside the patch, and ship `Pizz Section` separately only if that crossfade does not hold up. Tremolo is the middle case. It is rapid bow reversal, but no part written in sixteenths reproduces the sound, so it is a bow-speed LFO inside the patch — the same argument that makes the vibraphone's motor patch data. ### Solo | Patch | What it is | Tags | |---|---|---| | Solo Violin | bowed string, vibrato on aftertouch with a delayed onset, bow position on a macro | `waveguide` `string` `bowed` `aftertouch` | | Solo Viola | darker, thicker, the middle voice | `waveguide` `string` `bowed` | | Solo Cello | the widest dynamic range in the family | `waveguide` `string` `bowed` `expressive` | Bowed double bass is not here: it is `Bowed Bass` in the `Bass` comment, under the register rule. That exposes something about the role ruling worth recording — it has to be applied once, at authoring time. The alternative is shipping one instrument twice under two categories, which the one-primary-category rule exists to prevent. ### Ensemble | Patch | What it is | Tags | |---|---|---| | Violin Section | many players, uncorrelated vibrato, slight pitch spread | `waveguide` `string` `bowed` `ensemble` | | Cello Section | the same trick, an octave and a half down | `waveguide` `string` `bowed` `ensemble` | | Chamber Strings | small and close — few players rather than many | `waveguide` `string` `ensemble` | | Full Ensemble | the tutti, wide | `waveguide` `string` `ensemble` `wide` | | Tremolo Strings | bow-speed LFO; tension, not a part anyone could write | `waveguide` `string` `ensemble` | | Pizz Section | only if the in-patch crossfade does not hold up | `waveguide` `string` `plucked` `ensemble` | ### Additive | Patch | What it is | Tags | |---|---|---| | Additive Ensemble | the section effect from first principles: N detuned voices, each with its own vibrato rate and depth, none in phase | `additive` `ensemble` | Worth building even if the waveguide bow works perfectly. A string section *is* uncorrelated vibrato plus pitch spread — that is what makes eight violins sound unlike one violin turned up — and additive states it directly rather than imitating its result. ### Hybrid markers | Patch | What it is | Tags | |---|---|---| | Bowed Bar | the bow exciter on a modal bar; an instrument nobody built | `hybrid` `demo` `bowed` | | Strings + Voice | section with vocal formants over it — the film cheat, made honest | `hybrid` `vocal` `demo` | ### Ships thin first Solo Violin, Solo Cello, Violin Section, Cello Section, Chamber Strings, Full Ensemble, Tremolo Strings, Additive Ensemble, Pizz Section — all of it contingent on the bow. ### Gaps - **The bow exciter.** Stated above; it is the category. - **Legato transitions.** A violinist slides between notes on one bow stroke: the string never stops vibrating and the envelope never restarts. That is a legato voice-allocation mode rather than an envelope setting, and whether one exists has not been checked. - **Sections are a polyphony multiplier.** One key on `Full Ensemble` is eight detuned players; a four-note chord is thirty-two voices. A worse budget consumer than pads, and the category most likely to force the degradation ladder's hand. - **Vibrato should be a player control with a delayed onset**, not a fixed LFO — a real player's vibrato starts after the note does. Small, and most of what separates a convincing string patch from a synthetic one. - Room and section reverb want `Effects`. A want, not a must.
Author
Owner

Category 8 — Winds

Everything blown: brass, reeds, flutes. The merge that put them in one row
holds; the distinction lives in the brass, reed and flute tags.

All three exciters already exist

Winds need three nonlinear exciters — a lip reed for brass, a cane
reed
for clarinet, sax, oboe and bassoon, and an air jet for flutes —
and dsp/waveguide_layer.h offers all three as drives (kLip, kReed,
kJet, beside kBurst and kInput). patches/trumpet.h,
patches/clarinet.h, patches/flute.h and patches/low_flue.h are the
proof, and their headers are the best authoring documentation this category
has.

This is the rare category whose engine work is done. What remains is
authoring.

Bore shape is the authoring instruction

  • A clarinet is a cylinder closed at the reed end: odd harmonics only,
    and it overblows at the twelfth rather than the octave. Built on a full
    harmonic series it will never sound like a clarinet.
  • A sax or oboe is conical, so it gets the full series and overblows at
    the octave — which is why a sax is reedy where a clarinet is hollow.
  • A flute is an open cylinder with a jet, and the breath noise is half the
    perceived instrument rather than a garnish.
  • Brass brightens nonlinearly with loudness: at high amplitude the wave
    steepens toward a shock inside the tube. Loud brass is not quiet brass
    turned up. That curve is what FM's index-on-velocity imitates, which is why
    the DX brass lead convinced people while modeling nothing.

Standard wind acoustics, passed along here rather than measured in this repo.
Recorded because each line is a patch-authoring constraint.

Brass

Patch What it is Tags
Solo Trumpet bright, brassiness rising with pressure waveguide tube brass expressive
Muted Trumpet harmon mute: nasal, mid-scooped, intimate waveguide tube brass
Trombone the slide is real glide, not portamento imitating one waveguide tube brass glide
French Horn soft, round, facing away from you waveguide tube brass warm
Tuba the bottom of the section waveguide tube brass
Brass Section stabs and swells, wide waveguide tube brass ensemble
Synth Brass the Prophet/Oberheim one — fast filter envelope, no model anywhere in it va brass unison
CS-80 Brass cutoff modulated at low audio rates, ring mod for the growl, aftertouch straight into brightness va brass aftertouch expressive
FM Brass poly; the index curve doing the brightening a linear tube cannot fm brass velocity

CS-80 Brass is a technique patch as much as a sound. Modulating the lowpass
cutoff at low audio rates is a distinct and under-used method — it is neither
vibrato nor FM of the oscillator, and it produces sidebands around the
resonance rather than around the pitch. The VA engine's audio-rate matrix
tier exists for exactly this, and nothing else in the bank demonstrates it.
It should recur in other categories rather than appearing once here.

Synth Brass is in Winds and the Solina is in Pad for the same reason,
not different ones: category follows role. What a string machine does in a
track is hold chords underneath, so it is a pad. What synth brass does is
play brass parts — stabs, riffs, unison lines — so it is a wind. Neither
models anything; both are filed by the job.

Reeds

Patch What it is Tags
Clarinet odd harmonics, hollow, overblows at the twelfth waveguide tube reed hollow
Bass Clarinet the same bore, woodier and slower to speak waveguide tube reed wooden
Alto Sax conical and reedy, growl on aftertouch waveguide tube reed gritty
Tenor Sax breathier, bigger, later to bite waveguide tube reed breathy
Oboe narrow cone, nasal, unmistakable waveguide tube reed
Bassoon the low double reed, buzzy and dry waveguide tube reed wooden
Blues Harp free reed; the bend is the instrument waveguide reed expressive

Flutes

Patch What it is Tags
Concert Flute jet drive with the breath noise mixed honestly high waveguide tube flute breathy
Piccolo the same an octave up and twice as loud waveguide tube flute bright
Shakuhachi breath, bend and attack noise carrying the expression waveguide tube flute breathy expressive
Pan Flute stopped pipes, chiffy, pure above the chiff waveguide tube flute
Ocarina a vessel rather than a tube — nearly a pure tone, and it does not overblow waveguide flute hollow
Didgeridoo a tube whose timbre is the player's vocal tract hybrid tube vocal drifting

Ocarina is a Helmholtz resonator: its pitch comes from the enclosed volume
and the open holes, not from a standing wave in a length of tube. It needs a
vessel resonator, which is either a small engine addition or a reason to
build this one additively.

Didgeridoo is a real instrument that is structurally a hybrid patch — a
driven tube through moving formants. The wind equivalent of the dobro:
cross-engine by nature rather than by ambition.

Additive

Patch What it is Tags
Additive Wind authored spectrum plus breath noise; hollow, blown, modeled on nothing additive breathy
Breath Stack noise, jet and harmonic layers under one pressure control hybrid breathy demo

Hybrid markers

Patch What it is Tags
Reed String a cane reed exciting a string instead of a tube hybrid demo
Brass Plate lip reed driving a metal plate — a horn with a cymbal for a bell hybrid demo

Ships thin first

Concert Flute, Clarinet, Alto Sax, Solo Trumpet, Trombone, French Horn, Brass
Section, CS-80 Brass, Synth Brass. Nothing here waits on an engine.

Gaps and needs

  • A vessel (Helmholtz) resonator for Ocarina.
  • A formant filter inside the feedback loop for growl, flutter tongue and
    the didgeridoo's whole identity.
  • Breath is the category. These instruments are unplayable without a
    continuous pressure control driving amplitude, brightness and the brass
    nonlinearity together. MPE pressure or CC2 into a macro is the minimum; a
    patch here with velocity-only dynamics is a toy.
  • Register breaks. A clarinet overblows at the twelfth and a flute at the
    octave, and players change register mid-phrase. Whether the model does this
    itself or it is faked per note is a design decision, not a detail.
  • Sections multiply polyphony, as in Strings.
  • Room wants Effects: a want, not a must.
## Category 8 — Winds Everything blown: brass, reeds, flutes. The merge that put them in one row holds; the distinction lives in the `brass`, `reed` and `flute` tags. ### All three exciters already exist Winds need three nonlinear exciters — a **lip reed** for brass, a **cane reed** for clarinet, sax, oboe and bassoon, and an **air jet** for flutes — and `dsp/waveguide_layer.h` offers all three as drives (`kLip`, `kReed`, `kJet`, beside `kBurst` and `kInput`). `patches/trumpet.h`, `patches/clarinet.h`, `patches/flute.h` and `patches/low_flue.h` are the proof, and their headers are the best authoring documentation this category has. This is the rare category whose engine work is done. What remains is authoring. ### Bore shape is the authoring instruction - A **clarinet** is a cylinder closed at the reed end: **odd harmonics only**, and it overblows at the **twelfth** rather than the octave. Built on a full harmonic series it will never sound like a clarinet. - A **sax or oboe** is conical, so it gets the full series and overblows at the octave — which is why a sax is reedy where a clarinet is hollow. - A **flute** is an open cylinder with a jet, and the breath noise is half the perceived instrument rather than a garnish. - **Brass brightens nonlinearly with loudness**: at high amplitude the wave steepens toward a shock inside the tube. Loud brass is not quiet brass turned up. That curve is what FM's index-on-velocity imitates, which is why the DX brass lead convinced people while modeling nothing. Standard wind acoustics, passed along here rather than measured in this repo. Recorded because each line is a patch-authoring constraint. ### Brass | Patch | What it is | Tags | |---|---|---| | Solo Trumpet | bright, brassiness rising with pressure | `waveguide` `tube` `brass` `expressive` | | Muted Trumpet | harmon mute: nasal, mid-scooped, intimate | `waveguide` `tube` `brass` | | Trombone | the slide is real glide, not portamento imitating one | `waveguide` `tube` `brass` `glide` | | French Horn | soft, round, facing away from you | `waveguide` `tube` `brass` `warm` | | Tuba | the bottom of the section | `waveguide` `tube` `brass` | | Brass Section | stabs and swells, wide | `waveguide` `tube` `brass` `ensemble` | | Synth Brass | the Prophet/Oberheim one — fast filter envelope, no model anywhere in it | `va` `brass` `unison` | | CS-80 Brass | cutoff modulated at low audio rates, ring mod for the growl, aftertouch straight into brightness | `va` `brass` `aftertouch` `expressive` | | FM Brass | poly; the index curve doing the brightening a linear tube cannot | `fm` `brass` `velocity` | `CS-80 Brass` is a technique patch as much as a sound. Modulating the lowpass cutoff at low audio rates is a distinct and under-used method — it is neither vibrato nor FM of the oscillator, and it produces sidebands around the resonance rather than around the pitch. The VA engine's audio-rate matrix tier exists for exactly this, and nothing else in the bank demonstrates it. It should recur in other categories rather than appearing once here. `Synth Brass` is in `Winds` and the Solina is in `Pad` for the same reason, not different ones: category follows role. What a string machine does in a track is hold chords underneath, so it is a pad. What synth brass does is play brass parts — stabs, riffs, unison lines — so it is a wind. Neither models anything; both are filed by the job. ### Reeds | Patch | What it is | Tags | |---|---|---| | Clarinet | odd harmonics, hollow, overblows at the twelfth | `waveguide` `tube` `reed` `hollow` | | Bass Clarinet | the same bore, woodier and slower to speak | `waveguide` `tube` `reed` `wooden` | | Alto Sax | conical and reedy, growl on aftertouch | `waveguide` `tube` `reed` `gritty` | | Tenor Sax | breathier, bigger, later to bite | `waveguide` `tube` `reed` `breathy` | | Oboe | narrow cone, nasal, unmistakable | `waveguide` `tube` `reed` | | Bassoon | the low double reed, buzzy and dry | `waveguide` `tube` `reed` `wooden` | | Blues Harp | free reed; the bend is the instrument | `waveguide` `reed` `expressive` | ### Flutes | Patch | What it is | Tags | |---|---|---| | Concert Flute | jet drive with the breath noise mixed honestly high | `waveguide` `tube` `flute` `breathy` | | Piccolo | the same an octave up and twice as loud | `waveguide` `tube` `flute` `bright` | | Shakuhachi | breath, bend and attack noise carrying the expression | `waveguide` `tube` `flute` `breathy` `expressive` | | Pan Flute | stopped pipes, chiffy, pure above the chiff | `waveguide` `tube` `flute` | | Ocarina | a vessel rather than a tube — nearly a pure tone, and it does not overblow | `waveguide` `flute` `hollow` | | Didgeridoo | a tube whose timbre is the player's vocal tract | `hybrid` `tube` `vocal` `drifting` | `Ocarina` is a Helmholtz resonator: its pitch comes from the enclosed volume and the open holes, not from a standing wave in a length of tube. It needs a vessel resonator, which is either a small engine addition or a reason to build this one additively. `Didgeridoo` is a real instrument that is structurally a hybrid patch — a driven tube through moving formants. The wind equivalent of the dobro: cross-engine by nature rather than by ambition. ### Additive | Patch | What it is | Tags | |---|---|---| | Additive Wind | authored spectrum plus breath noise; hollow, blown, modeled on nothing | `additive` `breathy` | | Breath Stack | noise, jet and harmonic layers under one pressure control | `hybrid` `breathy` `demo` | ### Hybrid markers | Patch | What it is | Tags | |---|---|---| | Reed String | a cane reed exciting a string instead of a tube | `hybrid` `demo` | | Brass Plate | lip reed driving a metal plate — a horn with a cymbal for a bell | `hybrid` `demo` | ### Ships thin first Concert Flute, Clarinet, Alto Sax, Solo Trumpet, Trombone, French Horn, Brass Section, CS-80 Brass, Synth Brass. Nothing here waits on an engine. ### Gaps and needs - **A vessel (Helmholtz) resonator** for `Ocarina`. - **A formant filter inside the feedback loop** for growl, flutter tongue and the didgeridoo's whole identity. - **Breath is the category.** These instruments are unplayable without a continuous pressure control driving amplitude, brightness *and* the brass nonlinearity together. MPE pressure or CC2 into a macro is the minimum; a patch here with velocity-only dynamics is a toy. - **Register breaks.** A clarinet overblows at the twelfth and a flute at the octave, and players change register mid-phrase. Whether the model does this itself or it is faked per note is a design decision, not a detail. - **Sections multiply polyphony**, as in `Strings`. - Room wants `Effects`: a want, not a must.
Author
Owner

Category 9 — Voice

The one rule that makes a voice a voice

Formants do not track the keyboard. A vowel is defined by where its first
two or three resonances sit in absolute frequency, and those stay put when a
singer changes pitch — which is why pitch-shifting a vocal sample gives a
chipmunk. The glottal source moves; the tract does not.

The engine already has absolute formant placement and an unvoiced formant
layer, so this category starts from a better position than Strings or
Winds do.

The formant table itself — which vowel sits at which pair of frequencies —
is Peterson–Barney territory. Whoever authors these should take the numbers
from a source rather than from memory.

Choirs

Patch What it is Tags
Choir Aah open vowel, wide additive vocal ensemble
Choir Ooh closed and dark, sits under everything additive vocal ensemble warm
Mixed Choir SATB spread across the range additive vocal ensemble wide
Boys Choir purer, straighter, almost no vibrato additive vocal ensemble clean
Chamber Choir eight people in a room, not eighty additive vocal ensemble

A choir is built the way a string section is: many voices, uncorrelated
vibrato rates, small pitch and timing spread. Same construction, same
polyphony cost, and additive states it directly.

Solo

Patch What it is Tags
Solo Soprano vibrato on aftertouch with delayed onset; formants fixed as the pitch climbs additive vocal expressive
Solo Tenor the same instrument with a longer tract additive vocal
Solo Bass Voice low and resonant — a singer rather than a bass line additive vocal
Hummed mouth closed: nasal, soft, no consonant at either end additive vocal hollow

Solo Bass Voice grazes the register rule from Bass. The distinction is
job: Bass holds the patches whose work is the bottom of the arrangement,
and a bass singer's work is singing. Recorded because it is the first time
the register rule has met an instrument that merely happens to be low.

Overtone singing — two styles, two patches

Patch What it is Tags
Kargyraa the low growl: ventricular folds vibrating at half the rate of the vocal folds, so the source itself carries an f0/2 series interleaved with the harmonics additive vocal gritty
Sygyt the high whistle: a narrow movable resonance selecting one harmonic at a time out of an ordinary drone additive vocal drifting

A patch exists for the first of these and #38 says it sounds terrible. One
hypothesis worth testing before reworking it blind: if the patch is built on
a plain harmonic series with a strong formant over it, the result is a buzzy
vowel rather than a growl, because the growl is the half-rate source. The
subharmonic series has to be in the partial layout, not in the filter. That
is a standard description of the mechanism, passed along here rather than
measured, but it is checkable against what the patch actually lays out.

Sygyt is the one worth building to show why this synth is different.
Overtone singing is a movable narrow resonance selecting single harmonics out
of a fixed drone, and an additive engine does that by turning partials up and
down — the mechanism itself rather than an imitation of it.

Synthetic vocal

Patch What it is Tags
Vowel Pad sustained, the vowel on a macro; the morph between vowels is the gesture additive vocal macro
Robot Voice buzzy pulse train through fixed formants; VOSIM-era speech va vocal gritty
Vocal Tract a tube of varying cross-section, played as an instrument rather than as a mouth waveguide tube vocal
Whistle human whistling: near-sine with breath around it waveguide flute breathy

Hybrid markers

Patch What it is Tags
Bowed Voice bow exciter driving vocal formants — a singing string hybrid demo bowed
Bell Choir FM bell attack handing off to a choir sustain on one key hybrid demo

Ships thin first

Choir Aah, Choir Ooh, Mixed Choir, Solo Soprano, Solo Tenor, Vowel Pad,
Sygyt, Robot Voice, Vocal Tract. Kargyraa is a rework rather than a new
patch; see #38.

Gaps and needs

  • Consonants. A choir that cannot make a consonant is an "aah" machine,
    and every synth choir ever shipped has been one. The format already carries
    standalone chiff assets, which is the right shape for a noise transient
    at note onset — a consonant is a chiff with a spectrum. A real path to
    something rare rather than a wish.
  • Legato vowel transitions. Singing moves between vowels within a note,
    so the vowel macro has to be smoothly modulatable mid-note.
  • Source quality. Breathy versus pressed phonation is a property of the
    glottal source rather than the formants, and it is most of what separates a
    soft singer from a loud one.
  • Vocoder and talk box are input processors, so they belong to Effects.
    Recorded here so they are not filed under Voice later.
  • Choirs multiply polyphony, as strings and wind sections do. Third time
    it has come up; ensemble patches and the voice budget may deserve their own
    note in the schema.
  • Vibrato with delayed onset, as in Strings.
## Category 9 — Voice ### The one rule that makes a voice a voice **Formants do not track the keyboard.** A vowel is defined by where its first two or three resonances sit in absolute frequency, and those stay put when a singer changes pitch — which is why pitch-shifting a vocal sample gives a chipmunk. The glottal source moves; the tract does not. The engine already has absolute formant placement and an unvoiced formant layer, so this category starts from a better position than `Strings` or `Winds` do. The formant table itself — which vowel sits at which pair of frequencies — is Peterson–Barney territory. Whoever authors these should take the numbers from a source rather than from memory. ### Choirs | Patch | What it is | Tags | |---|---|---| | Choir Aah | open vowel, wide | `additive` `vocal` `ensemble` | | Choir Ooh | closed and dark, sits under everything | `additive` `vocal` `ensemble` `warm` | | Mixed Choir | SATB spread across the range | `additive` `vocal` `ensemble` `wide` | | Boys Choir | purer, straighter, almost no vibrato | `additive` `vocal` `ensemble` `clean` | | Chamber Choir | eight people in a room, not eighty | `additive` `vocal` `ensemble` | A choir is built the way a string section is: many voices, uncorrelated vibrato rates, small pitch and timing spread. Same construction, same polyphony cost, and additive states it directly. ### Solo | Patch | What it is | Tags | |---|---|---| | Solo Soprano | vibrato on aftertouch with delayed onset; formants fixed as the pitch climbs | `additive` `vocal` `expressive` | | Solo Tenor | the same instrument with a longer tract | `additive` `vocal` | | Solo Bass Voice | low and resonant — a singer rather than a bass line | `additive` `vocal` | | Hummed | mouth closed: nasal, soft, no consonant at either end | `additive` `vocal` `hollow` | `Solo Bass Voice` grazes the register rule from `Bass`. The distinction is job: `Bass` holds the patches whose work is the bottom of the arrangement, and a bass singer's work is singing. Recorded because it is the first time the register rule has met an instrument that merely happens to be low. ### Overtone singing — two styles, two patches | Patch | What it is | Tags | |---|---|---| | Kargyraa | the low growl: ventricular folds vibrating at half the rate of the vocal folds, so the source itself carries an f0/2 series interleaved with the harmonics | `additive` `vocal` `gritty` | | Sygyt | the high whistle: a narrow movable resonance selecting one harmonic at a time out of an ordinary drone | `additive` `vocal` `drifting` | A patch exists for the first of these and #38 says it sounds terrible. One hypothesis worth testing before reworking it blind: if the patch is built on a plain harmonic series with a strong formant over it, the result is a buzzy vowel rather than a growl, because the growl *is* the half-rate source. The subharmonic series has to be in the partial layout, not in the filter. That is a standard description of the mechanism, passed along here rather than measured, but it is checkable against what the patch actually lays out. `Sygyt` is the one worth building to show why this synth is different. Overtone singing is a movable narrow resonance selecting single harmonics out of a fixed drone, and an additive engine does that by turning partials up and down — the mechanism itself rather than an imitation of it. ### Synthetic vocal | Patch | What it is | Tags | |---|---|---| | Vowel Pad | sustained, the vowel on a macro; the morph between vowels is the gesture | `additive` `vocal` `macro` | | Robot Voice | buzzy pulse train through fixed formants; VOSIM-era speech | `va` `vocal` `gritty` | | Vocal Tract | a tube of varying cross-section, played as an instrument rather than as a mouth | `waveguide` `tube` `vocal` | | Whistle | human whistling: near-sine with breath around it | `waveguide` `flute` `breathy` | ### Hybrid markers | Patch | What it is | Tags | |---|---|---| | Bowed Voice | bow exciter driving vocal formants — a singing string | `hybrid` `demo` `bowed` | | Bell Choir | FM bell attack handing off to a choir sustain on one key | `hybrid` `demo` | ### Ships thin first Choir Aah, Choir Ooh, Mixed Choir, Solo Soprano, Solo Tenor, Vowel Pad, Sygyt, Robot Voice, Vocal Tract. Kargyraa is a rework rather than a new patch; see #38. ### Gaps and needs - **Consonants.** A choir that cannot make a consonant is an "aah" machine, and every synth choir ever shipped has been one. The format already carries standalone **chiff** assets, which is the right shape for a noise transient at note onset — a consonant is a chiff with a spectrum. A real path to something rare rather than a wish. - **Legato vowel transitions.** Singing moves between vowels *within* a note, so the vowel macro has to be smoothly modulatable mid-note. - **Source quality.** Breathy versus pressed phonation is a property of the glottal source rather than the formants, and it is most of what separates a soft singer from a loud one. - **Vocoder and talk box are input processors**, so they belong to `Effects`. Recorded here so they are not filed under `Voice` later. - **Choirs multiply polyphony**, as strings and wind sections do. Third time it has come up; ensemble patches and the voice budget may deserve their own note in the schema. - Vibrato with delayed onset, as in `Strings`.
Author
Owner

Category 10 — Drums

Three things this category settles

A kit is not a patch. Under one primary category per patch, each drum is
its own patch. Nobody thinks that way — people load a kit — and this is the
bundle question for the third time, after the six-string guitar and the
channel group. Keep shipping individual drums: a bundle format can gather
them later, and a kit-shaped patch cannot be taken apart.

Timpani belongs here. It is a membrane drum that gets tuned. The
pitch-is-load-bearing test is about metal — it separates the metal you play
tunes on from the metal you hit for color — and was never meant to pull drums
out of Drums. Drums and Percussion are told apart by instrument family:
the kit and its skins on one side, everything else struck, shaken or scraped
on the other. The wording in the body is tightened accordingly.

One tom, not three. Tuning is channel-owned through per-note offsets, so
high, mid and floor toms are one patch played at three pitches — provided it
is authored to hold up across the range rather than tuned to one spot. A
concrete saving this architecture hands us.

Acoustic

Patch What it is Tags
Kick membrane, shell, and the beater click as its own transient modal membrane wooden
Snare head plus wires — two coupled things, not one modal membrane noisy
Tom one patch, tuned across the range by the channel modal membrane wooden
Rimshot stick on rim and head at once; almost all transient modal membrane bright
Side Stick the quiet cross-stick click modal membrane wooden
Brush Snare brushed rather than struck: soft attack, sustained swish modal membrane noisy
Timpani air-loaded membrane; the loading drags the modes toward a pitch modal membrane

A circular membrane's modes are inharmonic — Bessel zeros, not integers —
which is why an undamped drum has no clear pitch. It is also why
materials/bessel.h implements the Bessel functions itself: membrane
materials are generated from those zeros at build time, exactly
reproducibly. This category is what that machinery was built for.

Timpani is the exception that proves it: the enclosed air load pulls certain
modes toward near-harmonic ratios, which is why it has a definite pitch where
a tom does not.

Machines

Patch What it is Tags
808 Kick the role ruling's worked example — the same decaying sine and pitch blip as 808 Bass, tuned low and let go va struck
808 Snare two tuned tones plus a noise band, mixed by the snappy control va noisy
808 Clap several noise bursts a few milliseconds apart, then a longer one va noisy
909 Kick shorter, more click, more attack pitch sweep va struck
909 Snare noise-led where the 808 is tone-led va noisy

The clap is the drum-machine sound worth building carefully, because it is
the structurally interesting one: not a hit but a small burst pattern plus a
tail, and the spacing is the sound. Get the spacing wrong and it is a
handclap-shaped noise.

Synthetic

Patch What it is Tags
Sub Kick a sine and an envelope, nothing else va clean
Noise Snare filtered noise under a fast envelope va noisy
Modal Snare the membrane model rather than the recipe modal membrane
Clap Stack the 808 clap idea taken further out va noisy demo

Hybrid markers

Patch What it is Tags
Head into Plate a snare head driving a steel plate instead of air — metallic and long hybrid demo
Kick Tube a kick exciting a resonant tube that keeps sounding after it hybrid demo

Ships thin first

Kick, Snare, Tom, Rimshot, 808 Kick, 808 Snare, 808 Clap, 909 Kick, 909
Snare.

Gaps and needs

  • Snare wires. Wires buzzing against the bottom head are a contact
    nonlinearity — a coupling, not a filter — and they are the difference
    between a snare and a tom with noise on it.
  • Air loading for timpani, which is what gives it a pitch at all.
  • Beater hardness and strike position. Center versus edge changes which
    modes receive energy. Mallets asked for the same control, which makes it
    one need rather than two.
  • No two hits are identical — and the engine already allows that. A patch
    gets two voice-level random values at note-on and two more per layer, so
    routing a little randomness into noise, detune and strike position is
    authoring work rather than an engine request. Not a gap; a thing every
    patch here should actually do, because an acoustic drum varies hit to hit
    and a drum machine does not, and the difference is audible within four
    bars.
  • Gated reverb is a sound, not a treatment. The 80s snare is constituted
    by it the way the Hammond is by the Leslie. Waits on Effects.
  • Choke and exclusivity — one drum cutting another off — arrives properly
    in Cymbals with open and closed hats, but the kit needs it too.
## Category 10 — Drums ### Three things this category settles **A kit is not a patch.** Under one primary category per patch, each drum is its own patch. Nobody thinks that way — people load a *kit* — and this is the bundle question for the third time, after the six-string guitar and the channel group. Keep shipping individual drums: a bundle format can gather them later, and a kit-shaped patch cannot be taken apart. **Timpani belongs here.** It is a membrane drum that gets tuned. The pitch-is-load-bearing test is about metal — it separates the metal you play tunes on from the metal you hit for color — and was never meant to pull drums out of `Drums`. `Drums` and `Percussion` are told apart by instrument family: the kit and its skins on one side, everything else struck, shaken or scraped on the other. The wording in the body is tightened accordingly. **One tom, not three.** Tuning is channel-owned through per-note offsets, so high, mid and floor toms are one patch played at three pitches — provided it is authored to hold up across the range rather than tuned to one spot. A concrete saving this architecture hands us. ### Acoustic | Patch | What it is | Tags | |---|---|---| | Kick | membrane, shell, and the beater click as its own transient | `modal` `membrane` `wooden` | | Snare | head plus wires — two coupled things, not one | `modal` `membrane` `noisy` | | Tom | one patch, tuned across the range by the channel | `modal` `membrane` `wooden` | | Rimshot | stick on rim and head at once; almost all transient | `modal` `membrane` `bright` | | Side Stick | the quiet cross-stick click | `modal` `membrane` `wooden` | | Brush Snare | brushed rather than struck: soft attack, sustained swish | `modal` `membrane` `noisy` | | Timpani | air-loaded membrane; the loading drags the modes toward a pitch | `modal` `membrane` | A circular membrane's modes are inharmonic — Bessel zeros, not integers — which is why an undamped drum has no clear pitch. It is also why `materials/bessel.h` implements the Bessel functions itself: membrane materials are generated from those zeros at build time, exactly reproducibly. This category is what that machinery was built for. Timpani is the exception that proves it: the enclosed air load pulls certain modes toward near-harmonic ratios, which is why it has a definite pitch where a tom does not. ### Machines | Patch | What it is | Tags | |---|---|---| | 808 Kick | the role ruling's worked example — the same decaying sine and pitch blip as `808 Bass`, tuned low and let go | `va` `struck` | | 808 Snare | two tuned tones plus a noise band, mixed by the snappy control | `va` `noisy` | | 808 Clap | several noise bursts a few milliseconds apart, then a longer one | `va` `noisy` | | 909 Kick | shorter, more click, more attack pitch sweep | `va` `struck` | | 909 Snare | noise-led where the 808 is tone-led | `va` `noisy` | The clap is the drum-machine sound worth building carefully, because it is the structurally interesting one: not a hit but a small burst pattern plus a tail, and the spacing *is* the sound. Get the spacing wrong and it is a handclap-shaped noise. ### Synthetic | Patch | What it is | Tags | |---|---|---| | Sub Kick | a sine and an envelope, nothing else | `va` `clean` | | Noise Snare | filtered noise under a fast envelope | `va` `noisy` | | Modal Snare | the membrane model rather than the recipe | `modal` `membrane` | | Clap Stack | the 808 clap idea taken further out | `va` `noisy` `demo` | ### Hybrid markers | Patch | What it is | Tags | |---|---|---| | Head into Plate | a snare head driving a steel plate instead of air — metallic and long | `hybrid` `demo` | | Kick Tube | a kick exciting a resonant tube that keeps sounding after it | `hybrid` `demo` | ### Ships thin first Kick, Snare, Tom, Rimshot, 808 Kick, 808 Snare, 808 Clap, 909 Kick, 909 Snare. ### Gaps and needs - **Snare wires.** Wires buzzing against the bottom head are a contact nonlinearity — a coupling, not a filter — and they are the difference between a snare and a tom with noise on it. - **Air loading for timpani**, which is what gives it a pitch at all. - **Beater hardness and strike position.** Center versus edge changes which modes receive energy. `Mallets` asked for the same control, which makes it one need rather than two. - **No two hits are identical** — and the engine already allows that. A patch gets two voice-level random values at note-on and two more per layer, so routing a little randomness into noise, detune and strike position is authoring work rather than an engine request. Not a gap; a thing every patch here should actually do, because an acoustic drum varies hit to hit and a drum machine does not, and the difference is audible within four bars. - **Gated reverb is a sound, not a treatment.** The 80s snare is constituted by it the way the Hammond is by the Leslie. Waits on `Effects`. - **Choke and exclusivity** — one drum cutting another off — arrives properly in `Cymbals` with open and closed hats, but the kit needs it too.
Author
Owner

Category 11 — Cymbals

The only category with a spike behind it already. #91 diagnosed why
patches/crash.h sounds like a struck bell — coherent modes, too much
fundamental, a definite pitch — and found the levers that help: phase scatter
applied at the pickup rather than the resonator (resonator-side scatter
breaks the felt choke), a second plate group and a non-integer aspect ratio to
kill the pitch, pickup-only tilt, and velocity into that tilt.
crash-r-dm50 is the favorite there, crash-r-dm30 close behind.

Every patch here inherits that lesson: coherence is the enemy. A cymbal is
incoherent metal. Anything built as a tidy mode bank will sound like a bell,
and the fix is structural rather than a matter of envelope taste.

Hats

Patch What it is Tags
Closed Hat short, tight, all high modal plate metallic
Open Hat the same instrument left ringing — cut off by the closed hat modal plate metallic
Pedal Hat the foot chick: two cymbals meeting, not a stick modal plate metallic
808 Hats six square oscillators through a highpass, as the machine did it va metallic noisy

Rides

Patch What it is Tags
Ride ping over wash, with strike position on a macro so bow and bell are one patch modal plate metallic
Sizzle Ride rivets rattling against the plate as it rings modal plate noisy

If strike position works as a control, Ride and the ride bell are one patch
— the same argument that made one tom instead of three. Ship them separately
only if the position control cannot span that far.

Crashes and gongs

Patch What it is Tags
Crash the #91 rework; crash-r-dm50 is the starting point, not a fresh design modal plate metallic
Splash small and fast modal plate bright
China trashy and inharmonic — the aspect ratio doing the work modal plate noisy
Tam-tam huge, and it gets brighter after the strike modal plate metallic
Bowed Cymbal a bow drawn across the edge: sustained and eerie, a real technique rather than a demo modal plate bowed

The tam-tam is a genuine engine need. A large gong blooms: energy migrates
from the low modes into the high ones after the strike, through nonlinear
coupling in the plate. A linear mode bank cannot do that — every mode decays
from its initial energy and nothing feeds it. Faked with an envelope it
sounds like a filter opening, because that is what it is.

Bowed Cymbal is free once the bow exciter exists for Strings, and it is
one of the sounds people will remember the instrument for.

Metal percussion

Patch What it is Tags
808 Cowbell two detuned pulses through a band filter — the whole thing va metallic
Triangle tiny, inharmonic, rings far longer than it should modal bar metallic
Finger Cymbals two small discs, very high, very clean modal plate metallic
Anvil struck steel with no attempt at prettiness modal metallic

A nipple gong is pitched and melodies are played on it, so it goes to
Mallets under the existing test. Recorded here because "gong" appears in
this row and that one is the exception.

Abstract markers

Patch What it is Tags
Metal Scatter #91's scatter machinery pushed past any real cymbal modal plate demo chaotic
Gong Pad tam-tam with the loss turned nearly off and held hybrid demo

Ships thin first

Closed Hat, Open Hat, Pedal Hat, Ride, Crash, Splash, China, 808 Hats, 808
Cowbell. Crash ships when #91 is resolved; the rest do not wait on it.

Gaps and needs

  • Nonlinear plate coupling for the tam-tam's bloom. A linear mode bank
    cannot move energy upward after the strike. The one patch here that needs
    new physics rather than better authoring.
  • Contact nonlinearity for rivets — the same need as the snare wires. Two
    categories, one mechanism: something buzzing against a vibrating surface.
  • Choke groups and voice exclusivity. A closed hat has to cut an open hat,
    which is a channel or allocation feature rather than patch data. The one
    thing on this list a kit is unusable without.
  • Strike position, a third request from a third category: bow, edge and
    bell on one cymbal; center and rim on one drum; node and antinode on one
    bar.
  • Per-hit variation is available, not missing. Note-on randomness exists
    at voice and layer level, so sixteen identical hi-hats in a row is an
    authoring failure rather than an engine limit.
  • #91 has one unresolved measurement: crash.h's header records the
    shipped choke as an energy ratio of 0.097 over 8192 samples at 4.5 s, while
    the spike's windowed means show only 2–5 dB. Different methods, never
    reconciled. Worth settling before the rework, since it is the number anyone
    judging the choke will reach for.
## Category 11 — Cymbals The only category with a spike behind it already. #91 diagnosed why `patches/crash.h` sounds like a struck bell — coherent modes, too much fundamental, a definite pitch — and found the levers that help: phase scatter applied at the **pickup** rather than the resonator (resonator-side scatter breaks the felt choke), a second plate group and a non-integer aspect ratio to kill the pitch, pickup-only tilt, and velocity into that tilt. `crash-r-dm50` is the favorite there, `crash-r-dm30` close behind. **Every patch here inherits that lesson: coherence is the enemy.** A cymbal is incoherent metal. Anything built as a tidy mode bank will sound like a bell, and the fix is structural rather than a matter of envelope taste. ### Hats | Patch | What it is | Tags | |---|---|---| | Closed Hat | short, tight, all high | `modal` `plate` `metallic` | | Open Hat | the same instrument left ringing — cut off by the closed hat | `modal` `plate` `metallic` | | Pedal Hat | the foot chick: two cymbals meeting, not a stick | `modal` `plate` `metallic` | | 808 Hats | six square oscillators through a highpass, as the machine did it | `va` `metallic` `noisy` | ### Rides | Patch | What it is | Tags | |---|---|---| | Ride | ping over wash, with strike position on a macro so bow and bell are one patch | `modal` `plate` `metallic` | | Sizzle Ride | rivets rattling against the plate as it rings | `modal` `plate` `noisy` | If strike position works as a control, `Ride` and the ride bell are one patch — the same argument that made one tom instead of three. Ship them separately only if the position control cannot span that far. ### Crashes and gongs | Patch | What it is | Tags | |---|---|---| | Crash | the #91 rework; `crash-r-dm50` is the starting point, not a fresh design | `modal` `plate` `metallic` | | Splash | small and fast | `modal` `plate` `bright` | | China | trashy and inharmonic — the aspect ratio doing the work | `modal` `plate` `noisy` | | Tam-tam | huge, and it gets *brighter* after the strike | `modal` `plate` `metallic` | | Bowed Cymbal | a bow drawn across the edge: sustained and eerie, a real technique rather than a demo | `modal` `plate` `bowed` | The tam-tam is a genuine engine need. A large gong blooms: energy migrates from the low modes into the high ones *after* the strike, through nonlinear coupling in the plate. A linear mode bank cannot do that — every mode decays from its initial energy and nothing feeds it. Faked with an envelope it sounds like a filter opening, because that is what it is. `Bowed Cymbal` is free once the bow exciter exists for `Strings`, and it is one of the sounds people will remember the instrument for. ### Metal percussion | Patch | What it is | Tags | |---|---|---| | 808 Cowbell | two detuned pulses through a band filter — the whole thing | `va` `metallic` | | Triangle | tiny, inharmonic, rings far longer than it should | `modal` `bar` `metallic` | | Finger Cymbals | two small discs, very high, very clean | `modal` `plate` `metallic` | | Anvil | struck steel with no attempt at prettiness | `modal` `metallic` | A nipple gong is pitched and melodies are played on it, so it goes to `Mallets` under the existing test. Recorded here because "gong" appears in this row and that one is the exception. ### Abstract markers | Patch | What it is | Tags | |---|---|---| | Metal Scatter | #91's scatter machinery pushed past any real cymbal | `modal` `plate` `demo` `chaotic` | | Gong Pad | tam-tam with the loss turned nearly off and held | `hybrid` `demo` | ### Ships thin first Closed Hat, Open Hat, Pedal Hat, Ride, Crash, Splash, China, 808 Hats, 808 Cowbell. `Crash` ships when #91 is resolved; the rest do not wait on it. ### Gaps and needs - **Nonlinear plate coupling for the tam-tam's bloom.** A linear mode bank cannot move energy upward after the strike. The one patch here that needs new physics rather than better authoring. - **Contact nonlinearity for rivets** — the same need as the snare wires. Two categories, one mechanism: something buzzing against a vibrating surface. - **Choke groups and voice exclusivity.** A closed hat has to cut an open hat, which is a channel or allocation feature rather than patch data. The one thing on this list a kit is unusable without. - **Strike position**, a third request from a third category: bow, edge and bell on one cymbal; center and rim on one drum; node and antinode on one bar. - **Per-hit variation is available, not missing.** Note-on randomness exists at voice and layer level, so sixteen identical hi-hats in a row is an authoring failure rather than an engine limit. - **#91 has one unresolved measurement**: `crash.h`'s header records the shipped choke as an energy ratio of 0.097 over 8192 samples at 4.5 s, while the spike's windowed means show only 2–5 dB. Different methods, never reconciled. Worth settling before the rework, since it is the number anyone judging the choke will reach for.
Author
Owner

Category 12 — Percussion

Per-hit variation stops being a nicety here and becomes the category. A
shaker is not one sound but dozens of small collisions per stroke, and what
makes it a shaker rather than a noise burst is that the collisions are
stochastic. Two shakes are never the same, and a listener hears a loop
instantly.

The engine for that already exists. dsp/particle_layer.h is the
stochastic-event engine: particle_scheduler.h decides when an arrival
happens, particle_burst.h holds the waveform each one injects,
particle_bodies.h is a bank of fixed-corner one-poles and resonances, and
particle_diffuse.h is an eight-line feedback network. materials/ atmosphere.h sits beside it, turning one authored distance into per-line
absorption, an arrival curve and a direct/diffuse balance through ISO 9613-1.

So shaker, maraca, cabasa, tambourine, sleigh bells, vibraslap and rainstick
are authoring work rather than engine work. That also makes particle a
source-family tag alongside additive, fm, va, waveguide, modal and
sample, and unvoiced a seventh.

Some existing factory patches probably belong in this category already
(rattlesnake among them). Placing what exists is a separate pass at the end
of this ticket, and rattlesnake is a good example of why: a rattle is a
particle instrument by mechanism, but a rattlesnake is an animal, so it may
land in Nature while sharing all of the machinery below. Mechanism does not
decide placement.

Hand drums

Patch What it is Tags
Conga one patch: open, slap and muted are strike position and hand hardness modal membrane wooden
Bongo smaller, higher, the same controls modal membrane wooden
Djembe bass, tone and slap across the head; the widest spread of the three modal membrane wooden
Tabla the loaded head that makes a drum pitched, plus heel pressure bending it modal membrane expressive
Frame Drum tipper on one side, hand pressure on the other modal membrane
Talking Drum tension under continuous control — the bend is the instrument modal membrane expressive
Cajón a box with snare wires behind the face hybrid plate noisy
Udu a clay pot: the hole and the enclosed volume make the note waveguide hollow

Two of these are physically the same trick as things already met. Tabla is
pitched because the black patch on its head is a mass load pulling the
modes toward harmonic ratios — the timpani's fix by another means. Udu is
a Helmholtz resonator, so the vessel model Ocarina asked for in Winds now
has a second customer and stops being a one-patch indulgence.

Wood

Patch What it is Tags
Woodblock short, dry, pitched enough to place modal bar wooden
Temple Blocks five of them, hollow, loosely tuned modal wooden hollow
Claves two sticks, almost a pure tone modal bar wooden
Castanets a pair, and the rattle of the second hit matters modal wooden
Log Drum slit wood, tuned tongues, warm modal bar wooden
Guiro scraped, not struck modal wooden noisy

Guiro needs a scrape exciter: ridges passing under a stick are a train
of impulses whose rate is the hand speed. A cousin of the particle model
rather than the same thing — ordered where the shaker is random.

Shakers and rattles

Patch What it is Tags
Shaker the reference particle instrument particle noisy
Cabasa beads over ridged metal — brighter, scrapier particle noisy metallic
Tambourine jingles: particles that ring after they collide particle metallic
Sleigh Bells many small pitched shells, all slightly different particle metallic
Vibraslap teeth rattling in a box; one hit that keeps going particle wooden
Rainstick a slow cascade, tipped rather than struck particle wooden

A rainstick is an instrument, so it lives here; rain is weather and lives in
Nature. Said once, because the name invites the mistake.

Electronic

Patch What it is Tags
808 Clave a short tuned burst, essentially a windowed sine va clean
808 Maracas one noise burst with a fast decay, nothing stochastic about it va noisy
Finger Snap a click with a short room on it va noisy
Click the count-in; a utility that happens to be percussion va clean

808 Maracas sits next to Shaker deliberately: one is a noise burst and one
is a particle system, and hearing them side by side is the fastest way to
understand what the particle model buys.

Hybrid markers

Patch What it is Tags
Shaker Tube a particle population rattling inside a resonant tube hybrid demo
Wood Skin a block exciting a membrane — a drum struck by an instrument hybrid demo

Ships thin first

Conga, Bongo, Djembe, Tabla, Woodblock, Claves, Shaker, Tambourine, Cabasa.
Nothing here waits on an engine: the membranes need strike position and hand
hardness, and the particle instruments have their engine already.

Gaps and needs

  • A scrape exciter for the guiro — ordered impulses at hand speed rather
    than random arrivals. Whether the particle scheduler can already be driven
    that way is worth checking before treating it as new work.
  • A vessel (Helmholtz) resonator for the udu, which Winds already asked
    for on the ocarina's behalf. Two customers.
  • Mass-loaded membrane material for tabla, alongside the timpani's air
    loading. Both are a membrane made pitched by loading it, by different
    means.
  • Snare wires, third customer after Snare and Cajón. One
    buzzing-contact mechanism, three categories.
  • Per-hit variation is not optional here, and it is available: note-on
    randomness at voice and layer level is already in the engine. A shaker
    authored without it is a sample.
  • Strike position and hand hardness take this category from twenty-four
    patches down to eight: open, slap and muted conga are one instrument played
    three ways.
  • Continuous tension control for tabla, talking drum and frame drum —
    aftertouch into membrane tension, which is expression routing rather than
    new physics.
## Category 12 — Percussion Per-hit variation stops being a nicety here and becomes the category. A shaker is not one sound but dozens of small collisions per stroke, and what makes it a shaker rather than a noise burst is that the collisions are *stochastic*. Two shakes are never the same, and a listener hears a loop instantly. **The engine for that already exists.** `dsp/particle_layer.h` is the stochastic-event engine: `particle_scheduler.h` decides when an arrival happens, `particle_burst.h` holds the waveform each one injects, `particle_bodies.h` is a bank of fixed-corner one-poles and resonances, and `particle_diffuse.h` is an eight-line feedback network. `materials/ atmosphere.h` sits beside it, turning one authored distance into per-line absorption, an arrival curve and a direct/diffuse balance through ISO 9613-1. So shaker, maraca, cabasa, tambourine, sleigh bells, vibraslap and rainstick are authoring work rather than engine work. That also makes `particle` a source-family tag alongside `additive`, `fm`, `va`, `waveguide`, `modal` and `sample`, and `unvoiced` a seventh. Some existing factory patches probably belong in this category already (`rattlesnake` among them). Placing what exists is a separate pass at the end of this ticket, and `rattlesnake` is a good example of why: a rattle is a particle instrument by mechanism, but a rattlesnake is an animal, so it may land in `Nature` while sharing all of the machinery below. Mechanism does not decide placement. ### Hand drums | Patch | What it is | Tags | |---|---|---| | Conga | one patch: open, slap and muted are strike position and hand hardness | `modal` `membrane` `wooden` | | Bongo | smaller, higher, the same controls | `modal` `membrane` `wooden` | | Djembe | bass, tone and slap across the head; the widest spread of the three | `modal` `membrane` `wooden` | | Tabla | the loaded head that makes a drum pitched, plus heel pressure bending it | `modal` `membrane` `expressive` | | Frame Drum | tipper on one side, hand pressure on the other | `modal` `membrane` | | Talking Drum | tension under continuous control — the bend *is* the instrument | `modal` `membrane` `expressive` | | Cajón | a box with snare wires behind the face | `hybrid` `plate` `noisy` | | Udu | a clay pot: the hole and the enclosed volume make the note | `waveguide` `hollow` | Two of these are physically the same trick as things already met. **Tabla** is pitched because the black patch on its head is a *mass load* pulling the modes toward harmonic ratios — the timpani's fix by another means. **Udu** is a Helmholtz resonator, so the vessel model `Ocarina` asked for in `Winds` now has a second customer and stops being a one-patch indulgence. ### Wood | Patch | What it is | Tags | |---|---|---| | Woodblock | short, dry, pitched enough to place | `modal` `bar` `wooden` | | Temple Blocks | five of them, hollow, loosely tuned | `modal` `wooden` `hollow` | | Claves | two sticks, almost a pure tone | `modal` `bar` `wooden` | | Castanets | a pair, and the rattle of the second hit matters | `modal` `wooden` | | Log Drum | slit wood, tuned tongues, warm | `modal` `bar` `wooden` | | Guiro | scraped, not struck | `modal` `wooden` `noisy` | `Guiro` needs a **scrape** exciter: ridges passing under a stick are a train of impulses whose rate is the hand speed. A cousin of the particle model rather than the same thing — ordered where the shaker is random. ### Shakers and rattles | Patch | What it is | Tags | |---|---|---| | Shaker | the reference particle instrument | `particle` `noisy` | | Cabasa | beads over ridged metal — brighter, scrapier | `particle` `noisy` `metallic` | | Tambourine | jingles: particles that ring after they collide | `particle` `metallic` | | Sleigh Bells | many small pitched shells, all slightly different | `particle` `metallic` | | Vibraslap | teeth rattling in a box; one hit that keeps going | `particle` `wooden` | | Rainstick | a slow cascade, tipped rather than struck | `particle` `wooden` | A rainstick is an instrument, so it lives here; rain is weather and lives in `Nature`. Said once, because the name invites the mistake. ### Electronic | Patch | What it is | Tags | |---|---|---| | 808 Clave | a short tuned burst, essentially a windowed sine | `va` `clean` | | 808 Maracas | one noise burst with a fast decay, nothing stochastic about it | `va` `noisy` | | Finger Snap | a click with a short room on it | `va` `noisy` | | Click | the count-in; a utility that happens to be percussion | `va` `clean` | `808 Maracas` sits next to `Shaker` deliberately: one is a noise burst and one is a particle system, and hearing them side by side is the fastest way to understand what the particle model buys. ### Hybrid markers | Patch | What it is | Tags | |---|---|---| | Shaker Tube | a particle population rattling inside a resonant tube | `hybrid` `demo` | | Wood Skin | a block exciting a membrane — a drum struck by an instrument | `hybrid` `demo` | ### Ships thin first Conga, Bongo, Djembe, Tabla, Woodblock, Claves, Shaker, Tambourine, Cabasa. Nothing here waits on an engine: the membranes need strike position and hand hardness, and the particle instruments have their engine already. ### Gaps and needs - **A scrape exciter** for the guiro — ordered impulses at hand speed rather than random arrivals. Whether the particle scheduler can already be driven that way is worth checking before treating it as new work. - **A vessel (Helmholtz) resonator** for the udu, which `Winds` already asked for on the ocarina's behalf. Two customers. - **Mass-loaded membrane material** for tabla, alongside the timpani's air loading. Both are a membrane made pitched by loading it, by different means. - **Snare wires**, third customer after `Snare` and `Cajón`. One buzzing-contact mechanism, three categories. - **Per-hit variation is not optional here**, and it is available: note-on randomness at voice and layer level is already in the engine. A shaker authored without it is a sample. - **Strike position and hand hardness** take this category from twenty-four patches down to eight: open, slap and muted conga are one instrument played three ways. - **Continuous tension control** for tabla, talking drum and frame drum — aftertouch into membrane tension, which is expression routing rather than new physics.
Author
Owner

Category 13 — Atmosphere

The test from Pad decides membership: if it would sound substantially the
same whatever was played, it belongs here. A pad is a chordal instrument that
happens to be slow; this is furniture, and being furniture is the point.

Two engines carry most of it. Additive does drones that evolve without
repeating, because independent per-partial motion has no cycle. The
particle engine
does everything made of events rather than tones — and
materials/atmosphere.h makes distance a patch parameter rather than a
reverb setting: one authored number produces the absorption, the arrival
curve and the direct/diffuse balance together. A thing heard from far away is
genuinely a different patch from the same thing heard close, and this bank
can state that instead of approximating it with a send.

Drones

Patch What it is Tags
Low Drone sub with slow partial movement above it; felt more than heard additive warm drifting
Harmonic Drone a just-intoned stack whose partials shift against each other additive drifting
Metal Drone inharmonic modal bank with the loss nearly off modal metallic drifting
Tube Drone noise-excited waveguide, endless, breathing waveguide tube breathy
Shimmer high and glassy, moving too slowly to track additive glassy drifting

Spaces

Patch What it is Tags
Room Tone the diffuse network with almost nothing happening in it particle noisy
Large Hall the same room, further away — distance doing the work particle noisy
Deep Space lows and highs with nothing in the middle noisy hollow
Machine Room a hum plus irregular clicks at low arrival density particle metallic
Underwater absorption turned up until only the bottom survives particle warm

Room Tone and Large Hall being one instrument at two distances is the
cleanest demonstration of the atmosphere model in the bank. Ship them as a
pair and say so in their descriptions.

Tension

Patch What it is Tags
Dread low inharmonic swell that never resolves modal metallic chaotic
Unease a detuned cluster beating slowly against itself additive drifting
Pulse Bed a slow throb under everything va rhythmic warm

Evolving

Patch What it is Tags
Slow Morph partials on unrelated slow LFOs — Morphing Pad's cousin with the harmony taken out additive drifting
Spectral Cloud dense partials drifting independently; no note is findable in it additive chaotic demo

Hybrid markers

Patch What it is Tags
Aeolian Harp wind exciting detuned strings — a real instrument that is also an ambience hybrid string breathy
Breathing Room a particle cloud arriving inside a modal body hybrid particle demo

Aeolian Harp is worth singling out. It is an actual instrument, played by
weather, and it sits exactly on the seam between this category and Nature:
noise exciting strings is both a physical model and an ambience. It also
answers "what does cross-engine layering buy" with something that exists
rather than something invented.

Ships thin first

Low Drone, Harmonic Drone, Metal Drone, Room Tone, Large Hall, Deep Space,
Machine Room, Dread, Slow Morph.

Two non-gaps, recorded because they looked like gaps

  • Modulation is slow enough. The slowest LFO period is a day, so nothing
    in this category can audibly cycle. Evolution over minutes is ordinary
    patch data.
  • Randomness is available at note-on: two voice-level random values and
    two per layer — eighteen LFO slots across eight layers. Non-repetition is
    authoring work here, not an engine request.

Gaps and needs

  • Free-running modulation. An atmosphere must not restart its evolution
    every time a note arrives: the bed is continuous and the notes are
    incidental. Free-run channels have come up before as a concept; this is the
    category that requires them.
  • A granular source, as distinct from the granular processor the schema
    lists under Effects. Spectral Cloud and a proper granular wash want
    grains from a sample, and the sample slot plus particle bursts may already
    be most of that — worth checking before specifying anything.
  • Long tails versus voice stealing, as in Pad, and worse here: these
    patches are held for minutes.
## Category 13 — Atmosphere The test from `Pad` decides membership: if it would sound substantially the same whatever was played, it belongs here. A pad is a chordal instrument that happens to be slow; this is furniture, and being furniture is the point. Two engines carry most of it. **Additive** does drones that evolve without repeating, because independent per-partial motion has no cycle. **The particle engine** does everything made of events rather than tones — and `materials/atmosphere.h` makes distance a patch parameter rather than a reverb setting: one authored number produces the absorption, the arrival curve and the direct/diffuse balance together. A thing heard from far away is genuinely a different patch from the same thing heard close, and this bank can state that instead of approximating it with a send. ### Drones | Patch | What it is | Tags | |---|---|---| | Low Drone | sub with slow partial movement above it; felt more than heard | `additive` `warm` `drifting` | | Harmonic Drone | a just-intoned stack whose partials shift against each other | `additive` `drifting` | | Metal Drone | inharmonic modal bank with the loss nearly off | `modal` `metallic` `drifting` | | Tube Drone | noise-excited waveguide, endless, breathing | `waveguide` `tube` `breathy` | | Shimmer | high and glassy, moving too slowly to track | `additive` `glassy` `drifting` | ### Spaces | Patch | What it is | Tags | |---|---|---| | Room Tone | the diffuse network with almost nothing happening in it | `particle` `noisy` | | Large Hall | the same room, further away — distance doing the work | `particle` `noisy` | | Deep Space | lows and highs with nothing in the middle | `noisy` `hollow` | | Machine Room | a hum plus irregular clicks at low arrival density | `particle` `metallic` | | Underwater | absorption turned up until only the bottom survives | `particle` `warm` | `Room Tone` and `Large Hall` being one instrument at two distances is the cleanest demonstration of the atmosphere model in the bank. Ship them as a pair and say so in their descriptions. ### Tension | Patch | What it is | Tags | |---|---|---| | Dread | low inharmonic swell that never resolves | `modal` `metallic` `chaotic` | | Unease | a detuned cluster beating slowly against itself | `additive` `drifting` | | Pulse Bed | a slow throb under everything | `va` `rhythmic` `warm` | ### Evolving | Patch | What it is | Tags | |---|---|---| | Slow Morph | partials on unrelated slow LFOs — `Morphing Pad`'s cousin with the harmony taken out | `additive` `drifting` | | Spectral Cloud | dense partials drifting independently; no note is findable in it | `additive` `chaotic` `demo` | ### Hybrid markers | Patch | What it is | Tags | |---|---|---| | Aeolian Harp | wind exciting detuned strings — a real instrument that is also an ambience | `hybrid` `string` `breathy` | | Breathing Room | a particle cloud arriving inside a modal body | `hybrid` `particle` `demo` | `Aeolian Harp` is worth singling out. It is an actual instrument, played by weather, and it sits exactly on the seam between this category and `Nature`: noise exciting strings is both a physical model and an ambience. It also answers "what does cross-engine layering buy" with something that exists rather than something invented. ### Ships thin first Low Drone, Harmonic Drone, Metal Drone, Room Tone, Large Hall, Deep Space, Machine Room, Dread, Slow Morph. ### Two non-gaps, recorded because they looked like gaps - **Modulation is slow enough.** The slowest LFO period is a day, so nothing in this category can audibly cycle. Evolution over minutes is ordinary patch data. - **Randomness is available at note-on**: two voice-level random values and two per layer — eighteen LFO slots across eight layers. Non-repetition is authoring work here, not an engine request. ### Gaps and needs - **Free-running modulation.** An atmosphere must not restart its evolution every time a note arrives: the bed is continuous and the notes are incidental. Free-run channels have come up before as a concept; this is the category that requires them. - **A granular source**, as distinct from the granular *processor* the schema lists under `Effects`. `Spectral Cloud` and a proper granular wash want grains from a sample, and the sample slot plus particle bursts may already be most of that — worth checking before specifying anything. - **Long tails versus voice stealing**, as in `Pad`, and worse here: these patches are held for minutes.
Author
Owner

Category 14 — Nature & Environment

The particle engine is the backbone here the way modal is in Mallets. Rain
is arrivals on a surface, fire is arrivals with a different burst, applause is
arrivals shaped like hands, insects are arrivals with a rate. One engine, six
instruments, and the distance model decides how far away all of it is.

Weather

Patch What it is Tags
Wind noise with slowly moving resonances — the edges it passes, not the air noisy breathy drifting
Gale louder, with whistling where the resonances narrow noisy chaotic
Rain arrivals on a surface; the surface is as much the patch as the rate particle noisy
Downpour the same instrument with the density up and the distance in particle noisy
Thunder a low rumble whose shape is its distance; build on the existing thunder research rather than from scratch particle warm

Water

Patch What it is Tags
Drip one bubble: a short tone that rises in pitch as it dies particle clean
Stream many of those, at many sizes particle noisy
Waves slow noise swells with a long shape noisy warm drifting

A bubble rings at a frequency set by its size, and the familiar plink rises in
pitch as the bubble collapses. Standard bubble acoustics, passed along rather
than measured here, and recorded because it is an authoring instruction: a
water drop is a pitched event with an upward sweep, not a filtered click.
Built as a click it will sound like a click forever. It is also an ideal
particle burst — one small waveform scattered at many sizes and rates gives
drip, stream and rain from the same layer.

Fire

Patch What it is Tags
Campfire crackle arrivals over a low hiss particle wooden noisy
Torch smaller, windier, closer particle noisy

Life

Patch What it is Tags
Birdsong one chirp — a fast frequency sweep with a body fm clean bright
Dawn Chorus many birds at many distances particle bright
Crickets stridulation: a pulse train with a rate particle metallic
Cicadas denser, shimmering, almost a texture particle noisy
Frogs a short resonant croak, irregular particle hollow
Rattlesnake already exists; a rattle is a particle instrument particle noisy
Swarm many small tone sources moving past each other particle chaotic

Birdsong raises the strum question in a new place. A convincing bird is a
phrase — chirps in a rhythm with a contour — and under the existing ruling
a phrase is a part rather than a patch. So the patch is one chirp and the
song belongs in a song. That is the fourth time an answer has landed outside
a .tymp, and this one differs from the others: it suggests the library
might eventually ship parts as well as patches, which is a content question
rather than a format one.

Human and machine

Patch What it is Tags
Applause the canonical particle patch: claps as arrivals, distance for the size of the room particle noisy
Helicopter already exists: three unrelated noise processes at three rates noisy rhythmic
Passing Car doppler over a broadband engine note noisy drifting
Engine Idle a periodic impulse train through a resonant body noisy rhythmic
Train rhythmic impacts at a distance, with the distance changing particle rhythmic
Chainsaw a two-stroke note that sags under load and screams when it is free noisy gritty expressive

Machines belong here rather than in Atmosphere because they are objects —
a helicopter passes, a car goes by, someone is holding the chainsaw. Not
every machine is a vehicle, and the chainsaw is the one to keep in mind: a
working tool whose sound tracks what it is doing, which makes load a
continuous control and the patch genuinely expressive rather than a loop. The bed
a machine makes, a room of humming equipment, stays in Atmosphere under the
same test that separates a pad from a drone. This is why the row reads
Nature & Environment.

Hybrid markers

Patch What it is Tags
Wind Chimes wind exciting tuned bars — a real object, and two engines by construction hybrid particle bar
Ice cracking: sparse arrivals into a plate that rings after each one hybrid particle plate

Wind Chimes is this category's Dobro: a real thing that happens to be a
noise source driving a modal bank, so the cross-engine structure is the
instrument rather than a flourish.

Ships thin first

Wind, Rain, Thunder, Stream, Campfire, Birdsong, Crickets, Applause, Wind
Chimes.

Gaps and needs

  • Burst variety. Fire crackles and rain drops are not one waveform
    scattered: a fire has small ticks and occasional pops, and rain on a roof
    differs from rain on leaves. How much variety one particle layer's retained
    burst allows decides whether these are one patch or several layers.
  • Doppler. Swarm and anything passing want a moving delay. Probably
    expressible; not claimed here.
  • Parts, not just patches. Birdsong, and to a lesser extent crickets and
    applause, are phrases. The library may eventually want demo parts alongside
    demo patches. Recorded because the question has now arrived from four
    directions.
  • Distance is a strength, not a gap, and this is the category that shows
    it: thunder, dawn chorus and applause are the same instrument at different
    removes.
## Category 14 — Nature & Environment The particle engine is the backbone here the way modal is in `Mallets`. Rain is arrivals on a surface, fire is arrivals with a different burst, applause is arrivals shaped like hands, insects are arrivals with a rate. One engine, six instruments, and the distance model decides how far away all of it is. ### Weather | Patch | What it is | Tags | |---|---|---| | Wind | noise with slowly moving resonances — the edges it passes, not the air | `noisy` `breathy` `drifting` | | Gale | louder, with whistling where the resonances narrow | `noisy` `chaotic` | | Rain | arrivals on a surface; the surface is as much the patch as the rate | `particle` `noisy` | | Downpour | the same instrument with the density up and the distance in | `particle` `noisy` | | Thunder | a low rumble whose shape is its distance; build on the existing thunder research rather than from scratch | `particle` `warm` | ### Water | Patch | What it is | Tags | |---|---|---| | Drip | one bubble: a short tone that rises in pitch as it dies | `particle` `clean` | | Stream | many of those, at many sizes | `particle` `noisy` | | Waves | slow noise swells with a long shape | `noisy` `warm` `drifting` | A bubble rings at a frequency set by its size, and the familiar plink rises in pitch as the bubble collapses. Standard bubble acoustics, passed along rather than measured here, and recorded because it is an authoring instruction: a water drop is a *pitched* event with an upward sweep, not a filtered click. Built as a click it will sound like a click forever. It is also an ideal particle burst — one small waveform scattered at many sizes and rates gives drip, stream and rain from the same layer. ### Fire | Patch | What it is | Tags | |---|---|---| | Campfire | crackle arrivals over a low hiss | `particle` `wooden` `noisy` | | Torch | smaller, windier, closer | `particle` `noisy` | ### Life | Patch | What it is | Tags | |---|---|---| | Birdsong | one chirp — a fast frequency sweep with a body | `fm` `clean` `bright` | | Dawn Chorus | many birds at many distances | `particle` `bright` | | Crickets | stridulation: a pulse train with a rate | `particle` `metallic` | | Cicadas | denser, shimmering, almost a texture | `particle` `noisy` | | Frogs | a short resonant croak, irregular | `particle` `hollow` | | Rattlesnake | already exists; a rattle is a particle instrument | `particle` `noisy` | | Swarm | many small tone sources moving past each other | `particle` `chaotic` | `Birdsong` raises the strum question in a new place. A convincing bird is a *phrase* — chirps in a rhythm with a contour — and under the existing ruling a phrase is a part rather than a patch. So the patch is one chirp and the song belongs in a song. That is the fourth time an answer has landed outside a `.tymp`, and this one differs from the others: it suggests the library might eventually ship *parts* as well as patches, which is a content question rather than a format one. ### Human and machine | Patch | What it is | Tags | |---|---|---| | Applause | the canonical particle patch: claps as arrivals, distance for the size of the room | `particle` `noisy` | | Helicopter | already exists: three unrelated noise processes at three rates | `noisy` `rhythmic` | | Passing Car | doppler over a broadband engine note | `noisy` `drifting` | | Engine Idle | a periodic impulse train through a resonant body | `noisy` `rhythmic` | | Train | rhythmic impacts at a distance, with the distance changing | `particle` `rhythmic` | | Chainsaw | a two-stroke note that sags under load and screams when it is free | `noisy` `gritty` `expressive` | Machines belong here rather than in `Atmosphere` because they are *objects* — a helicopter passes, a car goes by, someone is holding the chainsaw. Not every machine is a vehicle, and the chainsaw is the one to keep in mind: a working tool whose sound tracks what it is doing, which makes load a continuous control and the patch genuinely expressive rather than a loop. The bed a machine makes, a room of humming equipment, stays in `Atmosphere` under the same test that separates a pad from a drone. This is why the row reads `Nature & Environment`. ### Hybrid markers | Patch | What it is | Tags | |---|---|---| | Wind Chimes | wind exciting tuned bars — a real object, and two engines by construction | `hybrid` `particle` `bar` | | Ice | cracking: sparse arrivals into a plate that rings after each one | `hybrid` `particle` `plate` | `Wind Chimes` is this category's `Dobro`: a real thing that happens to be a noise source driving a modal bank, so the cross-engine structure is the instrument rather than a flourish. ### Ships thin first Wind, Rain, Thunder, Stream, Campfire, Birdsong, Crickets, Applause, Wind Chimes. ### Gaps and needs - **Burst variety.** Fire crackles and rain drops are not one waveform scattered: a fire has small ticks and occasional pops, and rain on a roof differs from rain on leaves. How much variety one particle layer's retained burst allows decides whether these are one patch or several layers. - **Doppler.** `Swarm` and anything passing want a moving delay. Probably expressible; not claimed here. - **Parts, not just patches.** Birdsong, and to a lesser extent crickets and applause, are phrases. The library may eventually want demo parts alongside demo patches. Recorded because the question has now arrived from four directions. - **Distance is a strength, not a gap**, and this is the category that shows it: thunder, dawn chorus and applause are the same instrument at different removes.
Author
Owner

Category 15 — Hits & Risers

The first category since Lead with no acoustic referent anywhere in it, and
the only one whose patches are measured in bars. A riser is four bars long
or it is useless, which makes tempo this category's precondition.

These patches must take their length from the transport. A riser authored
in seconds is right at one tempo and wrong at every other, so envelope times
and LFO rates need a tempo-relative mode. The fabric knows the tempo and the
transport position; whether a patch can reach them is the open question.

One-shot envelopes already exist, which settles the other half: a riser is
triggered rather than held, and the patch runs to completion whatever the key
does.

Risers

Patch What it is Tags
Noise Riser filtered noise with cutoff and resonance climbing together va noisy rhythmic
Tonal Riser a pitched sweep with the harmonics spreading as it goes va bright
Shepard Riser a rise that never arrives — Shepard already exists, so this is placement rather than new work additive demo
Swarm Riser particle density climbing into the downbeat particle chaotic

A true Shepard–Risset glissando is a fixed spectral envelope with partials
sliding upward through it, fading in at the bottom and out at the top — a
statement about partial amplitudes and frequencies, which is what the
additive engine takes as input. Other synths approximate it with three
detuned oscillators and a crossfade.

Downlifters

Patch What it is Tags
Downlifter the riser reversed, and shorter, because falls are va noisy
Shepard Fall the same trick going the other way additive demo
Sub Drop pitch falling out of hearing, felt after it is gone va warm

Impacts

Patch What it is Tags
Impact low boom, metallic transient, long tail — three layers doing three jobs hybrid metallic
Braam the massive detuned brass cluster hybrid brass wide
Hit Stab the orchestral hit: short, loud, gone hybrid bright
Metal Crash a plate driven far harder than a cymbal would be modal plate chaotic

Braam is hybrid by necessity: a detuned brass stack over a sub with a modal
tail is three engines and the sound does not exist without all three. It is
also the most expensive patch in the bank by voice count, which makes it a
useful stress case.

Transitions

Patch What it is Tags
Whoosh noise sweeping across the stereo field noisy wide
Reverse Cymbal slow attack into the downbeat; a plate played backwards modal plate
Riser to Impact one key, the whole transition: four bars of rise and the hit at the end hybrid demo rhythmic
Glitch Burst short, digital, deliberately broken va chaotic

Riser to Impact is the gesture people actually want. Nobody wants a riser;
they want a transition, and they currently build it from two patches and a
lot of nudging. One patch spanning the bar line is a small idea that saves
real work.

Stingers

Patch What it is Tags
Sting a short dramatic chord with a tail hybrid metallic
Alarm two tones alternating; deliberately unpleasant va gritty rhythmic

Ships thin first

Noise Riser, Tonal Riser, Shepard Riser, Downlifter, Sub Drop, Impact, Braam,
Whoosh, Reverse Cymbal.

Gaps and needs

  • Tempo-relative envelope and LFO times. The category's one precondition.
  • Level discipline across the bank. These are the loudest patches in the
    library by a wide margin, and auditioning from Warm Pad to Impact at
    one gain will hurt someone. A target loudness per category is a bank-wide
    authoring convention rather than a per-patch decision, and this is the
    category that forces it. Worth writing into the schema rather than
    discovering it in a listening session.
  • Tape stop wants a variable playback rate; the sample slot may already
    provide it.
  • Braam's voice count is the bank's worst case — useful as a deliberate
    stress patch, provided the degradation ladder handles it gracefully rather
    than by stuttering.
## Category 15 — Hits & Risers The first category since `Lead` with no acoustic referent anywhere in it, and the only one whose patches are measured in *bars*. A riser is four bars long or it is useless, which makes tempo this category's precondition. **These patches must take their length from the transport.** A riser authored in seconds is right at one tempo and wrong at every other, so envelope times and LFO rates need a tempo-relative mode. The fabric knows the tempo and the transport position; whether a patch can reach them is the open question. **One-shot envelopes already exist**, which settles the other half: a riser is triggered rather than held, and the patch runs to completion whatever the key does. ### Risers | Patch | What it is | Tags | |---|---|---| | Noise Riser | filtered noise with cutoff and resonance climbing together | `va` `noisy` `rhythmic` | | Tonal Riser | a pitched sweep with the harmonics spreading as it goes | `va` `bright` | | Shepard Riser | a rise that never arrives — Shepard already exists, so this is placement rather than new work | `additive` `demo` | | Swarm Riser | particle density climbing into the downbeat | `particle` `chaotic` | A true Shepard–Risset glissando is a *fixed* spectral envelope with partials sliding upward through it, fading in at the bottom and out at the top — a statement about partial amplitudes and frequencies, which is what the additive engine takes as input. Other synths approximate it with three detuned oscillators and a crossfade. ### Downlifters | Patch | What it is | Tags | |---|---|---| | Downlifter | the riser reversed, and shorter, because falls are | `va` `noisy` | | Shepard Fall | the same trick going the other way | `additive` `demo` | | Sub Drop | pitch falling out of hearing, felt after it is gone | `va` `warm` | ### Impacts | Patch | What it is | Tags | |---|---|---| | Impact | low boom, metallic transient, long tail — three layers doing three jobs | `hybrid` `metallic` | | Braam | the massive detuned brass cluster | `hybrid` `brass` `wide` | | Hit Stab | the orchestral hit: short, loud, gone | `hybrid` `bright` | | Metal Crash | a plate driven far harder than a cymbal would be | `modal` `plate` `chaotic` | `Braam` is hybrid by necessity: a detuned brass stack over a sub with a modal tail is three engines and the sound does not exist without all three. It is also the most expensive patch in the bank by voice count, which makes it a useful stress case. ### Transitions | Patch | What it is | Tags | |---|---|---| | Whoosh | noise sweeping across the stereo field | `noisy` `wide` | | Reverse Cymbal | slow attack into the downbeat; a plate played backwards | `modal` `plate` | | Riser to Impact | one key, the whole transition: four bars of rise and the hit at the end | `hybrid` `demo` `rhythmic` | | Glitch Burst | short, digital, deliberately broken | `va` `chaotic` | `Riser to Impact` is the gesture people actually want. Nobody wants a riser; they want a transition, and they currently build it from two patches and a lot of nudging. One patch spanning the bar line is a small idea that saves real work. ### Stingers | Patch | What it is | Tags | |---|---|---| | Sting | a short dramatic chord with a tail | `hybrid` `metallic` | | Alarm | two tones alternating; deliberately unpleasant | `va` `gritty` `rhythmic` | ### Ships thin first Noise Riser, Tonal Riser, Shepard Riser, Downlifter, Sub Drop, Impact, Braam, Whoosh, Reverse Cymbal. ### Gaps and needs - **Tempo-relative envelope and LFO times.** The category's one precondition. - **Level discipline across the bank.** These are the loudest patches in the library by a wide margin, and auditioning from `Warm Pad` to `Impact` at one gain will hurt someone. A target loudness per category is a bank-wide authoring convention rather than a per-patch decision, and this is the category that forces it. Worth writing into the schema rather than discovering it in a listening session. - **Tape stop** wants a variable playback rate; the sample slot may already provide it. - **Braam's voice count** is the bank's worst case — useful as a deliberate stress patch, provided the degradation ladder handles it gracefully rather than by stuttering.
Author
Owner

Category 16 — Abstract

This category needs a membership test more than it needs a long list, because
without one it becomes the drawer everything difficult gets put in.

The test: a knowledgeable listener cannot name the family. If someone says
"that is a weird bell", it is Mallets. If they say "that is a bowed
something", it is Strings. Abstract is for the patches where the honest
answer is I do not know what that is. A patch that lands here because
nobody could be bothered to decide is a filing error rather than a sound
design choice.

This category is also deliberately under-specified. The planned
cross-engine session will produce exactly this kind of patch and most of its
output will land here, so planning eighteen abstract patches in advance would
be guessing at what that session discovers. What follows is a spine.

The spine

Patch What it is Tags
Inharmonic Cloud partials at ratios with no relationship to each other additive chaotic
Morphing Material a modal material interpolating string → bar → plate while it sounds modal demo drifting
Feedback Web FM feedback run at the edge of instability fm chaotic gritty
Growl Engine the CS-80 technique past the point of music: cutoff modulated at audio rates until the resonance is the instrument va gritty demo
Spectral Freeze a spectrum held indefinitely with nothing sustaining it additive static
Data Stream sample-and-hold into everything at once va chaotic rhythmic
Impossible Tube waveguide parameters no physical tube could have waveguide hollow demo
Machine Voice the unvoiced formant layer with no voiced source under it unvoiced vocal noisy

Morphing Material is the one to build first. The materials system turns
authored numbers into mode tables, so interpolating between materials
mid-note is natural here and nearly impossible elsewhere — a struck object
becoming a different kind of object while it rings. It is also the clearest
demonstration of why the material generators exist.

Ships thin first

Five is plenty: Inharmonic Cloud, Morphing Material, Feedback Web, Growl
Engine, Spectral Freeze. The category should stay small until the
cross-engine session fills it.

Gaps and needs

  • Nothing, engine-wise — worth recording. The only category in the schema
    with no outstanding engine request, because it is defined by using what
    exists in ways nobody intended.
  • Ratio discipline is the real risk. A bank with forty abstract patches
    and nine pianos is a tech demo rather than an instrument. This should be
    among the smallest categories, and it will be the most tempting to grow,
    because these are the most fun patches to make.
  • Names carry the whole load here. Every other category tells you what a
    patch is before you load it; this one tells you nothing. If the names are
    not evocative and the tags are not honest, nobody will audition these
    twice.
## Category 16 — Abstract This category needs a membership test more than it needs a long list, because without one it becomes the drawer everything difficult gets put in. **The test: a knowledgeable listener cannot name the family.** If someone says "that is a weird bell", it is `Mallets`. If they say "that is a bowed something", it is `Strings`. `Abstract` is for the patches where the honest answer is *I do not know what that is*. A patch that lands here because nobody could be bothered to decide is a filing error rather than a sound design choice. This category is also **deliberately under-specified**. The planned cross-engine session will produce exactly this kind of patch and most of its output will land here, so planning eighteen abstract patches in advance would be guessing at what that session discovers. What follows is a spine. ### The spine | Patch | What it is | Tags | |---|---|---| | Inharmonic Cloud | partials at ratios with no relationship to each other | `additive` `chaotic` | | Morphing Material | a modal material interpolating string → bar → plate *while it sounds* | `modal` `demo` `drifting` | | Feedback Web | FM feedback run at the edge of instability | `fm` `chaotic` `gritty` | | Growl Engine | the CS-80 technique past the point of music: cutoff modulated at audio rates until the resonance is the instrument | `va` `gritty` `demo` | | Spectral Freeze | a spectrum held indefinitely with nothing sustaining it | `additive` `static` | | Data Stream | sample-and-hold into everything at once | `va` `chaotic` `rhythmic` | | Impossible Tube | waveguide parameters no physical tube could have | `waveguide` `hollow` `demo` | | Machine Voice | the unvoiced formant layer with no voiced source under it | `unvoiced` `vocal` `noisy` | `Morphing Material` is the one to build first. The materials system turns authored numbers into mode tables, so interpolating *between* materials mid-note is natural here and nearly impossible elsewhere — a struck object becoming a different kind of object while it rings. It is also the clearest demonstration of why the material generators exist. ### Ships thin first Five is plenty: Inharmonic Cloud, Morphing Material, Feedback Web, Growl Engine, Spectral Freeze. The category should stay small until the cross-engine session fills it. ### Gaps and needs - **Nothing, engine-wise** — worth recording. The only category in the schema with no outstanding engine request, because it is defined by using what exists in ways nobody intended. - **Ratio discipline is the real risk.** A bank with forty abstract patches and nine pianos is a tech demo rather than an instrument. This should be among the smallest categories, and it will be the most tempting to grow, because these are the most fun patches to make. - **Names carry the whole load here.** Every other category tells you what a patch is before you load it; this one tells you nothing. If the names are not evocative and the tags are not honest, nobody will audition these twice.
Author
Owner

Category 17 — Utility

The one category where "sounds good" is not the criterion. A utility patch is
correct or it is not, and its value is that its output can be trusted without
being measured first.

Reference tones

Patch What it is Tags
Sine one partial, tracking the keyboard, at a documented level additive clean
Saw full harmonic series, band-limited, documented level va clean
Square odd harmonics only va hollow
Triangle the quiet one, for checking noise floors va clean
Pulse fixed width, for measuring what a width control does elsewhere va hollow
A440 fixed pitch regardless of key — a tuning reference, not an instrument additive static

Noise

Patch What it is Tags
White Noise flat per hertz noisy
Pink Noise flat per octave; the one for level matching and room work noisy
Brown Noise the low one noisy

Test signals

Patch What it is Tags
Impulse one sample, full scale, nothing else clean
Sweep logarithmic sine sweep, the standard measurement signal clean
Click Train periodic impulses, for latency and timing checks rhythmic
Silence emits nothing, deliberately — a placeholder for an empty channel static

Sweep and Impulse are what earn this category its place in the browser.
When Effects exists they are how anyone finds out what a reverb or a
resonator actually does, and they are the difference between "that sounds
about right" and a measurement.

Silence sounds like a joke and is not. A channel routed, armed and
occupying its strip without making a sound is a real thing to want, and the
alternative is everyone rolling their own.

Raw engines

Patch What it is Tags
Raw Additive one layer, default parameters, nothing hiding it additive demo
Raw FM the pair with no envelope shaping fm demo
Raw VA one oscillator through one filter va demo
Raw Waveguide a string with a plain exciter waveguide demo
Raw Modal one material, struck once modal demo
Raw Particle arrivals with no body and no distance particle demo
Raw Unvoiced the formant layer by itself unvoiced demo

The cheapest teaching material the bank can carry. Someone learning what this
instrument is gets further hearing each engine naked than reading anything,
and these are also the first place to look when something sounds wrong and it
is not yet clear which layer is lying.

Ships thin first

Sine, Saw, Square, White Noise, Pink Noise, Impulse, Sweep, Silence, A440.
The raw-engine set follows as a block, since it is only useful complete.

Gaps and needs

  • Documented levels are the whole point. "A saw at a known level" is
    worthless if the number is not written where a user can read it. Every
    patch here needs its output level in its description, in dBFS, measured
    rather than intended. The Hits & Risers level-discipline item arriving as
    a hard requirement instead of a convention.
  • Two of these can hurt someone. Impulse at full scale and any of the
    noises at monitoring volume are genuinely unpleasant on headphones. Whether
    that is handled by naming, by level, or by browse order is a decision worth
    making on purpose.
  • A utility patch used as a test fixture is frozen by that use. These are
    the obvious oracles for the suite — a known sine, a known impulse — and
    once one is used that way, changing it breaks tests. Fine, but it should be
    a deliberate choice recorded in the patch rather than discovered later by a
    broken golden.
  • No DC. A DC test signal is genuinely useful and genuinely dangerous to
    speakers. Excluded on purpose, recorded so the omission reads as a decision
    rather than an oversight.
## Category 17 — Utility The one category where "sounds good" is not the criterion. A utility patch is correct or it is not, and its value is that its output can be trusted without being measured first. ### Reference tones | Patch | What it is | Tags | |---|---|---| | Sine | one partial, tracking the keyboard, at a documented level | `additive` `clean` | | Saw | full harmonic series, band-limited, documented level | `va` `clean` | | Square | odd harmonics only | `va` `hollow` | | Triangle | the quiet one, for checking noise floors | `va` `clean` | | Pulse | fixed width, for measuring what a width control does elsewhere | `va` `hollow` | | A440 | fixed pitch regardless of key — a tuning reference, not an instrument | `additive` `static` | ### Noise | Patch | What it is | Tags | |---|---|---| | White Noise | flat per hertz | `noisy` | | Pink Noise | flat per octave; the one for level matching and room work | `noisy` | | Brown Noise | the low one | `noisy` | ### Test signals | Patch | What it is | Tags | |---|---|---| | Impulse | one sample, full scale, nothing else | `clean` | | Sweep | logarithmic sine sweep, the standard measurement signal | `clean` | | Click Train | periodic impulses, for latency and timing checks | `rhythmic` | | Silence | emits nothing, deliberately — a placeholder for an empty channel | `static` | `Sweep` and `Impulse` are what earn this category its place in the browser. When `Effects` exists they are how anyone finds out what a reverb or a resonator actually does, and they are the difference between "that sounds about right" and a measurement. `Silence` sounds like a joke and is not. A channel routed, armed and occupying its strip without making a sound is a real thing to want, and the alternative is everyone rolling their own. ### Raw engines | Patch | What it is | Tags | |---|---|---| | Raw Additive | one layer, default parameters, nothing hiding it | `additive` `demo` | | Raw FM | the pair with no envelope shaping | `fm` `demo` | | Raw VA | one oscillator through one filter | `va` `demo` | | Raw Waveguide | a string with a plain exciter | `waveguide` `demo` | | Raw Modal | one material, struck once | `modal` `demo` | | Raw Particle | arrivals with no body and no distance | `particle` `demo` | | Raw Unvoiced | the formant layer by itself | `unvoiced` `demo` | The cheapest teaching material the bank can carry. Someone learning what this instrument is gets further hearing each engine naked than reading anything, and these are also the first place to look when something sounds wrong and it is not yet clear which layer is lying. ### Ships thin first Sine, Saw, Square, White Noise, Pink Noise, Impulse, Sweep, Silence, A440. The raw-engine set follows as a block, since it is only useful complete. ### Gaps and needs - **Documented levels are the whole point.** "A saw at a known level" is worthless if the number is not written where a user can read it. Every patch here needs its output level in its description, in dBFS, measured rather than intended. The `Hits & Risers` level-discipline item arriving as a hard requirement instead of a convention. - **Two of these can hurt someone.** `Impulse` at full scale and any of the noises at monitoring volume are genuinely unpleasant on headphones. Whether that is handled by naming, by level, or by browse order is a decision worth making on purpose. - **A utility patch used as a test fixture is frozen by that use.** These are the obvious oracles for the suite — a known sine, a known impulse — and once one is used that way, changing it breaks tests. Fine, but it should be a deliberate choice recorded in the patch rather than discovered later by a broken golden. - **No DC.** A DC test signal is genuinely useful and genuinely dangerous to speakers. Excluded on purpose, recorded so the omission reads as a decision rather than an oversight.
Author
Owner

Category 18 — Effects

This list exists to produce requirements as much as patches, so the
architecture comes first and the patches justify it.

What is already decided and already there

  • Two kinds of effect. Small ones are mixer inserts. Large ones are
    new layer engines that process their inputs, markable as having an
    "always open" gate so they run whether or not a note is held.
  • A large effect takes its input either from other layers in the same
    voice or from the channel's audio input.
  • A channel that accepts audio input exists today. Inter-channel routing,
    sends and inter-layer taps that can feed back are all present, and most
    engines can process external input — a VA oscillator type among them. This
    category is therefore not gated on new plumbing.
  • Effects receive note events for free, because an effect layer lives in a
    voice. A played resonator — audio in, tuned from the keyboard — needs
    nothing new.
  • Storage is reserved at patch load from a shared region and lent to the
    layer. Delay lines and reverb tails never allocate on a note.

What this list still asks for

  1. A second input, for the genuinely two-input effects: a vocoder's
    carrier and modulator, a compressor's sidechain.
  2. An envelope follower on an input. Auto-wah, compressor, gate and
    ducking are four effects over one mechanism.
  3. Tempo-relative times, the same requirement Hits & Risers raised.
    Delays and rhythmic tremolo are unusable without it.
  4. Latency reporting. Spectral processing and lookahead limiting cost
    delay and the host has to be told honestly. Mostly a requirement of the
    spectral group below, which is why that group is a later wave.
  5. Bit-exact bypass. dsp/layer_strip.h set the precedent — unity gain is
    bit-exact. An effect at zero wet should be sample-identical to no effect,
    which is a testable property rather than an aspiration.
  6. Feedback discipline in fixed point. Delay and reverb feedback is where
    overflow and limit cycles are found. dsp/fixed.h's rule — kTowardZero,
    so requantization is a contraction — is what makes a decaying tail reach
    zero, and every structure here inherits it.

The order the instrument list already chose

The first nine effects are not a matter of taste. Seventeen categories named
patches that are incomplete without a specific processor:

Blocked patch Needs How badly
Drawbar Organ, Full Organ rotary constitutive — a Hammond without one is not a Hammond
Clean Electric amp and cab constitutive — otherwise it is a DI take
Clavinet wah constitutive for Superstition; the instrument survives dry
Solina BBD chorus constitutive — otherwise it is a buzzy organ
80s snare gated reverb the gate is the sound
every lead tempo-synced delay identity, not decoration
Marimba, strings, kit room improvement, not identity
Tine EP, Reed EP tremolo, phaser improvement

Anything not on that list is a second wave.

Reverbs

Patch What it is Tags
Room small and short, for making dry patches sit clean
Hall the long one clean wide
Plate a modal plate driven by the input rather than by a note modal plate metallic
Spring dispersive delay lines — the boing is dispersion, not decay waveguide metallic
Gated the 80s snare's other half noisy
Shimmer pitch-shifted feedback; the tail rises forever glassy demo

Plate and Spring are the signature members. Every other synth's plate
reverb imitates a plate; this one can be the plate — the same modal
machinery as Steel Drum and Crash, excited by audio instead of a mallet.
The strongest argument in the schema for effects being layer engines rather
than a bolted-on rack.

Delays

Patch What it is Tags
Digital Delay clean, tempo-synced, the default clean rhythmic
Tape Delay wow, flutter, saturation, a darkening tail gritty drifting
Ping-Pong the stereo one wide rhythmic
Multi-tap irregular taps; rhythm from an effect rhythmic
Diffuse Delay each repeat blurrier than the last noisy drifting

Modulation

Patch What it is Tags
Rotary two rotors at different speeds, doppler and amplitude together, plus the cabinet drifting
Chorus BBD: the delay is noisy and dark on purpose warm wide
Ensemble the Solina's three-phase chorus, which is not the same thing wide
Flanger short delay, deep feedback metallic
Phaser allpass stages, no delay at all hollow
Tremolo amplitude, tempo-syncable rhythmic
Vibrato pitch; the electric piano's other half drifting

Rotary deserves doing properly rather than as a tremolo with a filter: two
physically separate rotating sources at different speeds, accelerating at
different rates when the speed changes. The ramp between slow and fast is
most of what people love about it.

Saturation and destruction

Patch What it is Tags
Amp + Cab Clean Electric's missing half gritty
Tube even harmonics, soft knee warm
Tape compression and a top-end roll-off together warm
Fuzz hard, rude, unsubtle gritty
Bitcrusher bit depth and sample rate, separately gritty chaotic
Wavefolder the West Coast one: more folds, more harmonics, no clipping metallic demo

Filters and voices

Patch What it is Tags
Auto-Wah envelope follower into a resonant peak — the clavinet's other half expressive
Filter LFO or macro driven, tempo-syncable macro
Vocoder carrier and modulator; the two-input case vocal
Talk Box a tube driven by the input, filtered by a tract waveguide vocal
Formant vowel shaping on anything vocal macro

Resonators — the distinctive ones

Patch What it is Tags
String Resonator a waveguide string bank excited by the input and tuned from the keyboard waveguide string demo
Plate Resonator the same idea on a plate: hit it with audio modal plate
Particle Space the input arriving as a cloud, at a distance particle noisy

String Resonator is the patch that explains this category to someone. Play a
drum loop through it, hold a chord, and the loop is playing that chord. An
effect layer already receives note events, so it needs nothing that does not
exist — and nothing else in this bank's competition has a tunable physical
resonator sitting in the effects path.

Spectral and granular

Patch What it is Tags
Granular Cloud the input as grains, scattered chaotic
Pitch Shifter the useful special case of the same machine clean
Spectral Freeze hold what is sounding now, indefinitely static demo
Spectral Blur smear across time without smearing pitch drifting

The likeliest second wave. They need an FFT on the audio path, which is a
different cost and latency shape from everything else here, and requirement 4
exists mostly for them.

Strip, not patches

Thing Where it belongs
Tilt EQ, compressor, gate, limiter the strip, always on, cheap
Stereo width, mid/side the strip
Reverb, delay, granular, resonators layer engines, loaded deliberately

Everything above the line stops being a preset at all, which is the right
outcome: nobody browses for a compressor the way they browse for a plate.

Ships thin first

Rotary, Amp + Cab, Auto-Wah, Chorus, Digital Delay, Tape Delay, Room, Hall,
Plate. Nine, and each one unblocks a patch already on this ticket.

Gaps and needs

The six requirements above, plus:

  • Hits & Risers versus Effects was settled by naming: a one-shot
    sweetener is a hit, and anything that processes its input is here. The one
    boundary in the schema that exists purely to prevent a collision.
  • A patch here may need a different browse shape. One primary category
    per patch works, but someone looking for a reverb wants to see reverbs
    rather than scroll past forty processors. Whether Effects needs
    sub-grouping is a browser question rather than a schema one — and it is the
    only category heterogeneous enough to raise it.
## Category 18 — Effects This list exists to produce requirements as much as patches, so the architecture comes first and the patches justify it. ### What is already decided and already there - **Two kinds of effect.** Small ones are **mixer inserts**. Large ones are **new layer engines that process their inputs**, markable as having an "always open" gate so they run whether or not a note is held. - **A large effect takes its input** either from other layers in the same voice or from the channel's audio input. - **A channel that accepts audio input exists today.** Inter-channel routing, sends and inter-layer taps that can feed back are all present, and most engines can process external input — a VA oscillator type among them. This category is therefore not gated on new plumbing. - **Effects receive note events for free**, because an effect layer lives in a voice. A *played* resonator — audio in, tuned from the keyboard — needs nothing new. - **Storage is reserved at patch load** from a shared region and lent to the layer. Delay lines and reverb tails never allocate on a note. ### What this list still asks for 1. **A second input**, for the genuinely two-input effects: a vocoder's carrier and modulator, a compressor's sidechain. 2. **An envelope follower on an input.** Auto-wah, compressor, gate and ducking are four effects over one mechanism. 3. **Tempo-relative times**, the same requirement `Hits & Risers` raised. Delays and rhythmic tremolo are unusable without it. 4. **Latency reporting.** Spectral processing and lookahead limiting cost delay and the host has to be told honestly. Mostly a requirement of the spectral group below, which is why that group is a later wave. 5. **Bit-exact bypass.** `dsp/layer_strip.h` set the precedent — unity gain is bit-exact. An effect at zero wet should be sample-identical to no effect, which is a testable property rather than an aspiration. 6. **Feedback discipline in fixed point.** Delay and reverb feedback is where overflow and limit cycles are found. `dsp/fixed.h`'s rule — `kTowardZero`, so requantization is a contraction — is what makes a decaying tail reach zero, and every structure here inherits it. ### The order the instrument list already chose The first nine effects are not a matter of taste. Seventeen categories named patches that are incomplete without a specific processor: | Blocked patch | Needs | How badly | |---|---|---| | `Drawbar Organ`, `Full Organ` | rotary | constitutive — a Hammond without one is not a Hammond | | `Clean Electric` | amp and cab | constitutive — otherwise it is a DI take | | `Clavinet` | wah | constitutive for *Superstition*; the instrument survives dry | | `Solina` | BBD chorus | constitutive — otherwise it is a buzzy organ | | 80s snare | gated reverb | the gate *is* the sound | | every lead | tempo-synced delay | identity, not decoration | | `Marimba`, strings, kit | room | improvement, not identity | | `Tine EP`, `Reed EP` | tremolo, phaser | improvement | Anything not on that list is a second wave. ### Reverbs | Patch | What it is | Tags | |---|---|---| | Room | small and short, for making dry patches sit | `clean` | | Hall | the long one | `clean` `wide` | | Plate | **a modal plate driven by the input** rather than by a note | `modal` `plate` `metallic` | | Spring | dispersive delay lines — the boing is dispersion, not decay | `waveguide` `metallic` | | Gated | the 80s snare's other half | `noisy` | | Shimmer | pitch-shifted feedback; the tail rises forever | `glassy` `demo` | `Plate` and `Spring` are the signature members. Every other synth's plate reverb imitates a plate; this one can *be* the plate — the same modal machinery as `Steel Drum` and `Crash`, excited by audio instead of a mallet. The strongest argument in the schema for effects being layer engines rather than a bolted-on rack. ### Delays | Patch | What it is | Tags | |---|---|---| | Digital Delay | clean, tempo-synced, the default | `clean` `rhythmic` | | Tape Delay | wow, flutter, saturation, a darkening tail | `gritty` `drifting` | | Ping-Pong | the stereo one | `wide` `rhythmic` | | Multi-tap | irregular taps; rhythm from an effect | `rhythmic` | | Diffuse Delay | each repeat blurrier than the last | `noisy` `drifting` | ### Modulation | Patch | What it is | Tags | |---|---|---| | Rotary | two rotors at different speeds, doppler and amplitude together, plus the cabinet | `drifting` | | Chorus | BBD: the delay is noisy and dark on purpose | `warm` `wide` | | Ensemble | the Solina's three-phase chorus, which is not the same thing | `wide` | | Flanger | short delay, deep feedback | `metallic` | | Phaser | allpass stages, no delay at all | `hollow` | | Tremolo | amplitude, tempo-syncable | `rhythmic` | | Vibrato | pitch; the electric piano's other half | `drifting` | Rotary deserves doing properly rather than as a tremolo with a filter: two physically separate rotating sources at different speeds, accelerating at different rates when the speed changes. The ramp between slow and fast is most of what people love about it. ### Saturation and destruction | Patch | What it is | Tags | |---|---|---| | Amp + Cab | `Clean Electric`'s missing half | `gritty` | | Tube | even harmonics, soft knee | `warm` | | Tape | compression and a top-end roll-off together | `warm` | | Fuzz | hard, rude, unsubtle | `gritty` | | Bitcrusher | bit depth and sample rate, separately | `gritty` `chaotic` | | Wavefolder | the West Coast one: more folds, more harmonics, no clipping | `metallic` `demo` | ### Filters and voices | Patch | What it is | Tags | |---|---|---| | Auto-Wah | envelope follower into a resonant peak — the clavinet's other half | `expressive` | | Filter | LFO or macro driven, tempo-syncable | `macro` | | Vocoder | carrier and modulator; the two-input case | `vocal` | | Talk Box | a tube driven by the input, filtered by a tract | `waveguide` `vocal` | | Formant | vowel shaping on anything | `vocal` `macro` | ### Resonators — the distinctive ones | Patch | What it is | Tags | |---|---|---| | String Resonator | a waveguide string bank excited by the input and tuned from the keyboard | `waveguide` `string` `demo` | | Plate Resonator | the same idea on a plate: hit it with audio | `modal` `plate` | | Particle Space | the input arriving as a cloud, at a distance | `particle` `noisy` | `String Resonator` is the patch that explains this category to someone. Play a drum loop through it, hold a chord, and the loop is playing that chord. An effect layer already receives note events, so it needs nothing that does not exist — and nothing else in this bank's competition has a tunable physical resonator sitting in the effects path. ### Spectral and granular | Patch | What it is | Tags | |---|---|---| | Granular Cloud | the input as grains, scattered | `chaotic` | | Pitch Shifter | the useful special case of the same machine | `clean` | | Spectral Freeze | hold what is sounding now, indefinitely | `static` `demo` | | Spectral Blur | smear across time without smearing pitch | `drifting` | The likeliest second wave. They need an FFT on the audio path, which is a different cost and latency shape from everything else here, and requirement 4 exists mostly for them. ### Strip, not patches | Thing | Where it belongs | |---|---| | Tilt EQ, compressor, gate, limiter | the strip, always on, cheap | | Stereo width, mid/side | the strip | | Reverb, delay, granular, resonators | layer engines, loaded deliberately | Everything above the line stops being a preset at all, which is the right outcome: nobody browses for a compressor the way they browse for a plate. ### Ships thin first Rotary, Amp + Cab, Auto-Wah, Chorus, Digital Delay, Tape Delay, Room, Hall, Plate. Nine, and each one unblocks a patch already on this ticket. ### Gaps and needs The six requirements above, plus: - **`Hits & Risers` versus `Effects` was settled by naming**: a one-shot sweetener is a hit, and anything that processes its input is here. The one boundary in the schema that exists purely to prevent a collision. - **A patch here may need a different browse shape.** One primary category per patch works, but someone looking for a reverb wants to see reverbs rather than scroll past forty processors. Whether `Effects` needs sub-grouping is a browser question rather than a schema one — and it is the only category heterogeneous enough to raise it.
Author
Owner

Placing the 45 patches that already exist

The first real test of the schema: every row in patches/factory.h, assigned
a primary category and secondary tags. Every patch placed. Two placements are
arguable and are marked; one of them found a hole in the category list.

Every patch below also carries factory.

Bass (2)

Patch Tags
sh101-bass va mono glide
tb303-line va mono gritty rhythmic

Lead (5)

Patch Tags Note
moog-lead va mono glide
filter-whistle va demo the filter is the instrument
lets-go-sync va sync bright
arp2600-ring va ringmod metallic
chiff sample hybrid demo arguable — a recorded breath transient leading a saw is a technique demo as much as a voice; it is placed by what it plays like

Keys (2)

Patch Tags Note
dx7-ep fm glassy velocity the Digital EP of the list
low-flue waveguide flute hollow arguable — a flue pipe is blown, but organs are Keys, and a sixteen-foot pipe is an organ's voice rather than a wind instrument

Mallets (1)

Patch Tags
crystal-bell modal glassy metallic

Pad (2)

Patch Tags
juno-pad va pwm warm drifting
sem-pad va warm

Winds (5)

Patch Tags
trumpet waveguide tube brass expressive
clarinet waveguide tube reed hollow
flute waveguide tube flute breathy
chowning-horn fm brass demo
obx-brass va brass unison

Voice (3)

Patch Tags
hello vocal demo
whispered-hello unvoiced vocal breathy demo
kargyraa additive vocal gritty

Drums (6)

Patch Tags
bass-drum modal membrane
snare modal membrane noisy
tenor-drum modal membrane wooden
timpani modal membrane
lpg-kick va noisy
ladder-kick va gritty

Cymbals (4)

Patch Tags Note
hihat modal plate metallic
crash modal plate metallic see #91
synclavier-gong metallic demo a gong is an instrument, so it is here rather than a stinger in Hits & Risers
bowed-plate modal plate bowed demo the Bowed Cymbal of the list, already built

Percussion (3)

Patch Tags
cuica modal membrane expressive
cajon modal plate noisy
maraca particle noisy

Atmosphere (0)

Nature & Environment (8)

Patch Tags Note
helicopter noisy rhythmic demo a machine is an object in the environment; see the ruling below
Patch Tags
wind noisy breathy drifting
rain particle noisy
rattlesnake noisy
rattlesnake-cloud particle noisy
thunder-near particle
thunder-distant particle warm
thunder-roll particle warm

Hits & Risers (1)

Patch Tags
shepard additive demo

Abstract (3)

Patch Tags
converging-cloud additive demo drifting
octave-lock additive demo drifting
arp2600-burble va chaotic rhythmic

Empty: Pluck, Strings, Utility, Effects

What the pass found

1. The schema very nearly holds. Forty-five patches, forty-five
placements, no patch needing two categories and one — helicopter — that
made a category row widen. The three arguable cases
were resolved by rules already written down rather than by inventing new
ones.

2. There was no home for machines, and now there is. helicopter is not
weather, not an animal, not an instrument and not a bed — and neither is a
passing car, a train or an idling engine. The pass surfaced the only genuine
hole in the schema, and it is closed: row 14 is now Nature & Environment and holds machines. The bed a machine makes stays in
Atmosphere, under the same test that separates a pad from a drone.

3. Four categories are empty, and two of them are the ones people look for
first.
No Pluck at all: no guitar, no harp, no kalimba. No Strings: no
bowed string of any kind, which the waveguide's missing friction drive
explains exactly. Utility and Effects being empty is expected — neither
has been started.

That Pluck is empty is the more surprising of the two, because nothing
blocks it. A plucked string is kBurst into a waveguide, which is the
bank's best-supported path.

4. Fifteen of forty-five are demo patches. They exist to prove an engine
claim — bowed-plate for the junction inside the loop, helicopter for
three noise banks, converging-cloud and octave-lock for partial
trajectories, chowning-horn for the index law. That is the right ratio for
a bank at this stage and the wrong one for a shipping instrument, and it is
exactly what the demo tag exists to make visible. Nobody has to guess which
patches are there for the engineers.

5. The bank is percussion-heavy and melody-light. Twenty-one of
forty-five are drums, cymbals, percussion or nature; nine are pitched
instruments anyone would play a tune on. That follows honestly from which
engines were built first, and it is the clearest statement of what the
library needs next.

Corrections this pass forced

Three comments above were wrong about exciters and have been fixed:

  • Lip, reed and jet all exist. dsp/waveguide_layer.h's drives are
    kBurst, kReed, kJet, kLip and kInput. Winds needs no new
    exciter at all.
  • The bow exists inside the modal loop. dsp/junction.h's
    JunctionCurve::kFriction is the Stribeck curve, used by bowed-plate and
    cuica. Glass Harmonica is not blocked.
  • What Strings actually needs is narrow: a friction drive on the
    waveguide string. Bowed plate yes, bowed violin not yet.

kInput in that same list is the audio-input path the Effects comment
describes.

## Placing the 45 patches that already exist The first real test of the schema: every row in `patches/factory.h`, assigned a primary category and secondary tags. Every patch placed. Two placements are arguable and are marked; one of them found a hole in the category list. Every patch below also carries `factory`. ### Bass (2) | Patch | Tags | |---|---| | `sh101-bass` | `va` `mono` `glide` | | `tb303-line` | `va` `mono` `gritty` `rhythmic` | ### Lead (5) | Patch | Tags | Note | |---|---|---| | `moog-lead` | `va` `mono` `glide` | | | `filter-whistle` | `va` `demo` | the filter is the instrument | | `lets-go-sync` | `va` `sync` `bright` | | | `arp2600-ring` | `va` `ringmod` `metallic` | | | `chiff` | `sample` `hybrid` `demo` | **arguable** — a recorded breath transient leading a saw is a technique demo as much as a voice; it is placed by what it plays like | ### Keys (2) | Patch | Tags | Note | |---|---|---| | `dx7-ep` | `fm` `glassy` `velocity` | the `Digital EP` of the list | | `low-flue` | `waveguide` `flute` `hollow` | **arguable** — a flue pipe is blown, but organs are `Keys`, and a sixteen-foot pipe is an organ's voice rather than a wind instrument | ### Mallets (1) | Patch | Tags | |---|---| | `crystal-bell` | `modal` `glassy` `metallic` | ### Pad (2) | Patch | Tags | |---|---| | `juno-pad` | `va` `pwm` `warm` `drifting` | | `sem-pad` | `va` `warm` | ### Winds (5) | Patch | Tags | |---|---| | `trumpet` | `waveguide` `tube` `brass` `expressive` | | `clarinet` | `waveguide` `tube` `reed` `hollow` | | `flute` | `waveguide` `tube` `flute` `breathy` | | `chowning-horn` | `fm` `brass` `demo` | | `obx-brass` | `va` `brass` `unison` | ### Voice (3) | Patch | Tags | |---|---| | `hello` | `vocal` `demo` | | `whispered-hello` | `unvoiced` `vocal` `breathy` `demo` | | `kargyraa` | `additive` `vocal` `gritty` | ### Drums (6) | Patch | Tags | |---|---| | `bass-drum` | `modal` `membrane` | | `snare` | `modal` `membrane` `noisy` | | `tenor-drum` | `modal` `membrane` `wooden` | | `timpani` | `modal` `membrane` | | `lpg-kick` | `va` `noisy` | | `ladder-kick` | `va` `gritty` | ### Cymbals (4) | Patch | Tags | Note | |---|---|---| | `hihat` | `modal` `plate` `metallic` | | | `crash` | `modal` `plate` `metallic` | see #91 | | `synclavier-gong` | `metallic` `demo` | a gong is an instrument, so it is here rather than a stinger in `Hits & Risers` | | `bowed-plate` | `modal` `plate` `bowed` `demo` | the `Bowed Cymbal` of the list, already built | ### Percussion (3) | Patch | Tags | |---|---| | `cuica` | `modal` `membrane` `expressive` | | `cajon` | `modal` `plate` `noisy` | | `maraca` | `particle` `noisy` | ### Atmosphere (0) ### Nature & Environment (8) | Patch | Tags | Note | |---|---|---| | `helicopter` | `noisy` `rhythmic` `demo` | a machine is an object in the environment; see the ruling below | | Patch | Tags | |---|---| | `wind` | `noisy` `breathy` `drifting` | | `rain` | `particle` `noisy` | | `rattlesnake` | `noisy` | | `rattlesnake-cloud` | `particle` `noisy` | | `thunder-near` | `particle` | | `thunder-distant` | `particle` `warm` | | `thunder-roll` | `particle` `warm` | ### Hits & Risers (1) | Patch | Tags | |---|---| | `shepard` | `additive` `demo` | ### Abstract (3) | Patch | Tags | |---|---| | `converging-cloud` | `additive` `demo` `drifting` | | `octave-lock` | `additive` `demo` `drifting` | | `arp2600-burble` | `va` `chaotic` `rhythmic` | ### Empty: Pluck, Strings, Utility, Effects ## What the pass found **1. The schema very nearly holds.** Forty-five patches, forty-five placements, no patch needing two categories and one — `helicopter` — that made a category row widen. The three arguable cases were resolved by rules already written down rather than by inventing new ones. **2. There was no home for machines, and now there is.** `helicopter` is not weather, not an animal, not an instrument and not a bed — and neither is a passing car, a train or an idling engine. The pass surfaced the only genuine hole in the schema, and it is closed: **row 14 is now `Nature & Environment`** and holds machines. The bed a machine makes stays in `Atmosphere`, under the same test that separates a pad from a drone. **3. Four categories are empty, and two of them are the ones people look for first.** No `Pluck` at all: no guitar, no harp, no kalimba. No `Strings`: no bowed string of any kind, which the waveguide's missing friction drive explains exactly. `Utility` and `Effects` being empty is expected — neither has been started. That `Pluck` is empty is the more surprising of the two, because nothing blocks it. A plucked string is `kBurst` into a waveguide, which is the bank's best-supported path. **4. Fifteen of forty-five are `demo` patches.** They exist to prove an engine claim — `bowed-plate` for the junction inside the loop, `helicopter` for three noise banks, `converging-cloud` and `octave-lock` for partial trajectories, `chowning-horn` for the index law. That is the right ratio for a bank at this stage and the wrong one for a shipping instrument, and it is exactly what the `demo` tag exists to make visible. Nobody has to guess which patches are there for the engineers. **5. The bank is percussion-heavy and melody-light.** Twenty-one of forty-five are drums, cymbals, percussion or nature; nine are pitched instruments anyone would play a tune on. That follows honestly from which engines were built first, and it is the clearest statement of what the library needs next. ## Corrections this pass forced Three comments above were wrong about exciters and have been fixed: - **Lip, reed and jet all exist.** `dsp/waveguide_layer.h`'s drives are `kBurst`, `kReed`, `kJet`, `kLip` and `kInput`. `Winds` needs no new exciter at all. - **The bow exists inside the modal loop.** `dsp/junction.h`'s `JunctionCurve::kFriction` is the Stribeck curve, used by `bowed-plate` and `cuica`. `Glass Harmonica` is not blocked. - **What `Strings` actually needs is narrow**: a friction drive on the waveguide *string*. Bowed plate yes, bowed violin not yet. `kInput` in that same list is the audio-input path the `Effects` comment describes.
Author
Owner

Two things lifted out of this ticket so they are findable:

  • #98 — Bundles, and exchanging pieces smaller than a patch. The
    "one patch is not the unit" question that came up here four times (the
    six-string guitar, the drum kit, the effect return, demo parts), plus
    importing and exporting spectra, materials and layers.
  • Machines are environment. Category 14 is now Nature & Environment and
    holds vehicles, engines and working equipment. The bed a machine makes
    stays in Atmosphere. The body, the category 14 comment and the placement
    pass are all updated.
Two things lifted out of this ticket so they are findable: - **#98 — Bundles, and exchanging pieces smaller than a patch.** The "one patch is not the unit" question that came up here four times (the six-string guitar, the drum kit, the effect return, demo parts), plus importing and exporting spectra, materials and layers. - **Machines are environment.** Category 14 is now `Nature & Environment` and holds vehicles, engines and working equipment. The bed a machine makes stays in `Atmosphere`. The body, the category 14 comment and the placement pass are all updated.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
bcox/tymbal#97
No description provided.