mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-17 07:05:28 +00:00
docs(design): bring the family lettering back into the schematic
The first rack pass carried module identity in per-family type — filters as tracked-out caps, dynamics heavy and tight, nonlinear an italic serif, time light and airy, smart monospace. Moving to the schematic direction lost it: everything ended up lettered in the same condensed caps, with family shown only by the node ring. It is back, inside the schematic skeleton rather than instead of it, so the drawing still carries order and routing while the type carries kind. You can tell what sort of module you are looking at with the label out of focus. Two faces, as budgeted. The condensed sans separates four families by weight, case, tracking and size; the serif is spent on the one family that is generative rather than corrective, because it is the one that behaves differently. Adds a tint step per module WITHIN its family, derived from position in the registry so adding an effect never re-colours its siblings by hand. Seventeen distinct module hues across the rack, and two filters read as different modules without reading as different families. The Broadcast preset is the test: seven nodes across three families in one rack, each identifiable before it is read. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 5
parent
2757b08ce2
commit
05ea338255
@@ -46,6 +46,34 @@ So one plain name per *effect* is not enough: a preset's node needs its own
|
||||
preset node as well as on the effect. This is invisible in a catalogue of cards
|
||||
and obvious the moment every preset is drawn as the chain it actually builds.
|
||||
|
||||
## Family lettering, carried over from the first round
|
||||
|
||||
The identity device from the first rack pass — different type per family — was
|
||||
lost when the direction moved to schematic, which lettered everything in the
|
||||
same condensed caps. It is back, inside the schematic skeleton rather than
|
||||
instead of it. You can tell what KIND of module you are looking at with the
|
||||
label out of focus, before the word registers.
|
||||
|
||||
| Family | Treatment | Why |
|
||||
| --- | --- | --- |
|
||||
| Filter | condensed caps, wide tracking, light | measuring instruments |
|
||||
| Dynamics | condensed caps, tight, heavy | grips the signal |
|
||||
| Nonlinear | **italic serif** | the only generative family — it should not look like the others |
|
||||
| Time | condensed caps, very wide, thin | atmosphere, not control |
|
||||
| Smart | monospace, medium | it measures; it reads as a readout |
|
||||
|
||||
Two faces, as budgeted. The condensed sans carries four families apart by
|
||||
weight, case, tracking and size; the serif is spent on the single family that
|
||||
behaves differently from the rest.
|
||||
|
||||
Alongside it, a **tint step per module inside its family** — derived from
|
||||
position in the registry, so adding an effect never re-colours its siblings by
|
||||
hand. Two filters are visibly different modules without reading as two
|
||||
different families.
|
||||
|
||||
The `Broadcast` preset is the test case: seven nodes across three families in
|
||||
one rack, and each one is identifiable before it is read.
|
||||
|
||||
## The collapsed state is a sentence
|
||||
|
||||
Collapsed is the most-seen state by a distance: a rack of six modules is six
|
||||
|
||||
@@ -33,6 +33,26 @@ const esc = (s: string) => s.replace(/&/g, "&").replace(/</g, "<").replac
|
||||
const FAMILY_HUE: Record<string, string> = {
|
||||
filter: "var(--f-filter)", dynamics: "var(--f-dyn)", nonlinear: "var(--f-non)", time: "var(--f-time)",
|
||||
};
|
||||
/**
|
||||
* A tint STEP per module inside its family — so two filters are visibly
|
||||
* different modules without reading as two different families. Derived from
|
||||
* position in the registry, so adding an effect never re-colours its siblings
|
||||
* by hand.
|
||||
*/
|
||||
const FAMILY_BASE: Record<string, [number, number, number]> = {
|
||||
filter: [72, 0.15, 240], dynamics: [82, 0.14, 72], nonlinear: [70, 0.17, 26], time: [73, 0.15, 305],
|
||||
};
|
||||
function moduleHue(id: string): string {
|
||||
const def = getAudioFxDef(id);
|
||||
if (!def) return "var(--f-filter)";
|
||||
const family = HF_AUDIO_FX.filter((d) => d.group === def.group);
|
||||
const i = family.findIndex((d) => d.id === id);
|
||||
const [l, c, h] = FAMILY_BASE[def.group] ?? FAMILY_BASE.filter!;
|
||||
const span = Math.max(1, family.length - 1);
|
||||
const t = i / span;
|
||||
// Walk lightness and hue a little, keep chroma — the family stays obvious.
|
||||
return `oklch(${(l - 6 + t * 12).toFixed(1)}% ${c} ${(h - 14 + t * 28).toFixed(0)})`;
|
||||
}
|
||||
const PRESET_FAMILY_LABEL: Record<string, string> = {
|
||||
voice: "Voice", repair: "Fix", character: "Character", space: "Space",
|
||||
};
|
||||
@@ -52,7 +72,7 @@ const ruler = BANDS.map((b) => {
|
||||
/* ---- one module, in both faces ------------------------------------------ */
|
||||
function moduleCard(def: (typeof HF_AUDIO_FX)[number]) {
|
||||
const c = EFFECT_COPY[def.id]!;
|
||||
const hue = FAMILY_HUE[def.group] ?? "var(--f-filter)";
|
||||
const hue = moduleHue(def.id);
|
||||
const defaults = defaultAudioFxParams(def.id);
|
||||
const profile = PROFILES[def.id];
|
||||
|
||||
@@ -84,7 +104,7 @@ function moduleCard(def: (typeof HF_AUDIO_FX)[number]) {
|
||||
return `<figure class="specimen">
|
||||
<div class="rack" style="--h:${hue}">
|
||||
<div class="flow">
|
||||
<div class="node">
|
||||
<div class="node fam-${def.group}">
|
||||
<span class="n"></span>
|
||||
<div class="nmrow"><span class="nm">${esc(c.title)}</span><span class="tag">${esc(def.label)}</span></div>
|
||||
<div class="knob-row">
|
||||
@@ -126,7 +146,7 @@ type StateOpts = {
|
||||
function stateSpecimen(effectId: string, params: Record<string, unknown>, o: StateOpts) {
|
||||
const def = getAudioFxDef(effectId)!;
|
||||
const c = EFFECT_COPY[effectId]!;
|
||||
const hue = o.smart ? "var(--mark)" : FAMILY_HUE[def.group] ?? "var(--f-filter)";
|
||||
const hue = o.smart ? "var(--mark)" : moduleHue(effectId);
|
||||
const profile = PROFILES[effectId];
|
||||
const primaryLabel = c.primary === "strength" ? (profile?.label ?? "Amount") : (c.params[c.primary]?.label ?? c.primary);
|
||||
const summary = SUMMARY[effectId] ? SUMMARY[effectId]!(params) : "";
|
||||
@@ -151,7 +171,7 @@ function stateSpecimen(effectId: string, params: Record<string, unknown>, o: Sta
|
||||
${rows}`
|
||||
: `<div class="says">${esc(summary)}</div>`;
|
||||
|
||||
const body = `<div class="node${o.bypass ? " bypass" : ""}${o.smart ? " smart" : ""}" style="--h:${hue}">
|
||||
const body = `<div class="node fam-${o.smart ? "smart" : def.group}${o.bypass ? " bypass" : ""}${o.smart ? " smart" : ""}" style="--h:${hue}">
|
||||
<span class="n">03</span>
|
||||
<div class="nmrow">
|
||||
<span class="nm">${esc(c.title)}</span>
|
||||
@@ -195,7 +215,7 @@ function presetCard(p: (typeof HF_AUDIO_FX_PRESETS)[number]) {
|
||||
const nodes = p.nodes
|
||||
.map((n, i) => {
|
||||
const def = getAudioFxDef(n.type);
|
||||
const hue = FAMILY_HUE[def?.group ?? "filter"];
|
||||
const hue = moduleHue(n.type);
|
||||
const c = EFFECT_COPY[n.type]!;
|
||||
// The one value that says what this stage is doing, in its own units —
|
||||
// the plain name carries the meaning, the number keeps it honest.
|
||||
@@ -206,7 +226,7 @@ function presetCard(p: (typeof HF_AUDIO_FX_PRESETS)[number]) {
|
||||
const pd = def?.params.find((x) => x.key === k);
|
||||
return `${v}${pd && "unit" in pd && pd.unit ? " " + pd.unit : ""}`;
|
||||
})[0] ?? "";
|
||||
return `<div class="node" style="--h:${hue}">
|
||||
return `<div class="node fam-${def?.group ?? "filter"}" style="--h:${hue}">
|
||||
<span class="n">${String(i + 1).padStart(2, "0")}</span>
|
||||
<div class="nmrow"><span class="nm">${esc(c.title)}</span><span class="tag">${esc(shown)}</span></div>
|
||||
</div>`;
|
||||
@@ -317,8 +337,37 @@ const html = `<title>FX rack — the casual author's view</title>
|
||||
border-radius:50%; background:oklch(12% .004 265); font-family:Monaco,monospace; font-size:9px;
|
||||
color:var(--h); display:grid; place-items:center; z-index:1; }
|
||||
.nmrow { display:flex; align-items:baseline; gap:7px; }
|
||||
.nm { font-family:"DIN Alternate","Oswald",sans-serif; font-size:13px; text-transform:uppercase;
|
||||
letter-spacing:.13em; color:oklch(92% .006 250); }
|
||||
.nm { font-size:13px; color:oklch(92% .006 250); }
|
||||
|
||||
/* ---- family lettering ------------------------------------------------
|
||||
The identity device from the first round, brought into the schematic. You
|
||||
can tell what KIND of module you are looking at with the label out of
|
||||
focus, before the word registers.
|
||||
|
||||
Two faces, as budgeted: a condensed sans carries four families apart by
|
||||
weight, case, tracking and size; a serif is spent on the one family that
|
||||
is generative rather than corrective, because it is the one that behaves
|
||||
differently. */
|
||||
.fam-filter .nm {
|
||||
font-family:"DIN Alternate","Oswald",sans-serif; text-transform:uppercase;
|
||||
letter-spacing:.18em; font-size:12px; font-weight:400;
|
||||
}
|
||||
.fam-dynamics .nm {
|
||||
font-family:"DIN Alternate","Oswald",sans-serif; text-transform:uppercase;
|
||||
letter-spacing:.04em; font-size:14px; font-weight:700;
|
||||
}
|
||||
.fam-nonlinear .nm {
|
||||
font-family:"Superclarendon",Georgia,serif; font-style:italic; font-weight:700;
|
||||
font-size:14.5px; letter-spacing:-.005em; text-transform:none;
|
||||
}
|
||||
.fam-time .nm {
|
||||
font-family:"DIN Alternate","Oswald",sans-serif; text-transform:uppercase;
|
||||
letter-spacing:.24em; font-size:12px; font-weight:300; opacity:.94;
|
||||
}
|
||||
.fam-smart .nm {
|
||||
font-family:Monaco,ui-monospace,monospace; text-transform:uppercase;
|
||||
letter-spacing:.05em; font-size:11.5px; font-weight:600;
|
||||
}
|
||||
.tag { margin-left:auto; font-family:Monaco,monospace; font-size:8.5px; color:oklch(56% .012 250);
|
||||
white-space:nowrap; font-variant-numeric:tabular-nums; }
|
||||
|
||||
|
||||
Reference in New Issue
Block a user