framerudiments 0.4.0__tar.gz → 0.4.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (234) hide show
  1. {framerudiments-0.4.0/src/framerudiments.egg-info → framerudiments-0.4.1}/PKG-INFO +22 -1
  2. {framerudiments-0.4.0 → framerudiments-0.4.1}/README.md +21 -0
  3. {framerudiments-0.4.0 → framerudiments-0.4.1}/RELEASE_NOTES.md +13 -0
  4. framerudiments-0.4.1/docs/controlled-audio-response.md +105 -0
  5. framerudiments-0.4.1/docs/media/rangoli-transcript.md +12 -0
  6. framerudiments-0.4.1/docs/media/rangoli.mp4 +0 -0
  7. framerudiments-0.4.1/docs/media/rangoli.png +0 -0
  8. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/project-format.md +1 -0
  9. framerudiments-0.4.1/docs/rangoli.md +69 -0
  10. {framerudiments-0.4.0 → framerudiments-0.4.1}/pyproject.toml +1 -1
  11. framerudiments-0.4.1/scripts/Run-ControlledPresetAnalysis.ps1 +58 -0
  12. framerudiments-0.4.1/scripts/controlled_preset_analysis.py +274 -0
  13. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/__init__.py +1 -1
  14. framerudiments-0.4.1/src/framerudiments/audio_probes.py +132 -0
  15. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/cli.py +5 -2
  16. framerudiments-0.4.1/src/framerudiments/controlled_profiling.py +177 -0
  17. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/demo.py +28 -0
  18. framerudiments-0.4.1/src/framerudiments/rangoli_renderer.py +88 -0
  19. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/rudiment_renderers.py +3 -0
  20. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visualisation_catalogue.py +5 -1
  21. framerudiments-0.4.1/src/framerudiments/visualiser_assets/rangoli-background.milk +26 -0
  22. {framerudiments-0.4.0 → framerudiments-0.4.1/src/framerudiments.egg-info}/PKG-INFO +22 -1
  23. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments.egg-info/SOURCES.txt +13 -0
  24. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_advanced_renderers.py +1 -0
  25. framerudiments-0.4.1/tests/test_controlled_audio.py +134 -0
  26. framerudiments-0.4.1/tests/test_rangoli_renderer.py +47 -0
  27. {framerudiments-0.4.0 → framerudiments-0.4.1}/AGENTS.md +0 -0
  28. {framerudiments-0.4.0 → framerudiments-0.4.1}/LICENSE +0 -0
  29. {framerudiments-0.4.0 → framerudiments-0.4.1}/MANIFEST.in +0 -0
  30. {framerudiments-0.4.0 → framerudiments-0.4.1}/analysis-releases.json +0 -0
  31. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/FrameRudiments-PATCH_WORKFLOW.md +0 -0
  32. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/annular-modulation.md +0 -0
  33. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/authoring-workspace.md +0 -0
  34. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/beat-alignment.md +0 -0
  35. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/expanded-effects.md +0 -0
  36. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/extraction.md +0 -0
  37. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/full-preset-analysis.md +0 -0
  38. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/keyframed-mattes.md +0 -0
  39. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/media/beat-alignment-evidence.json +0 -0
  40. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/media/beat-alignment.mp4 +0 -0
  41. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/media/beat-alignment.png +0 -0
  42. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/media/demo-transcript.md +0 -0
  43. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/media/effects-pipeline.svg +0 -0
  44. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/media/full-frame-comparison.png +0 -0
  45. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/media/full-frame-demo.mp4 +0 -0
  46. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/media/media-evidence.json +0 -0
  47. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/media/preset-test-cards.png +0 -0
  48. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/media/test-card-inputs/colour-bars.png +0 -0
  49. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/media/test-card-inputs/grid-rings.png +0 -0
  50. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/media/test-card-inputs/text-card.png +0 -0
  51. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/multi-stem-modulation.md +0 -0
  52. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/music-reactive-3d.md +0 -0
  53. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/particle-smoke.md +0 -0
  54. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/phase3-compositing.md +0 -0
  55. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/preset-behaviour.md +0 -0
  56. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/preset-profiling.md +0 -0
  57. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/projectm-local-runtime.md +0 -0
  58. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/quality-effects.md +0 -0
  59. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/rich-lyric-effects.md +0 -0
  60. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/rudiment-renderers.md +0 -0
  61. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/scoped-post-effects.md +0 -0
  62. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/solid-spatial-renderers.md +0 -0
  63. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/spatial-renderers.md +0 -0
  64. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/spatiotemporal-supersampling.md +0 -0
  65. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/spectrum.md +0 -0
  66. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/sprite-visualisations.md +0 -0
  67. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/stem-sources-and-masks.md +0 -0
  68. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/variable-bpm-word-subtitles.md +0 -0
  69. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/visualisation-atlas.md +0 -0
  70. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/visualisation-coverage-matrix.md +0 -0
  71. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/visualiser-routing.md +0 -0
  72. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/visualisers.md +0 -0
  73. {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/workflow-media.md +0 -0
  74. {framerudiments-0.4.0 → framerudiments-0.4.1}/integration/test_music_spatial_gpu.py +0 -0
  75. {framerudiments-0.4.0 → framerudiments-0.4.1}/integration/test_preset_analysis.py +0 -0
  76. {framerudiments-0.4.0 → framerudiments-0.4.1}/integration/test_released_preset_analysis.py +0 -0
  77. {framerudiments-0.4.0 → framerudiments-0.4.1}/integration/test_visualisers_gpu.py +0 -0
  78. {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/Run-FullPresetAnalysis.ps1 +0 -0
  79. {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/Run-PresetBehaviourAnalysis.ps1 +0 -0
  80. {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/authoring_preview.py +0 -0
  81. {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/build_sprite_assets.py +0 -0
  82. {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/check_projectm_runtime.py +0 -0
  83. {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/check_release_packages.py +0 -0
  84. {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/ensure_projectm_runtime.py +0 -0
  85. {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/full_preset_analysis.py +0 -0
  86. {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/generate_particle_gallery.py +0 -0
  87. {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/generate_post_effect_gallery.py +0 -0
  88. {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/generate_quality_gallery.py +0 -0
  89. {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/generate_rich_lyric_gallery.py +0 -0
  90. {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/generate_sprite_gallery.py +0 -0
  91. {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/generate_supersampling_gallery.py +0 -0
  92. {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/generate_timing_gallery.py +0 -0
  93. {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/generate_visualisation_gallery.py +0 -0
  94. {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/generate_visualiser_routing_gallery.py +0 -0
  95. {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/install_analysis_releases.py +0 -0
  96. {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/prepare_pixelcue_taggers.py +0 -0
  97. {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/preset_behaviour_pipeline.py +0 -0
  98. {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/profile_visualisation_coverage.py +0 -0
  99. {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/profile_visualisers.py +0 -0
  100. {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/projectm_dll_diagnostics.py +0 -0
  101. {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/repair_projectm_mingw.py +0 -0
  102. {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/select_projectm_generator.py +0 -0
  103. {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/validate_patch.py +0 -0
  104. {framerudiments-0.4.0 → framerudiments-0.4.1}/setup.cfg +0 -0
  105. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/__main__.py +0 -0
  106. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/advanced_renderers.py +0 -0
  107. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/atlas.py +0 -0
  108. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/beat_alignment.py +0 -0
  109. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/beat_timeline.py +0 -0
  110. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/choreography.py +0 -0
  111. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/circular_renderers.py +0 -0
  112. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/compositor.py +0 -0
  113. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/effect_catalogue.py +0 -0
  114. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/effect_renderers.py +0 -0
  115. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/effects.py +0 -0
  116. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/encoding.py +0 -0
  117. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/flight.py +0 -0
  118. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/gpu_spatial_backend.py +0 -0
  119. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/io.py +0 -0
  120. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/keyframes.py +0 -0
  121. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/layer_animation.py +0 -0
  122. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/layer_displacement.py +0 -0
  123. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/layer_masks.py +0 -0
  124. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/lyric_indicator.py +0 -0
  125. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/modulation.py +0 -0
  126. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/motion.py +0 -0
  127. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/music_spatial_renderers.py +0 -0
  128. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/output_quality.py +0 -0
  129. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/particle_engine.py +0 -0
  130. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/post_effects.py +0 -0
  131. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/preset_library.py +0 -0
  132. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/preset_profiling.py +0 -0
  133. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/profile_analysis.py +0 -0
  134. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/project.py +0 -0
  135. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/projectm_backend.py +0 -0
  136. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/quality_effects.py +0 -0
  137. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/render.py +0 -0
  138. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/rich_subtitles.py +0 -0
  139. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/scoped_effects.py +0 -0
  140. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/solid_spatial_renderers.py +0 -0
  141. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/spatial_renderers.py +0 -0
  142. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/spectrum.py +0 -0
  143. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/arcade.png +0 -0
  144. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/crystal.png +0 -0
  145. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/fire.png +0 -0
  146. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/generated-neon.png +0 -0
  147. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/glass.png +0 -0
  148. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/hud.png +0 -0
  149. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/ice.png +0 -0
  150. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/lcd-amber.png +0 -0
  151. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/lcd-green.png +0 -0
  152. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/lcd.png +0 -0
  153. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/led.png +0 -0
  154. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/manifest.json +0 -0
  155. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/metal.png +0 -0
  156. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/mono.png +0 -0
  157. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/neon.png +0 -0
  158. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/pixel.png +0 -0
  159. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/plasma.png +0 -0
  160. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/vfd.png +0 -0
  161. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_catalogue.py +0 -0
  162. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_renderers.py +0 -0
  163. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/stem_blend.py +0 -0
  164. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/stemlab.py +0 -0
  165. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/subtitles.py +0 -0
  166. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/super_sampling.py +0 -0
  167. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/terrain_field.py +0 -0
  168. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/timeline.py +0 -0
  169. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visual_style.py +0 -0
  170. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visualiser_assets/butterchurn-page.js +0 -0
  171. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visualiser_assets/butterchurn-worker.mjs +0 -0
  172. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visualiser_assets/feedback.json +0 -0
  173. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visualiser_assets/feedback.milk +0 -0
  174. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visualiser_assets/julia.json +0 -0
  175. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visualiser_assets/julia.milk +0 -0
  176. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visualiser_assets/kaleidoscope.json +0 -0
  177. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visualiser_assets/kaleidoscope.milk +0 -0
  178. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visualiser_assets/package-lock.json +0 -0
  179. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visualiser_assets/package.json +0 -0
  180. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visualiser_routing.py +0 -0
  181. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visualiser_setup.py +0 -0
  182. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visualisers.py +0 -0
  183. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/word_timing.py +0 -0
  184. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments.egg-info/dependency_links.txt +0 -0
  185. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments.egg-info/entry_points.txt +0 -0
  186. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments.egg-info/requires.txt +0 -0
  187. {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments.egg-info/top_level.txt +0 -0
  188. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/conftest.py +0 -0
  189. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_adapters.py +0 -0
  190. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_authoring_preview.py +0 -0
  191. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_beat_alignment.py +0 -0
  192. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_behaviour_pipeline.py +0 -0
  193. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_coverage_matrix.py +0 -0
  194. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_default_antialias.py +0 -0
  195. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_effect_batch.py +0 -0
  196. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_extracted_helpers.py +0 -0
  197. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_flight.py +0 -0
  198. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_full_preset_analysis.py +0 -0
  199. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_gpu_ci_isolation.py +0 -0
  200. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_keyframes.py +0 -0
  201. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_layer_masks.py +0 -0
  202. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_lyrics.py +0 -0
  203. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_music_spatial_pipeline.py +0 -0
  204. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_music_spatial_renderers.py +0 -0
  205. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_particle_engine.py +0 -0
  206. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_patch_validation.py +0 -0
  207. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_phase3_animation.py +0 -0
  208. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_phase3_gpu_injection.py +0 -0
  209. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_pipeline.py +0 -0
  210. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_preset_profiling.py +0 -0
  211. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_projectm_dll_diagnostics.py +0 -0
  212. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_projectm_generator.py +0 -0
  213. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_projectm_runtime_preflight.py +0 -0
  214. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_pytest_temp_isolation.py +0 -0
  215. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_quality_effects.py +0 -0
  216. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_release_metadata.py +0 -0
  217. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_repair_projectm_mingw.py +0 -0
  218. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_rich_subtitles.py +0 -0
  219. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_rudiment_renderers.py +0 -0
  220. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_scoped_effects.py +0 -0
  221. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_solid_spatial_integration.py +0 -0
  222. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_solid_spatial_renderers.py +0 -0
  223. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_spatial_renderers.py +0 -0
  224. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_spectrum.py +0 -0
  225. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_sprite_renderers.py +0 -0
  226. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_stem_blend.py +0 -0
  227. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_stem_source_integration.py +0 -0
  228. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_supersampling.py +0 -0
  229. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_timeline.py +0 -0
  230. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_variable_bpm_words.py +0 -0
  231. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_visualisation_modulation.py +0 -0
  232. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_visualiser_routing.py +0 -0
  233. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_visualisers.py +0 -0
  234. {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_windows_launcher_splitpath.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: framerudiments
3
- Version: 0.4.0
3
+ Version: 0.4.1
4
4
  Summary: Deterministic Shorts and lyric visualisers using DanceRudiments and StemLab evidence.
5
5
  Author: Kieran Simkin
6
6
  License-Expression: MIT
@@ -28,6 +28,27 @@ Dynamic: license-file
28
28
 
29
29
  # FrameRudiments
30
30
 
31
+ ## Native rangoli drawing and clean projectM backgrounds
32
+
33
+ Stack independent `rangoli` Bezier-petal rings over retained native bass/treble
34
+ recordings. Smooth floating-point geometry uses the existing high-quality font
35
+ and vector rasterizer; the established projectM routing keeps petals and lyrics
36
+ clean above an audio-reactive background. No private song assets are bundled.
37
+ See [configuration, limits and actual video](docs/rangoli.md).
38
+
39
+ ![Actual synthetic FrameRudiments rangoli and font example](docs/media/rangoli.png)
40
+
41
+ ## Controlled sound-response analysis
42
+
43
+ The new `scripts/Run-ControlledPresetAnalysis.ps1` tests **zero image feed**, silence,
44
+ level-matched low/mid/high probes and rhythmic test music across independent render
45
+ trials. Temporal measurements run without neural models. Summaries exclude all
46
+ reference-fed conditions; optional texture-transfer results stay separate.
47
+ See [controlled audio responses](docs/controlled-audio-response.md) for setup,
48
+ protocol limits, supplied-music tests, repeat controls and safe resume.
49
+ The pilot uses a separate project-local analysis environment and does not alter the
50
+ stable releases pinned below or previous catalogue results.
51
+
31
52
  ## Pinned visual-analysis releases
32
53
 
33
54
  PixelCue **0.9.1** and PrismMoves **0.2.0** are pinned by final release URL,
@@ -1,5 +1,26 @@
1
1
  # FrameRudiments
2
2
 
3
+ ## Native rangoli drawing and clean projectM backgrounds
4
+
5
+ Stack independent `rangoli` Bezier-petal rings over retained native bass/treble
6
+ recordings. Smooth floating-point geometry uses the existing high-quality font
7
+ and vector rasterizer; the established projectM routing keeps petals and lyrics
8
+ clean above an audio-reactive background. No private song assets are bundled.
9
+ See [configuration, limits and actual video](docs/rangoli.md).
10
+
11
+ ![Actual synthetic FrameRudiments rangoli and font example](docs/media/rangoli.png)
12
+
13
+ ## Controlled sound-response analysis
14
+
15
+ The new `scripts/Run-ControlledPresetAnalysis.ps1` tests **zero image feed**, silence,
16
+ level-matched low/mid/high probes and rhythmic test music across independent render
17
+ trials. Temporal measurements run without neural models. Summaries exclude all
18
+ reference-fed conditions; optional texture-transfer results stay separate.
19
+ See [controlled audio responses](docs/controlled-audio-response.md) for setup,
20
+ protocol limits, supplied-music tests, repeat controls and safe resume.
21
+ The pilot uses a separate project-local analysis environment and does not alter the
22
+ stable releases pinned below or previous catalogue results.
23
+
3
24
  ## Pinned visual-analysis releases
4
25
 
5
26
  PixelCue **0.9.1** and PrismMoves **0.2.0** are pinned by final release URL,
@@ -1,3 +1,16 @@
1
+ # FrameRudiments 0.4.1
2
+
3
+ - Native `rangoli` Bezier-petal renderer with independent scale, rotation and
4
+ lift axes, explicit halo/stroke bounds, transparent fills and optional glow.
5
+ - Uses the existing genuine high-resolution font/vector rasterization,
6
+ source-clock sampling, saved native recordings and technical video QA.
7
+ - Original texture-free projectM background preset composes through existing
8
+ per-element routing, keeping petals and lyrics clean above the GPU output.
9
+ - `demo --rangoli`, regression coverage and [actual synthetic video/still with
10
+ transcript](docs/rangoli.md). No private campaign media or downloaded models.
11
+ - Stem analysis/smoothing remain in StemLab and native playback remains in
12
+ DanceRudiments; this release does not duplicate either engine.
13
+
1
14
  # FrameRudiments 0.4.0
2
15
 
3
16
  ## Rendering and authoring
@@ -0,0 +1,105 @@
1
+ # Controlled preset audio responses
2
+
3
+ The new `Run-ControlledPresetAnalysis.ps1` measures the preset with **zero
4
+ reference-image contribution**. It does not use artwork, lyrics, colour bars,
5
+ rings, test-card text or captions to write the preset summary. The ordinary
6
+ renderer, legacy profiling commands and stable analysis release lock are unchanged.
7
+
8
+ ## Run a pilot
9
+
10
+ Install the supplied development PrismMoves wheel into the **separate** project-local
11
+ `models/.venv-audio-effects` environment using the update bundle's installer. It
12
+ uses the released PixelCue 0.9.1 sequence API. Do not overwrite or retag the existing
13
+ PrismMoves 0.2.0 release. After validating the pilot, release/pin a new PrismMoves
14
+ version through the usual tested process.
15
+
16
+ ```powershell
17
+ .\scripts\Run-ControlledPresetAnalysis.ps1 -Limit 2
18
+ .\scripts\Run-ControlledPresetAnalysis.ps1 -Extended -TextureControls -Limit 2 `
19
+ -OutputDirectory 'visualiser-analysis\audio-response-extended'
20
+ .\scripts\Run-ControlledPresetAnalysis.ps1 -AudioFile 'Z:\My Songs\track.wav' -AudioStart 30 -Limit 2 `
21
+ -OutputDirectory 'visualiser-analysis\audio-response-music'
22
+ ```
23
+
24
+ Changing a capture option requires a new `-OutputDirectory` under
25
+ `visualiser-analysis/`. For example, use a distinct folder for the extended pilot.
26
+ `-Limit 0` explicitly processes all remaining presets. Presets are shuffled and
27
+ alternate between projectM and Butterchurn. `-Engine` and `-PresetId` restrict a pilot.
28
+
29
+ The default output is `visualiser-analysis/audio-response-catalogue/index.html`.
30
+ Reports have a single preset-only paragraph, a table of sound effects, repeat-level
31
+ measurements, evidence references and an explicitly separate reference-transfer
32
+ section. Raw frames, PCM, condition receipts and logs stay in ignored `_work/`.
33
+ Nothing is committed, pushed or published by the analysis command.
34
+
35
+ ## Protocol
36
+
37
+ Every condition uses a new renderer process, fixed 60-fps simulation, 15-fps
38
+ capture, 384-pixel output, two seconds of silent initialisation, and a 12-second
39
+ window including the final tail. Audio is supplied at every simulation step, not
40
+ only at captured frames. The 1024-stereo-sample history windows overlap at 44.1 kHz
41
+ and 60 fps: lowering capture rate does not leave holes in transient input.
42
+
43
+ Core probes are silence, 80 Hz pulses, 1 kHz pulses, 6 kHz pulses and an explicitly
44
+ synthetic rhythmic multiband fixture. Three independent trials give **15 clips and
45
+ 2,715 output captures per preset**. No neural model is loaded: semantic calls are
46
+ zero. This costs more capture/measurement than the older 368-frame preset test,
47
+ but does not multiply expensive per-frame model inference.
48
+
49
+ The three tones share a click-free envelope and linear PCM RMS over the exposure
50
+ window. Irregular onset times vary between trials but match between frequencies
51
+ within a trial. The extended protocol adds half-amplitude low pulses (-6.02 dB),
52
+ a faster low-pulse sequence, sustained low-frequency sound, and broadband bursts.
53
+ The fast/sustained tests conserve exposure-window energy, not instantaneous peak
54
+ level: do not interpret them as a pure tempo-only or pure-transient perceptual test.
55
+ Probe frequencies identify supplied PCM, not the visualiser's internal band bins.
56
+ Equal linear RMS is not equal perceived loudness.
57
+
58
+ An optional supplied musical excerpt is decoded into a separate 44.1 kHz stereo
59
+ measurement signal, with silent lead-in and tail. Its original level is retained.
60
+ The source checksum and excerpt start are recorded. Artist audio files and their
61
+ lyric/cue/source timing are never modified. The test requires at least 8.5 seconds
62
+ of audio following the selected offset. It does not separate or identify stems.
63
+
64
+ ## Input isolation
65
+
66
+ `engine-only` uses source mix **0**, not black pixels injected at 35% opacity.
67
+ The existing native bridges still own all preset processing. Optional
68
+ `-TextureControls` feeds two fixed achromatic, aperiodic texture fields at 15%.
69
+ These help examine image transformations, but all of their measurements and
70
+ interpretations are excluded from the main summary by construction.
71
+
72
+ No palette, ring, stripe, flower, object, preset filename, artist name or reference
73
+ caption can become a summary claim. If a preset produces no visible standalone
74
+ output, the report says so; it does not silently substitute a reference-fed result.
75
+
76
+ ## Audio attribution
77
+
78
+ PrismMoves compares each sound with silence on the same clock, preset, input role,
79
+ resolution and renderer identity. It subtracts the pre-exposure difference and
80
+ requires independent-trial support above both a metric-specific minimum effect
81
+ and repeat variation. Short responses are also tested in onset-aligned windows.
82
+ Untracked flow, missing files, changed hashes and incomplete conditions are not
83
+ zero motion. Frequency, level and envelope contrasts remain separately identified.
84
+
85
+ Butterchurn uses paired seeds. projectM exposes no deterministic seed API here;
86
+ its repeated controls estimate variation instead. These are conservative
87
+ engineering screens, **not p-values, calibrated confidence, causal proof on all
88
+ GPUs or psychoacoustic/music-category claims**. A detected 80 Hz response does not
89
+ establish that a preset reacts specifically to bass instruments or kick drums.
90
+ An unresolved response is not proof of insensitivity. No flash-safety, beat-locking,
91
+ subjective quality, trail persistence or banding claim is invented.
92
+
93
+ ## Resume and evidence
94
+
95
+ Rerun the same command to continue; complete conditions validate retained hashes
96
+ before reuse. `-RetryFailed` preserves an old partial attempt before trying a fresh
97
+ one. `-Reanalyse` reuses capture evidence and writes new analysis while retaining
98
+ previous reports under `history/`. Failed native processes have their own logs and
99
+ do not manufacture analysis frames. Changed protocol/code/runtime settings require
100
+ a new output directory. A run lock prevents concurrent writers to the same output.
101
+
102
+ Existing behaviour/legacy reports remain untouched. Their continuously injected
103
+ inputs and pooled prose cannot be retroactively converted into isolated audio
104
+ experiments. They are useful for choosing presets to retest, not for inventing
105
+ missing no-feed controls.
@@ -0,0 +1,12 @@
1
+ # Rangoli demonstration transcript
2
+
3
+ Synthetic software demonstration, FrameRudiments 0.4.1 candidate. Example words
4
+ read “Native petal rings”, “Signals into motion”, “Words into light” and
5
+ “Keep the clock in sight”. The centre ring
6
+ expands and rotates while a second ring moves separately. Caption and title
7
+ outlines use the existing high-quality pinned-font path. No cultural claim,
8
+ private release, artist endorsement or attended-listening approval is implied.
9
+
10
+ The documentation clip demonstrates native geometry and font composition.
11
+ The separate private song previews exercise the real projectM GPU background;
12
+ do not label this geometry-only clip as GPU acceptance evidence.
@@ -21,6 +21,7 @@ the inputs are checked again before and after a render.
21
21
  | `captions` | `box` [left,top,right,bottom], `font_size`, optional `min_font_size`, `colour`, `panel`, `stroke`, `line_spacing`, `mode` (`current` or `neighbours`). |
22
22
  | `identity` | List of `{text, style}`; each style uses the same text-block fields as captions. |
23
23
  | `layers` | Ordered sprite, legacy bar and modular rudiment layers described below. |
24
+ | Native radial petals | Use `type: "rudiment", renderer: "rangoli"` with independent scale/spin/lift axes; see [rangoli configuration and actual demo](rangoli.md). |
24
25
  | `visualiser_routing` | Optional per-element GPU input/overlay policies. Feed continuously, only for first N native pips after visibility onset, or never; see [routing](visualiser-routing.md). |
25
26
  | `lyric_art` | `{items: [{text, asset}], placement: <sprite fields>, fallback: "text" or "error"}`. Exact text lookup preserves canonical lyric association. `error` requires every visible lyric to have an asset. |
26
27
  | `stemlab_loop` | `{file: <pinned loops report>, id: <accepted loop id>}`; imports native bounds/rate, verifies source SHA, rejects conflicting explicit audio values. Does not approve a seam. |
@@ -0,0 +1,69 @@
1
+ # Native rangoli petal rings
2
+
3
+ `renderer: "rangoli"` redraws a radial ring of cubic Bezier petals directly
4
+ from independent native dimensions, rather than resizing and expanding rotated
5
+ bitmap rectangles. Stack rings with separate pinned bass, drum, voice or treble
6
+ recordings. The shared source clock, caption ledger, encoder and QA stay intact.
7
+ This geometric vocabulary does not assert cultural authenticity or endorsement.
8
+
9
+ Create a portable synthetic example with `framerudiments demo demo --rangoli
10
+ --font /path/to/licensed.ttf --width 640 --height 360`, then use the normal
11
+ `plan`, `preflight` and `render` commands. No private artwork is required.
12
+
13
+ ![Actual synthetic native petal geometry and supersampled caption output](media/rangoli.png)
14
+
15
+ [Play the actual synthetic demonstration](media/rangoli.mp4), with user-controlled
16
+ playback. [Transcript and evidence context](media/rangoli-transcript.md).
17
+ The demo uses synthetic audio and example words, never a private song/master.
18
+
19
+ ```json
20
+ {
21
+ "id": "bass-centre", "type": "rudiment", "renderer": "rangoli",
22
+ "bounds": [80, 80, 560, 560],
23
+ "motion": {"kind": "recording", "file": {"path": "bass.json", "sha256": "<hash>"},
24
+ "axes": ["pulse", "angle"]},
25
+ "history_frames": 1,
26
+ "style": {"petals": 16, "radius": 0.4, "petal_length": 0.7,
27
+ "petal_width": 0.2, "scale_axis": 0, "scale_gain": 0.6,
28
+ "rotation_axis": 1, "rotation_gain": 16384,
29
+ "fill": "#dd339955", "outline": "#fff3d9ee", "line_width": 2}
30
+ }
31
+ ```
32
+
33
+ `radius` is the fraction of the padded viewport half-short-edge. Length and
34
+ width are relative to that radius; angles are degrees. `scale_gain` multiplies
35
+ the selected native value, giving `1 + value * gain`. `rotation_gain` maps its
36
+ own axis in degrees; a retained cumulative angle recording may be scaled back
37
+ from its documented normalization. `dy_gain` is a fraction of viewport height.
38
+ All axis choices are explicit and missing axes fail. Geometry, stroke and halo
39
+ must fit the viewport; overflow aborts rather than silently clipping a large bop.
40
+
41
+ Styles: `petals` 3–128; `radius` .01–1; `petal_length` .01–1;
42
+ `petal_width` .001–.5; finite `angle`; `line_width` 1–64 pixels;
43
+ `fill` and `outline` CSS RGBA colours; `glow` 0–.1 of short edge;
44
+ `scale_gain` -.99–.99; `rotation_gain` ±1,000,000; `dy_gain` ±.5;
45
+ `scale_axis`, `rotation_axis`, `dy_axis` 0–255. Shared palette, padding,
46
+ background, opacity, modulation and gates remain supported.
47
+
48
+ ## Font and projectM composition
49
+
50
+ Use existing `render_quality.spatial_scale: 4` for genuinely higher-resolution
51
+ TTF/OTF outlines and vector petals. Temporal samples are distinct source times,
52
+ not interpolated video frames; select an explicit preview budget when needed.
53
+ The existing rich-text stroke/shadow/gradient options improve contrast without
54
+ blurring the glyph itself. Fonts remain pinned licensed inputs, not bundled.
55
+
56
+ The supplied `visualiser_assets/rangoli-background.milk` is an original,
57
+ texture-free, restrained audio-reactive projectM preset. Pin its exact bytes
58
+ with an external-preset file reference and `trusted_preset: true`. It uses
59
+ the established projectM bridge/PCM/time contract, not another engine.
60
+ Route only `background` into projectM, and overlay each petal layer, identity
61
+ and caption cleanly using `visualiser_routing`. This keeps the song legible
62
+ while the background responds to the real soundtrack. ProjectM GPU acceptance
63
+ and cleanup evidence are separate from a static synthetic drawing.
64
+
65
+ Smoothing and stem analysis remain in StemLab. Native sampling and bounded
66
+ recordings remain in DanceRudiments. No hidden envelope normalization,
67
+ beat-estimation, integrator, wrapping or substituted recording phase is added.
68
+ Rendering alone authorizes no campaign publication. Inspect final glyphs,
69
+ contrast, flash/motion comfort, mobile scale and attended listening separately.
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "framerudiments"
7
- version = "0.4.0"
7
+ version = "0.4.1"
8
8
  description = "Deterministic Shorts and lyric visualisers using DanceRudiments and StemLab evidence."
9
9
  requires-python = ">=3.11"
10
10
  readme = "README.md"
@@ -0,0 +1,58 @@
1
+ #Requires -Version 5.1
2
+ <#
3
+ .SYNOPSIS
4
+ Measure standalone preset effects and repeated audio responses, without reference captions.
5
+ .EXAMPLE
6
+ .\scripts\Run-ControlledPresetAnalysis.ps1 -Limit 2
7
+ .EXAMPLE
8
+ .\scripts\Run-ControlledPresetAnalysis.ps1 -Extended -TextureControls -Limit 2
9
+ .EXAMPLE
10
+ .\scripts\Run-ControlledPresetAnalysis.ps1 -AudioFile 'Z:\My Songs\track.wav' -Limit 2
11
+ #>
12
+ [CmdletBinding()]
13
+ param(
14
+ [ValidateRange(0,2147483647)][int]$Limit = 2,
15
+ [ValidateRange(3,6)][int]$Trials = 3,
16
+ [ValidateSet(5,10,15,20,30)][int]$CaptureFps = 15,
17
+ [ValidateRange(64,1024)][int]$RenderEdge = 384,
18
+ [string]$OutputDirectory,
19
+ [string]$AudioFile,
20
+ [ValidateRange(0,86400)][double]$AudioStart = 0,
21
+ [ValidateSet('butterchurn','projectm')][string]$Engine,
22
+ [string[]]$PresetId,
23
+ [switch]$Extended,
24
+ [switch]$TextureControls,
25
+ [switch]$RetryFailed,
26
+ [switch]$Reanalyse
27
+ )
28
+ Set-StrictMode -Version Latest
29
+ $ErrorActionPreference = 'Stop'
30
+ $repo = (Resolve-Path (Join-Path $PSScriptRoot '..')).Path
31
+ $render = Join-Path $repo 'models\.venv-render\Scripts\python.exe'
32
+ $analysis = Join-Path $repo 'models\.venv-audio-effects\Scripts\python.exe'
33
+ if (-not (Test-Path -LiteralPath $render) -or -not (Test-Path -LiteralPath $analysis)) {
34
+ throw 'Install the controlled-analysis update first. The existing analysis environment is not replaced.'
35
+ }
36
+ & $analysis -I -c 'import cv2; from prismmoves.controlled_response import analyse'
37
+ if ($LASTEXITCODE -ne 0) { throw 'Controlled-response analysis API is not installed in the isolated environment.' }
38
+ # The existing skip-setup path locates FFmpeg/browser/Node and validates projectM.
39
+ # It performs no Python dependency or neural checkpoint installation.
40
+ & (Join-Path $PSScriptRoot 'Run-FullPresetAnalysis.ps1') -SkipSetup -InstallOnly
41
+ if ($LASTEXITCODE -ne 0) { throw 'Renderer preflight failed.' }
42
+ $params = @((Join-Path $PSScriptRoot 'controlled_preset_analysis.py'),
43
+ '--analysis-python', $analysis, '--limit', [string]$Limit, '--trials', [string]$Trials,
44
+ '--capture-fps', [string]$CaptureFps, '--edge', [string]$RenderEdge)
45
+ if ($OutputDirectory) { $params += @('--output',$OutputDirectory) }
46
+ if ($AudioFile) {
47
+ $params += @('--audio',(Resolve-Path -LiteralPath $AudioFile).Path,
48
+ '--audio-start',$AudioStart.ToString([Globalization.CultureInfo]::InvariantCulture))
49
+ }
50
+ if ($Engine) { $params += @('--engine',$Engine) }
51
+ foreach ($id in $PresetId) { $params += @('--id',$id) }
52
+ if ($Extended) { $params += '--extended' }
53
+ if ($TextureControls) { $params += '--texture-controls' }
54
+ if ($RetryFailed) { $params += '--retry-failed' }
55
+ if ($Reanalyse) { $params += '--reanalyse' }
56
+ & $render @params
57
+ if ($LASTEXITCODE -eq 2) { Write-Warning 'Some conditions are partial; inspect the gallery and saved logs.' }
58
+ elseif ($LASTEXITCODE -ne 0) { throw 'Controlled analysis stopped. Read the saved stage logs.' }
@@ -0,0 +1,274 @@
1
+ """Controlled audio response sweep: fresh renderer per condition, no neural inference.
2
+
3
+ Separate output from legacy and behaviour catalogues. Nothing is published remotely.
4
+ """
5
+ from __future__ import annotations
6
+
7
+ import argparse
8
+ from array import array
9
+ from contextlib import contextmanager
10
+ import hashlib
11
+ import json
12
+ import os
13
+ from pathlib import Path
14
+ import random
15
+ import shutil
16
+ import subprocess
17
+ import sys
18
+ import time
19
+
20
+ ROOT = Path(__file__).resolve().parents[1]
21
+ if __name__ == "__main__":
22
+ # Use this checkout for capture orchestration, never an older installed wheel.
23
+ sys.path.insert(0, str(ROOT / "src"))
24
+
25
+
26
+ def read(path):
27
+ return json.loads(Path(path).read_text(encoding="utf-8"))
28
+
29
+
30
+ def digest(path):
31
+ return hashlib.sha256(Path(path).read_bytes()).hexdigest()
32
+
33
+
34
+ def write(path, data):
35
+ path = Path(path)
36
+ path.parent.mkdir(parents=True, exist_ok=True)
37
+ temp = path.with_name(path.name + ".tmp")
38
+ temp.write_text(json.dumps(data, sort_keys=True, allow_nan=False, indent=2) + "\n", encoding="utf-8")
39
+ os.replace(temp, path)
40
+
41
+
42
+ @contextmanager
43
+ def exclusive(work):
44
+ lock = work / "run.lock"
45
+ try:
46
+ handle = lock.open("x")
47
+ except FileExistsError as exc:
48
+ raise ValueError(f"Another run or interrupted process owns {lock}. Check that process before removing this lock.") from exc
49
+ try:
50
+ with handle:
51
+ handle.write(str(os.getpid()))
52
+ yield
53
+ finally:
54
+ lock.unlink(missing_ok=True)
55
+
56
+
57
+ def run_stage(command, log, timeout):
58
+ with Path(log).open("wb") as stream:
59
+ try:
60
+ environment = dict(os.environ)
61
+ environment["PYTHONPATH"] = str(ROOT / "src")
62
+ return subprocess.run(command, cwd=ROOT, env=environment, stdout=stream,
63
+ stderr=subprocess.STDOUT, timeout=timeout).returncode
64
+ except subprocess.TimeoutExpired:
65
+ return 124
66
+
67
+
68
+ def ordered_presets(rows, seed):
69
+ rng = random.Random(seed)
70
+ groups = {engine: [r for r in rows if r["engine"] == engine] for engine in ("projectm", "butterchurn")}
71
+ for group in groups.values():
72
+ rng.shuffle(group)
73
+ result = []
74
+ while any(groups.values()):
75
+ for engine in groups:
76
+ if groups[engine]:
77
+ result.append(groups[engine].pop())
78
+ return result
79
+
80
+
81
+ def supplied_music(path, start, trial, directory, ffmpeg):
82
+ """A separate analysis excerpt; never rewrites artist audio or its clocks."""
83
+ from framerudiments.audio_probes import DURATION, SAMPLE_RATE
84
+ if start < 0 or not path.is_file():
85
+ raise ValueError("Invalid supplied musical excerpt")
86
+ target = directory / f"music-{trial}.f32"
87
+ receipt = target.with_suffix(".json")
88
+ identity = {"source_sha256": digest(path), "source_start_seconds": start,
89
+ "sample_rate": SAMPLE_RATE, "duration_seconds": DURATION, "trial": trial}
90
+ if receipt.exists():
91
+ saved = read(receipt)
92
+ if any(saved.get(k) != v for k, v in identity.items()) or digest(target) != saved["sha256"]:
93
+ raise ValueError("Supplied music changed; use a new output workspace")
94
+ return saved
95
+ decode = directory / f"music-decode-{time.time_ns()}.f32"
96
+ subprocess.run([ffmpeg, "-n", "-v", "error", "-ss", str(start), "-i", str(path),
97
+ "-t", "8.5", "-vn", "-ac", "2", "-ar", str(SAMPLE_RATE), "-f", "f32le", str(decode)], check=True)
98
+ data = decode.read_bytes()
99
+ if len(data) < int(8.5 * SAMPLE_RATE) * 8:
100
+ raise ValueError("Supply at least 8.5 seconds of music after the selected start")
101
+ data = bytes(2 * SAMPLE_RATE * 8) + data[:int(8.5 * SAMPLE_RATE) * 8] + bytes(int(1.5 * SAMPLE_RATE) * 8)
102
+ pcm = array("f")
103
+ pcm.frombytes(data)
104
+ if sys.byteorder != "little":
105
+ pcm.byteswap()
106
+ import math
107
+ if any(not math.isfinite(x) or abs(x) > 1 for x in pcm):
108
+ raise ValueError("Musical PCM contains non-finite or out-of-range samples")
109
+ target.write_bytes(data)
110
+ saved = dict(identity, id="music", kind="music", path=str(target), sha256=digest(target),
111
+ channels=2, format="f32le", events=[], analysis_window=[2, 10.5], warmup_seconds=2,
112
+ samples_per_channel=len(data)//8,
113
+ rms=math.sqrt(sum(x*x for x in pcm[2*SAMPLE_RATE*2:int(10.5*SAMPLE_RATE)*2])/(8.5*SAMPLE_RATE*2)),
114
+ peak=max(abs(x) for x in pcm),
115
+ level_convention="Original excerpt level; no automatic loudness matching")
116
+ write(receipt, saved)
117
+ return saved
118
+
119
+
120
+ def run(args):
121
+ from framerudiments.audio_probes import CORE, EXTENDED, PROTOCOL, make_probe
122
+ from framerudiments.preset_library import load_library
123
+ out = (args.output if args.output.is_absolute() else ROOT / args.output).resolve()
124
+ if not out.is_relative_to((ROOT / "visualiser-analysis").resolve()):
125
+ raise ValueError("Output must stay under this project's visualiser-analysis directory")
126
+ if not args.analysis_python.is_file():
127
+ raise ValueError("Install the isolated audio-effects environment first")
128
+ subprocess.run([str(args.analysis_python), "-I", "-c", "import cv2; from prismmoves.controlled_response import analyse"], check=True)
129
+ library = load_library(args.catalogue.resolve())
130
+ if library.get("textures"):
131
+ parents = {str(Path(r["path"]).resolve().parent) for r in library["textures"]}
132
+ if len(parents) != 1:
133
+ raise ValueError("Preset textures must share their installed directory")
134
+ for ref in library["textures"]:
135
+ if digest(ref["path"]) != ref["sha256"]:
136
+ raise ValueError("Installed texture changed")
137
+ os.environ["FRAMERUDIMENTS_TEXTURES_DIR"] = next(iter(parents))
138
+ rows = [r for r in library["presets"] if (not args.ids or r["id"] in args.ids)
139
+ and (not args.engine or r["engine"] == args.engine)]
140
+ if args.ids and set(args.ids) - {r["id"] for r in rows}:
141
+ raise ValueError("Selected preset not found")
142
+ profiles = list(EXTENDED if args.extended else CORE)
143
+ if args.audio:
144
+ profiles.append("music")
145
+ roles = ["engine-only"] + (["neutral-a", "neutral-b"] if args.texture_controls else [])
146
+ count = len(profiles) * len(roles) * args.trials * (12 * args.capture_fps + 1)
147
+ if count > 32768:
148
+ raise ValueError("This protocol exceeds 32768 frames per preset; reduce capture fps or trials")
149
+ # New process code must not be mistaken for a cached prior experiment.
150
+ fingerprints = {name: digest(ROOT / name) for name in
151
+ ("scripts/controlled_preset_analysis.py", "src/framerudiments/audio_probes.py",
152
+ "src/framerudiments/controlled_profiling.py", "src/framerudiments/visualisers.py",
153
+ "src/framerudiments/projectm_backend.py", "src/framerudiments/visualiser_assets/butterchurn-page.js",
154
+ "src/framerudiments/visualiser_assets/butterchurn-worker.mjs")}
155
+ runtime = {key: digest(os.environ[key]) for key in
156
+ ("FRAMERUDIMENTS_PROJECTM_LIBRARY", "FRAMERUDIMENTS_BROWSER", "FRAMERUDIMENTS_NODE")
157
+ if os.environ.get(key) and Path(os.environ[key]).is_file()}
158
+ settings = dict(protocol=PROTOCOL, profiles=profiles, input_roles=roles, trials=args.trials,
159
+ render_fps=60, capture_fps=args.capture_fps, edge=args.edge, host_code=fingerprints,
160
+ runtime=runtime, catalogue_sha256=digest(args.catalogue),
161
+ audio_sha256=digest(args.audio) if args.audio else None, audio_start=args.audio_start)
162
+ work = out / "_work"
163
+ work.mkdir(parents=True, exist_ok=True)
164
+ config = out / "experiment.json"
165
+ if config.exists() and read(config) != settings:
166
+ raise ValueError("Capture configuration changed; retain these results and choose a new --output")
167
+ if not config.exists() and any(p.name not in {"_work", ".gitignore"} for p in out.iterdir()):
168
+ raise ValueError("Unrecognised output directory; do not overwrite other workflows")
169
+ write(config, settings)
170
+ (out / ".gitignore").write_text("_work/\n", encoding="utf-8")
171
+ with exclusive(work):
172
+ stimuli = {}
173
+ for trial in range(args.trials):
174
+ for profile in profiles:
175
+ stimuli[profile, trial] = (supplied_music(args.audio, args.audio_start, trial, work / "stimuli", args.ffmpeg)
176
+ if profile == "music" else make_probe(profile, trial, work / "stimuli"))
177
+ schedule = ordered_presets(rows, args.order_seed if args.order_seed is not None else time.time_ns())
178
+ write(work / "schedule.json", {"presets": [r["id"] for r in schedule]})
179
+ processed = 0
180
+ failures = 0
181
+ for row in schedule:
182
+ key = hashlib.sha256(row["id"].encode()).hexdigest()[:24]
183
+ folder = work / key
184
+ folder.mkdir(exist_ok=True)
185
+ manifest_path = folder / "captures.json"
186
+ # Finished transport is skippable, but failed analysis is not.
187
+ public = out / key / "response.json"
188
+ if public.is_file() and read(public).get("state") == "completed" and not args.reanalyse:
189
+ # Retained captures, not just a successful report flag, define a resume.
190
+ prior = read(manifest_path)
191
+ for condition in prior["conditions"]:
192
+ refs = [condition["source"], condition["stimulus"]]
193
+ refs.extend(frame["output"] for frame in condition["captures"])
194
+ if any(digest(ref["path"]) != ref["sha256"] for ref in refs):
195
+ raise ValueError("Saved capture/source/stimulus changed; use a new output directory")
196
+ continue
197
+ if args.limit and processed >= args.limit:
198
+ break
199
+ print(f"[{processed+1}] {row['engine']}: {row['name']} | {count} frames; zero neural calls", flush=True)
200
+ conditions = []
201
+ tasks = [(role, profile, trial) for role in roles for profile in profiles for trial in range(args.trials)]
202
+ random.Random(1451).shuffle(tasks)
203
+ for number, (role, profile, trial) in enumerate(tasks, 1):
204
+ cid = f"{role}__{profile}__{trial}"
205
+ destination = folder / cid
206
+ if args.retry_failed and (destination / "condition.json").exists() and read(destination / "condition.json").get("state") != "captured":
207
+ destination.rename(folder / f"{cid}-previous-{time.time_ns()}")
208
+ elif destination.exists() and not (destination / "condition.json").exists():
209
+ destination.rename(folder / f"{cid}-interrupted-{time.time_ns()}")
210
+ job = {"id": cid, "protocol": PROTOCOL, "input_role": role,
211
+ "input_mix": 0.0 if role == "engine-only" else .15,
212
+ "seed": 4051 + trial, "trial": trial, "preset": row,
213
+ "render_fps": 60, "capture_fps": args.capture_fps, "edge": args.edge,
214
+ "stimulus": stimuli[profile, trial], "output": str(destination)}
215
+ job_path = folder / "job.json"
216
+ write(job_path, job)
217
+ print(f" capture {number}/{len(tasks)} {cid}", flush=True)
218
+ code = run_stage([sys.executable, "-u", "-m", "framerudiments.controlled_profiling", "--job", str(job_path)],
219
+ folder / f"{cid}.log", args.timeout)
220
+ saved = read(destination / "condition.json") if (destination / "condition.json").is_file() else dict(job, captures=[])
221
+ if code:
222
+ saved["state"] = "failed"
223
+ saved["process_exit"] = code
224
+ conditions.append(saved)
225
+ write(manifest_path, {"protocol": PROTOCOL, "preset": row, "conditions": conditions,
226
+ "settings": settings, "expected_conditions": len(tasks)})
227
+ report_dir = out / key
228
+ print(" Measuring temporal evidence and repeated audio contrasts...", flush=True)
229
+ code = run_stage([str(args.analysis_python), "-I", "-u", "-m", "prismmoves.controlled_response", "analyse",
230
+ "--captures", str(manifest_path), "--out", str(report_dir)], folder / "analysis.log", args.timeout)
231
+ if code not in (0, 2):
232
+ raise ValueError(f"Analysis failed ({code}); see {folder / 'analysis.log'}")
233
+ if code == 2:
234
+ failures += 1
235
+ subprocess.run([str(args.analysis_python), "-I", "-m", "prismmoves.controlled_response", "index", "--out", str(out)], check=True)
236
+ processed += 1
237
+ print(f"Processed {processed} presets ({failures} partial). Open {out / 'index.html'}", flush=True)
238
+ return 2 if failures else 0
239
+
240
+
241
+ def main(argv=None):
242
+ parser = argparse.ArgumentParser(description=__doc__)
243
+ parser.add_argument("--analysis-python", type=Path, required=True)
244
+ parser.add_argument("--output", type=Path, default=ROOT / "visualiser-analysis" / "audio-response-catalogue")
245
+ parser.add_argument("--catalogue", type=Path, default=ROOT / "models" / "preset-library" / "catalogue.json")
246
+ parser.add_argument("--limit", type=int, default=2, help="0 processes the remaining catalogue")
247
+ parser.add_argument("--trials", type=int, choices=range(3, 7), default=3)
248
+ parser.add_argument("--capture-fps", type=int, choices=(5, 10, 15, 20, 30), default=15)
249
+ parser.add_argument("--edge", type=int, default=384)
250
+ parser.add_argument("--extended", action="store_true")
251
+ parser.add_argument("--texture-controls", action="store_true")
252
+ parser.add_argument("--audio", type=Path)
253
+ parser.add_argument("--audio-start", type=float, default=0)
254
+ parser.add_argument("--ffmpeg", default=os.environ.get("FRAMERUDIMENTS_FFMPEG") or shutil.which("ffmpeg"))
255
+ parser.add_argument("--engine", choices=("butterchurn", "projectm"))
256
+ parser.add_argument("--id", dest="ids", action="append", default=[])
257
+ parser.add_argument("--order-seed", type=int)
258
+ parser.add_argument("--retry-failed", action="store_true")
259
+ parser.add_argument("--reanalyse", action="store_true", help="Recompute reports while reusing verified captures")
260
+ parser.add_argument("--timeout", type=int, default=1800)
261
+ args = parser.parse_args(argv)
262
+ try:
263
+ if args.limit < 0 or not 64 <= args.edge <= 1024 or not 1 <= args.timeout <= 86400:
264
+ raise ValueError("Invalid limits")
265
+ if args.audio and not args.ffmpeg:
266
+ raise ValueError("FFmpeg is required for supplied music")
267
+ return run(args)
268
+ except (ValueError, OSError, subprocess.SubprocessError) as exc:
269
+ print(f"Controlled analysis stopped: {exc}", file=sys.stderr)
270
+ return 1
271
+
272
+
273
+ if __name__ == "__main__":
274
+ raise SystemExit(main())
@@ -1,6 +1,6 @@
1
1
  """Offline frame composition on a traceable musical clock."""
2
2
 
3
- __version__ = "0.4.0"
3
+ __version__ = "0.4.1"
4
4
 
5
5
  from .project import Project
6
6
  from .render import render, preflight