framerudiments 0.4.3__tar.gz → 0.4.4__tar.gz

{framerudiments-0.4.3/src/framerudiments.egg-info → framerudiments-0.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: framerudiments
-Version: 0.4.3
+Version: 0.4.4
 Summary: Deterministic Shorts and lyric visualisers using DanceRudiments and StemLab evidence.
 Author: Kieran Simkin
 License-Expression: MIT
@@ -152,7 +152,7 @@ its own tone, sprite, LRC, CUE and four-dimensional recording.
   stills, a poster, phone preview, input/output hashes, commands and logs.
 
 The [spectrum guide](docs/spectrum.md) covers saved StemLab Fourier calibration,
-frequency labels, peak controls and per-frame JSONL effect signals. Run
+frequency labels, independent fixed-grid visibility, peak controls and per-frame JSONL effect signals. Run
 `framerudiments renderers` for the current built-in names. The optional
 `demo --spectrum` generator uses StemLab 1.6+; rendering its saved recording
 keeps the core package lightweight.

{framerudiments-0.4.3 → framerudiments-0.4.4}/README.md

@@ -121,7 +121,7 @@ its own tone, sprite, LRC, CUE and four-dimensional recording.
   stills, a poster, phone preview, input/output hashes, commands and logs.
 
 The [spectrum guide](docs/spectrum.md) covers saved StemLab Fourier calibration,
-frequency labels, peak controls and per-frame JSONL effect signals. Run
+frequency labels, independent fixed-grid visibility, peak controls and per-frame JSONL effect signals. Run
 `framerudiments renderers` for the current built-in names. The optional
 `demo --spectrum` generator uses StemLab 1.6+; rendering its saved recording
 keeps the core package lightweight.

{framerudiments-0.4.3 → framerudiments-0.4.4}/RELEASE_NOTES.md

@@ -1,3 +1,8 @@
+# FrameRudiments 0.4.4
+
+- Spectrum views accept a validated `style.grid` boolean. Set it to `false` to remove the three fixed dB guide lines while retaining calibrated bars and moving peak holds; label visibility remains independent.
+- The existing default remains `true` for backward compatibility. Documentation and focused regression coverage include the no-grid, no-label presentation used by clean campaign visualisers.
+
 # FrameRudiments 0.4.3
 
 - Atlas fire accepts an evidence-recorded three-stop CSS palette ordered as

{framerudiments-0.4.3 → framerudiments-0.4.4}/docs/spectrum.md

@@ -26,7 +26,8 @@ the ordinary FrameRudiments dependencies.
     "min_peak_db": -60,
     "min_peak_contrast_db": 3,
     "min_peak_distance": 2,
-    "labels": true
+    "labels": true,
+    "grid": true
   }
 }
 ```
@@ -112,6 +113,7 @@ In addition to the common `colours`, `padding` and `background`, spectrum accept
 | `gap` | 1 pixel, nonnegative |
 | `peak_colour`, `label_colour` | CSS colours |
 | `labels`, `font_size` | true; responsive default font size, explicit range 6..128 pixels |
+| `grid` | true; set false to omit the three horizontal dB reference lines while retaining bars and peak holds |
 
 Every render/preflight streams active spectrum reports into
 `rudiment-analysis.jsonl`, binding the sidecar hash in the final manifest.

{framerudiments-0.4.3 → framerudiments-0.4.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "framerudiments"
-version = "0.4.3"
+version = "0.4.4"
 description = "Deterministic Shorts and lyric visualisers using DanceRudiments and StemLab evidence."
 requires-python = ">=3.11"
 readme = "README.md"

{framerudiments-0.4.3 → framerudiments-0.4.4}/src/framerudiments/__init__.py

@@ -1,6 +1,6 @@
 """Offline frame composition on a traceable musical clock."""
 
-__version__ = "0.4.3"
+__version__ = "0.4.4"
 
 from .project import Project
 from .render import render, preflight

{framerudiments-0.4.3 → framerudiments-0.4.4}/src/framerudiments/rudiment_renderers.py

@@ -280,6 +280,7 @@ class SpectrumRenderer(_Viewport):
                 "label_colour",
                 "font_size",
                 "labels",
+                "grid",
             },
         )
         self.floor = number(style.get("floor_db", -72), "spectrum floor", minimum=-240, maximum=0)
@@ -306,6 +307,9 @@ class SpectrumRenderer(_Viewport):
         self.labels = style.get("labels", True)
         if not isinstance(self.labels, bool):
             raise ValueError("Spectrum labels must be boolean")
+        self.grid = style.get("grid", True)
+        if not isinstance(self.grid, bool):
+            raise ValueError("Spectrum grid must be boolean")
         self.font_size = integer(
             style.get("font_size", max(6, min(14, size[0] // 30))), "spectrum font", minimum=6, maximum=128
         )
@@ -346,7 +350,8 @@ class SpectrumRenderer(_Viewport):
             return bottom - max(0, min(1, (db - self.floor) / (self.ceiling - self.floor))) * (bottom - top)
 
         for db in (self.floor, (self.floor + self.ceiling) / 2, self.ceiling):
-            draw.line((left, y(db), right, y(db)), fill="#40516a")
+            if self.grid:
+                draw.line((left, y(db), right, y(db)), fill="#40516a")
             if self.labels:
                 draw.text(
                     (self.padding, y(db) - self.font_size / 2),

{framerudiments-0.4.3 → framerudiments-0.4.4/src/framerudiments.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: framerudiments
-Version: 0.4.3
+Version: 0.4.4
 Summary: Deterministic Shorts and lyric visualisers using DanceRudiments and StemLab evidence.
 Author: Kieran Simkin
 License-Expression: MIT
@@ -152,7 +152,7 @@ its own tone, sprite, LRC, CUE and four-dimensional recording.
   stills, a poster, phone preview, input/output hashes, commands and logs.
 
 The [spectrum guide](docs/spectrum.md) covers saved StemLab Fourier calibration,
-frequency labels, peak controls and per-frame JSONL effect signals. Run
+frequency labels, independent fixed-grid visibility, peak controls and per-frame JSONL effect signals. Run
 `framerudiments renderers` for the current built-in names. The optional
 `demo --spectrum` generator uses StemLab 1.6+; rendering its saved recording
 keeps the core package lightweight.

{framerudiments-0.4.3 → framerudiments-0.4.4}/tests/test_spectrum.py

@@ -4,6 +4,7 @@ import os
 
 from dancerudiments_authoring.recording import Recording, RecordingClock, write_recording
 import pytest
+from PIL import ImageColor
 
 from framerudiments import Project, render
 from framerudiments.compositor import Compositor
@@ -93,6 +94,17 @@ def test_peak_hold_decays_deterministically_without_hidden_state(spectrum_projec
     assert comp.frame(30)[0].tobytes() == first
 
 
+def test_spectrum_grid_can_be_omitted_without_removing_bars_or_peak_holds(spectrum_project):
+    project, _, _ = spectrum_project
+    project.data["layers"][0]["style"] = {"grid": False, "labels": False}
+    comp = Compositor(Project(project.data, project.base))
+    view = comp.layers[0]
+    assert view.renderer.grid is False
+    image = view.renderer.render(view.data(comp.context(0)))
+    assert ImageColor.getcolor("#40516a", "RGBA") not in set(image.get_flattened_data())
+    assert image.getbbox() is not None
+
+
 def test_local_peak_plateaus_threshold_contrast_and_minimum_distance():
     assert peak_indices(
         [-60, -10, -10, -60, -20, -60], floor=-72, threshold=-50, contrast=3, distance=2, count=3