feat: legible ReaSampler 9000 editor — bigger knobs, ms time constants, per-ring double-click reset, and an antialiased draw pass

src/core/instrument/ui/deck_values.h

@@ -0,0 +1,52 @@
+// deck_values.h — the deck's control-id <-> parameter-set BINDING and its display units: the
+// normalized 0..1 a knob shows, the write back into the stored seconds/fractions/positions, the
+// double-click reset, and the ms time-constant formatter. Split from the editor shell so the
+// whole domain map is provable without a host; deck_groups owns WHICH controls exist, this owns
+// what each one's value MEANS. Links the map layer because PlaySeconds is what a deck edits.
+
+#pragma once
+
+#include <cstddef>
+
+#include "core/instrument/map/sample_map.h"        // PlaySeconds (the deck's edit target)
+#include "core/instrument/ui/deck_groups.h"        // DeckParam
+#include "core/instrument/ui/envelope_overlay.h"   // kGateStageMaxSeconds
+
+namespace reasampler::instrument::ui {
+
+using map::PlaySeconds;
+
+// Every stage-time knob spans [0, kEnvTimeMaxSeconds] seconds — rate-free, exactly what the
+// parameter set stores. READ from the overlay's schematic scale rather than restated: the AHDSR
+// schematic anchors a maxed knob at the canvas edge, which only holds while the two agree.
+inline constexpr double kEnvTimeMaxSeconds = kGateStageMaxSeconds;
+
+// Pitch depth throw: +/-kVelocityPitchRangeSemitones, centred. The one throw the pitch
+// envelope's peak and the velocity->pitch curve's full scale both speak (play_params.h).
+inline constexpr double kPitchDepthMaxSemis = kVelocityPitchRangeSemitones;
+
+// Key-track knob ceiling (0..200%), shared by the pitch and filter key-track controls.
+inline constexpr double kKeyTrackMax = 2.0;
+
+// The normalized [0,1] a control shows: seconds over the ceiling, levels and fractions as-is,
+// signed depths centred at 0.5, curve exponents over their logarithmic travel. Controls backed
+// by per-instance state rather than the parameter set (voice count, master gain, the pitch
+// key-track scalar, preview velocity) are not here — the shell reads those from the processor.
+double deckParamNorm(DeckParam id, const PlaySeconds& play);
+
+// Applies a committed interaction: a knob's normalized `value`, or a toggle's `segment` (0/1).
+// Mutates `play` in place, touching exactly the one field the control names.
+void setDeckParam(DeckParam id, PlaySeconds& play, double value, int segment);
+
+// Resets `id` to its default. The default IS what a fresh PlaySeconds carries, so there is no
+// second table of defaults to drift from the real one. Exact for every shipped default: they
+// are all 0, 1, or the curve neutral, and the seconds ceiling is a power of two, so the
+// norm round trip loses nothing. For knob-valued controls — a toggle has no reset gesture.
+void resetDeckParam(DeckParam id, PlaySeconds& play);
+
+// A time constant as MILLISECONDS, e.g. "12 ms". Never switches to seconds: the editor reads in
+// one unit so two stage times are comparable at a glance. Sub-10 ms keeps one decimal so a short
+// attack is not rounded to a bare "0 ms". Writes at most `len` bytes including the terminator.
+void formatEnvTimeMs(double seconds, char* buf, std::size_t len);
+
+}  // namespace reasampler::instrument::ui