Skip to main content

Module words

Module words 

Source
Expand description

The word dictionary: what a producer’s sound word means.

An entry says what a word such as “warm” or “plucky” means, how far listeners agree on it and which analyzer number checks it. The entries name no synth control; the per-synth references bind them to controls.

The data lives in dictionary/words/: one file per axis, the listener numbers of agreement.json (written by cargo xtask agreement), the intensity ladder and the style and technique lists. The binary embeds them and parses them once (dictionary).

A word with several senses has one entry per sense and one default. Words::pick takes the sense a named role selects, else the default. Words::question is the one short question that picks a sense.

use sound_to_patch::words::dictionary;

let words = dictionary()?;
let dark = words.pick("dark", None).unwrap();
assert_eq!(dark.agreement.n, 8);

Modules§

check
The rules every word entry, listener number and list row must meet.

Structs§

Agreement
How far listeners agree on a word’s EQ curve.
Anchor
A sourced number that anchors one step of one kind of control.
AxisFile
One axis file of the dictionary.
Effects
A word’s effect on the five reverb parameters, in global standard deviations from the global mean.
Entry
One sense of a producer word.
EqWord
The listener numbers of one EQ word.
Ladder
The intensity ladder: which step a modifier picks, and the sourced anchors per kind of control.
Listeners
The derived listener numbers of agreement.json.
Measure
The analyzer number that checks a sense.
Modifier
A modifier group of the intensity ladder.
Ranked
A row of the style or technique list.
Reverb
The listener reverb numbers of a word.
ReverbWord
The listener reverb numbers of one word.
Value
A number of an entry with its sources.
Words
The parsed word dictionary.
WordsError
The embedded word data does not parse or breaks a rule.

Enums§

Axis
The kind of sound change a word names.
Class
The agreement class of a word. Our thresholds: high from 0.45, medium from 0.20, else low; known only from KNOWN_FROM curves.
Tag
How many sources back a number or a meaning.

Constants§

AXES
Every axis file, in reference order.
KNOWN_FROM
The fewest curves for a known class; fewer set the few-sample flag.

Functions§

dictionary
The word dictionary, parsed once.