Skip to main content

Module curation

Module curation 

Source
Expand description

Curation and generation data a driver gives the apps: editor pages, controls, help, generation recipes. Platform-neutral; apps render it.

Structs§

Character
A kind of sound a driver can generate.
Curation
How the editor lays out a driver’s fields. Every field is in exactly one section or in excluded (fields the editor does not show, such as sequencer data that needs its own view).
Handle
A draggable point on a page’s first graph; dragging it sets the fields on its axes through Driver::drag.
Help
Help text for one field.
MacroInfo
How a driver names and explains one of the four Macros.
Macros
Four generic ways to shape a generated sound, each 0.0..=1.0. Each driver maps them onto its own fields.
Note
A note on a piano roll, for Graph::Voices. Times and pitch 0..1.
Page
A top-level editor page (a stage of the signal path, a layer, …).
Palette
The extra sources a synth holds right now, beyond its built-in engines.
PaletteUnit
A user unit (a loaded oscillator or effect) a synth holds, as a source generation may use.
Recipe
What to generate.
Section
A titled group of fields on a Page.
UnitParam
A parameter a user unit declares, in its own values.

Enums§

Control
The widget a field wants.
Family
What a Character is for; apps group characters by it.
Graph
An illustrative picture of part of a program, as plain numbers the apps draw. Coordinates are 0..1 unless noted; none of it claims to match the synth’s audio.
Mutability
What generation may do to a field.
UnitParamKind
How a user unit’s parameter reads.

Constants§

MACROS
Generic macro titles and help, for a driver that says nothing better. In Macros order: bright, movement, grit, space.

Functions§

curation_by_group
One page per schema group, in the order the groups first appear, each with one section of the same name. A starting point for a simple driver’s Driver::curation.
format_raw_default
raw for f with no curation: “Off”/“On” for a two-value field (the default control is then a toggle), else the number.
morph_fields
Step t (0.0..=1.0) of the way from a to b, over the free fields (Driver::morph’s default): a dial (Control::Continuous in a) interpolates; every other free field is a’s until t reaches its group’s threshold (from seed, within 0.15..0.85), then b’s. So 0 is a, 1 is b’s sound, and a field never turns back on the way. Non-free fields and the name are a’s. Parent values out of range are clamped; a value the program refuses stays a’s.
morph_fields_by
morph_fields for a driver that knows better than its controls which fields are dials (dial, by field index): a number that names something (a destination) must switch, not slide.