Short knob-grid labels for 18 parameter(s) - #2
charlesvestal wants to merge 1 commit into
Conversation
Labels each knob cell with the word that identifies the control rather than a squeezed abbreviation of its full name. Additive only -- the released host (v0.12.1) ignores the field, and its page planner was verified to produce identical pages before and after.
|
While rendering every page of every catalogued module to review knob-grid No action implied, and I have deliberately not sent a patch: each of forgeCharacters the device font cannot draw 8 string(s) contain characters the 5x7 device font cannot draw (they render as nothing): copy_a_b.name: "Copy A→B"; copy_b_a.name: "Copy B→A"; swap_ab.name: "Swap A↔B"; Filter.cv_e1_to_cut.label: "E1→F1" and 4 more Parameters no page can reach 152 chain_params are listed in no level, so no UI can reach them: pv1_level, pv1_pwm, pv1_fbk, pv1_f1_cut, pv1_f1_res, pv1_f1_drv, … Checked with Schwung's |
Adds
short_nameto this module's parameters, so the Schwung knob grid canlabel each cell with the word that identifies it rather than a squeezed
abbreviation of the full name.
Part of a fleet-wide pass over every catalogued module. Each name was chosen
by hand against the page it appears on: where a page is already called
"Filter Envelope", its cells say ATTACK and DECAY rather than F.ATK and FENVDEC.
What changes
Nothing else is touched: no version bump, no behaviour change, no new params.
forge — rendered
Left is what the grid draws today, right is with this change — 8 of 21 changed pages.
Before / after
rnd_kit_paramsrnd_voiceall_decayrnd_pansave_kitall_punchall_brightall_driveall_snapall_bendThe page matters where a name repeats: the same role under two sections
gets the same short name, and the section it sits under is what tells
them apart.
The full name is not lost
A short name is what the cell says at rest. The moment a knob is
touched, the header shows that parameter's full name and its value —
so nothing becomes unidentifiable, it just stops being shouted at you
eight times on one page.
rnd_kit_paramson Main: the cell reads PARAM at rest, and the header reads RND KIT PARAMS under the finger.Safe to merge now
short_nameis a new field — it lands in the next Schwung release. On thecurrently released host (v0.12.1) it is simply ignored.
This was checked rather than assumed: for every file here, the v0.12.1
page planner was run against the module contract before and after the change
and asserted to produce byte-identical pages — same page count, same cells,
same order. Merging today changes nothing; the labels appear when users update.
Not included — these live in your DSP
78 more parameters take their metadata from the plugin's
chain_paramsat runtime, so theycannot be labelled from
module.json. Addingshort_namebeside each onein your
chain_paramsJSON is all that is needed. Suggested values:If a label is wrong
These are suggestions from someone reading the grid, not from the person who
wrote the synth. Change any of them in this branch, or close it — no hard
feelings either way. Layout problems are a separate matter and will come as
their own issues.