Cut core/instrument/ui comment bloat ~49% (comments only, zero code change)

src/core/instrument/ui/keyboard_strip.cpp

@@ -14,10 +14,8 @@ int clampNote(int n) {
     return n;
 }
 
-// Map a key BOUNDARY in [0, kStripKeyCount] to an x pixel inside a band of the given
-// left/width. keyEdge is a boundary (0..128): 0 -> band left, 128 -> band right. Integer
-// math, floored — key N's left is keyEdgeToX(N) and its right is keyEdgeToX(N+1), tiling
-// adjacent keys/zones without a seam (mirror of embed_strip::keyEdgeToX).
+// Maps a key boundary (0..128) to an x pixel. Key N's left is keyEdgeToX(N), right is
+// keyEdgeToX(N+1) — tiles adjacent keys/zones without a seam. Mirrors embed_strip::keyEdgeToX.
 int keyEdgeToX(int bandLeft, int bandWidth, int keyEdge) {
     if (keyEdge <= 0) return bandLeft;
     if (keyEdge >= kStripKeyCount) return bandLeft + bandWidth;
@@ -37,8 +35,7 @@ StripLayout layoutStrip(int w, int h) {
 int keyLeftX(const StripLayout& layout, int note) {
     const Rect& band = layout.keys;
     const int bandWidth = std::max(0, band.width);
-    // note is a KEY here (0..127); its left edge is boundary `note`. Callers pass note+1 to
-    // get a key's right edge, and 128 maps to the band right.
+    // note is a key (0..127); callers pass note+1 to get its right edge, 128 -> band right.
     const int edge = note < 0 ? 0 : (note > kStripKeyCount ? kStripKeyCount : note);
     return keyEdgeToX(band.x, bandWidth, edge);
 }
@@ -59,8 +56,7 @@ int keyAtPoint(const StripLayout& layout, int x, int y) {
     if (!contains(band, x, y)) return -1;
     const int bandWidth = std::max(0, band.width);
     if (bandWidth <= 0) return -1;
-    // Invert keyEdgeToX: the key whose half-open [leftX, rightX) contains x. Floor-divide
-    // the pixel offset back to a key; clamp defensively (a point on band.right()-1 maps to 127).
+    // Inverts keyEdgeToX: the key whose half-open [leftX, rightX) contains x.
     const int offset = x - band.x;
     int note = (offset * kStripKeyCount) / bandWidth;
     return clampNote(note);
@@ -69,7 +65,7 @@ int keyAtPoint(const StripLayout& layout, int x, int y) {
 Rect zoneBarRect(const StripLayout& layout, int lowNote, int highNote) {
     int lo = clampNote(lowNote);
     int hi = clampNote(highNote);
-    if (lo > hi) lo = hi;  // defensive: a malformed zone collapses rather than inverts
+    if (lo > hi) lo = hi;  // malformed zone collapses rather than inverts
     const int leftX = keyLeftX(layout, lo);
     const int rightX = keyLeftX(layout, hi + 1);
     return Rect::ltrb(leftX, layout.keys.y, std::max(leftX, rightX), layout.keys.bottom());
@@ -80,8 +76,7 @@ ZoneGrab zoneGrabAt(const StripLayout& layout, int lowNote, int highNote, int x,
     if (!contains(bar, x, y)) return ZoneGrab::kNone;
 
     const int barW = bar.width;
-    // A narrow bar (< 2*edge) has no body: split at the midpoint, LOW edge wins the tie so
-    // a click exactly on the midpoint resizes low (deterministic).
+    // A narrow bar has no body: split at the midpoint, low edge wins the tie.
     if (barW < 2 * kStripEdgeGrabWidth) {
         const int mid = bar.x + barW / 2;
         return x <= mid ? ZoneGrab::kLowEdge : ZoneGrab::kHighEdge;
@@ -103,11 +98,7 @@ ZoneBarHit zoneBarAtPoint(const StripLayout& layout, const int* lows, const int*
 }
 
 bool isNaturalKey(int note) {
-    // Clamp to the valid MIDI range before indexing.
     const int n = note < 0 ? 0 : (note > kStripKeyCount - 1 ? kStripKeyCount - 1 : note);
-    // The 12-semitone pattern of natural (white) keys within an octave, starting at C:
-    //   positions 0(C) 2(D) 4(E) 5(F) 7(G) 9(A) 11(B) are natural;
-    //   positions 1(C#) 3(D#) 6(F#) 8(G#) 10(A#) are accidental.
     static constexpr bool kNatural[12] = {
         true,   // 0  C
         false,  // 1  C#
@@ -129,13 +120,8 @@ int resolveDragNote(const StripLayout& layout, int startNote, int dxPixels) {
     if (dxPixels == 0) return clampNote(startNote);
     const int bandWidth = std::max(0, layout.keys.width);
     if (bandWidth <= 0) return clampNote(startNote);  // zero-width -> no motion
-    // Proportional shift: same linear mapping as keyAtPoint/keyEdgeToX so click and drag
-    // agree across the full strip, even on non-divisible-by-128 widths. The proportional
-    // key width is (bandWidth / kStripKeyCount) in exact rational arithmetic; rounding to
-    // the nearest key (half-key drag flips at the key centre) is achieved by adding
-    // bandWidth/2 to the absolute pixel delta before dividing — identical to the old
-    // formula except keyWidth is now derived from the same linear map (exact rational)
-    // rather than the truncated-integer bandWidth/128 that caused drift at the far end.
+    // Same linear mapping as keyAtPoint/keyEdgeToX (exact rational), not a truncated-integer
+    // bandWidth/128 key width — that drifted at the far end of the strip.
     const int half = bandWidth / 2;
     int shift;
     if (dxPixels > 0) {