at.atmosynth.module

Zero or more individually identified audio inputs.

Scheduled AudioParam envelopes. Web Audio has no envelope node, so these are their own structure.

• maxLength: 3000

Version of the module description this record follows. A reader accepts any version at or below its own.

• minimum: 1

Zero or more note inputs. A note input carries note events — what is played, and when — from any note source: a sequencer's note output, or the player, which is the on-screen keys, the computer keyboard and every MIDI device at once. "MIDI" is the historical name; nothing arriving here need have come from MIDI.

Stable identity shared by every published version of this module.

• maxLength: 128

• minLength: 1
• maxLength: 200

Zero or more note outputs. A note output carries note events — what is played, and when — rather than a signal, so it is wired to another instance's note input (`midiInputs`) rather than to an audio input. A module that declares one is a source of what is played; a module that declares none is what plays it.

What this module emits notes by, where it is not made of Web Audio nodes at all. A note source has no `nodes` and no `connections`: it produces note events, and the behaviour that produces them is named here rather than described, because there is no vocabulary of nodes for a thing that makes no sound. `range` emits none of its own: it passes on the notes wired into its input that fall inside the range its instance names (`noteRange` on the patch's instance), each still the note of whatever played it. `transpose` and `assign` emit none of their own either: they pass on every note wired into their input at another pitch — moved by the semitones the instance names (`transpose`), or at the one note it names (`assignedNote`) — each still the note of whatever played it, and starting and stopping when it did. `oneshot` emits none of its own either: it passes on every note wired into its input lasting as many milliseconds as the instance names (`noteLength`), however long whatever played it held it — each still the note of whatever played it, at its own pitch, and starting when it did. A reader that does not know the named behaviour cannot run the module, and says so rather than guessing.

• maxLength: 64
• knownValues: keyboard | sequencer | range | transpose | assign | oneshot

What this module chooses a sequencer's patterns by, where it is not made of Web Audio nodes at all. A pattern source emits neither sound nor notes: it is wired to a sequencer's pattern input and decides which of that sequencer's patterns is played, and when. Like a note source it has no `nodes` and no `connections`, and its behaviour is named here rather than described. A module is a note source or a pattern source, never both. A reader that does not know the named behaviour cannot run the module, and says so rather than guessing.

• maxLength: 64
• knownValues: arranger | scenes

The record key this version is published under, repeated in the record so a reader holding only the record knows which version it is. A patch's `moduleRef.versionKey` is this value, and it is the record key a reader fetches: a record whose `versionKey` differs from its own key is pinned by the key and misdescribed by this field.

• maxLength: 128

• minLength: 1

• minLength: 1
• maxLength: 64

• maxLength: 200

Index into breakpoints where the value holds while a note is held. Absent means a one-shot.

• minimum: 0

How the value travels from the previous breakpoint.

• knownValues: step | linear | exponential

Milliseconds from the trigger.

• minimum: 0

The param's value at this instant, as its decimal form — "0.25", "1" — because the ATproto data model has no floating-point type and a PDS refuses one. An automation is numeric by definition, so a reader turns it back into a number without asking anything else.

• maxLength: 200

• maxLength: 128

• minLength: 1
• maxLength: 64

• minLength: 1
• maxLength: 64

The node's settings, as its kind defines them. This is an object — which is the whole of what `unknown` means here — so the data model applies inside it: a whole number is an ordinary integer, and a number that is not a whole number is carried as its decimal string, "0.5" rather than 0.5, because the ATproto data model has no floating-point type and a PDS refuses one. That is the one difference from the fields this description types as strings, which have nowhere to put an integer.

• minLength: 1
• maxLength: 64

• minLength: 1
• maxLength: 64

The value used where a patch sets none, always as text. A number is its decimal form — "0.5", and "2" for a whole one — because the ATproto data model has no floating-point type and a string is the only type that carries both a number and a word. Where this parameter declares a closed value set, it is one of those strings instead, and a label that looks like a number stays the label it is.

• maxLength: 200

• minLength: 1
• maxLength: 64

• minLength: 1
• maxLength: 200

How a slider or a MIDI control moves through the range. linear moves by equal differences; log moves by equal ratios, which is how a frequency is heard, so the middle of a 20 to 20000 sweep is about 632 rather than about 10000. log needs a range above zero at both ends. Absent is linear. A parameter with a closed value set has no scale.

• knownValues: linear | log

• minLength: 1

A closed value set, where the parameter is not numeric. A construction option the parameter targets is given the chosen value itself; an AudioParam it targets is given the chosen value's position in this set, counting from zero, which is how a worklet offers a choice its own code interprets.

• maxLength: 64

• minimum: 0

Which field of the breakpoint the parameter sets. `time` is milliseconds from the trigger; `duration` is milliseconds from the breakpoint before this one, so a later stage keeps its length when an earlier one is made longer, and is never set on breakpoint 0. `value` is the level travelled to. `curve` is how it travels there, and the parameter then declares a closed value set drawn from the breakpoint's own curves.

• knownValues: time | duration | value | curve

• maxLength: 64

• maxLength: 64

• maxLength: 64

• minLength: 1
• maxLength: 64

• maxLength: 200

The high bound, as its decimal form — "20000", "0.5" — because the ATproto data model has no floating-point type and a PDS refuses one. A range is numeric by definition, so a reader turns it back into a number without asking anything else.

• maxLength: 200

The low bound, as its decimal form — "0.0001", "-1" — because the ATproto data model has no floating-point type and a PDS refuses one. A range is numeric by definition, so a reader turns it back into a number without asking anything else.

• maxLength: 200

• maxSize: 10485760
• accept: audio/wav, audio/flac

• minLength: 1
• maxLength: 64

• maxLength: 200

• minLength: 1
• maxLength: 64

• knownValues: buffer

• minLength: 1
• maxLength: 64

• minimum: 0

• minimum: 0

• minLength: 1
• maxLength: 64

• maxLength: 64