framerudiments 0.4.5__tar.gz → 0.4.7__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 (263) hide show
  1. {framerudiments-0.4.5/src/framerudiments.egg-info → framerudiments-0.4.7}/PKG-INFO +33 -1
  2. {framerudiments-0.4.5 → framerudiments-0.4.7}/README.md +32 -0
  3. {framerudiments-0.4.5 → framerudiments-0.4.7}/RELEASE_NOTES.md +52 -0
  4. framerudiments-0.4.7/docs/bounded-preflight.md +45 -0
  5. framerudiments-0.4.7/docs/media/bounded-preflight.svg +19 -0
  6. framerudiments-0.4.7/docs/media/palette-grade-comparison.png +0 -0
  7. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/project-format.md +1 -1
  8. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/visualisers.md +35 -0
  9. {framerudiments-0.4.5 → framerudiments-0.4.7}/pyproject.toml +1 -1
  10. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/__init__.py +1 -1
  11. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/cli.py +12 -2
  12. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/encoding.py +15 -1
  13. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/render.py +39 -5
  14. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/visualiser_assets/butterchurn-page.js +3 -2
  15. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/visualisers.py +82 -3
  16. {framerudiments-0.4.5 → framerudiments-0.4.7/src/framerudiments.egg-info}/PKG-INFO +33 -1
  17. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments.egg-info/SOURCES.txt +4 -0
  18. framerudiments-0.4.7/tests/test_encoding.py +33 -0
  19. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_pipeline.py +49 -0
  20. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_rich_subtitles.py +2 -1
  21. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_visualiser_routing.py +53 -0
  22. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_visualisers.py +37 -2
  23. {framerudiments-0.4.5 → framerudiments-0.4.7}/AGENTS.md +0 -0
  24. {framerudiments-0.4.5 → framerudiments-0.4.7}/LICENSE +0 -0
  25. {framerudiments-0.4.5 → framerudiments-0.4.7}/MANIFEST.in +0 -0
  26. {framerudiments-0.4.5 → framerudiments-0.4.7}/analysis-releases.json +0 -0
  27. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/ECOSYSTEM.md +0 -0
  28. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/FrameRudiments-PATCH_WORKFLOW.md +0 -0
  29. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/annular-modulation.md +0 -0
  30. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/authoring-workspace.md +0 -0
  31. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/beat-alignment.md +0 -0
  32. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/controlled-audio-response.md +0 -0
  33. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/expanded-effects.md +0 -0
  34. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/extraction.md +0 -0
  35. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/full-preset-analysis.md +0 -0
  36. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/hybrid-preset-analysis.md +0 -0
  37. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/keyframed-mattes.md +0 -0
  38. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/media/beat-alignment-evidence.json +0 -0
  39. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/media/beat-alignment.mp4 +0 -0
  40. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/media/beat-alignment.png +0 -0
  41. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/media/demo-transcript.md +0 -0
  42. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/media/effects-pipeline.svg +0 -0
  43. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/media/full-frame-comparison.png +0 -0
  44. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/media/full-frame-demo.mp4 +0 -0
  45. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/media/media-evidence.json +0 -0
  46. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/media/natural-materials.mp4 +0 -0
  47. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/media/natural-materials.png +0 -0
  48. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/media/preset-test-cards.png +0 -0
  49. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/media/rangoli-transcript.md +0 -0
  50. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/media/rangoli.mp4 +0 -0
  51. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/media/rangoli.png +0 -0
  52. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/media/test-card-inputs/colour-bars.png +0 -0
  53. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/media/test-card-inputs/grid-rings.png +0 -0
  54. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/media/test-card-inputs/text-card.png +0 -0
  55. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/multi-stem-modulation.md +0 -0
  56. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/music-reactive-3d.md +0 -0
  57. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/natural-materials.md +0 -0
  58. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/particle-smoke.md +0 -0
  59. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/phase3-compositing.md +0 -0
  60. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/preset-behaviour.md +0 -0
  61. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/preset-profiling.md +0 -0
  62. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/projectm-local-runtime.md +0 -0
  63. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/quality-effects.md +0 -0
  64. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/rangoli.md +0 -0
  65. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/rich-lyric-effects.md +0 -0
  66. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/rudiment-renderers.md +0 -0
  67. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/scoped-post-effects.md +0 -0
  68. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/solid-spatial-renderers.md +0 -0
  69. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/spatial-renderers.md +0 -0
  70. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/spatiotemporal-supersampling.md +0 -0
  71. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/spectrum.md +0 -0
  72. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/sprite-visualisations.md +0 -0
  73. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/stem-sources-and-masks.md +0 -0
  74. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/variable-bpm-word-subtitles.md +0 -0
  75. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/visualisation-atlas.md +0 -0
  76. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/visualisation-coverage-matrix.md +0 -0
  77. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/visualiser-routing.md +0 -0
  78. {framerudiments-0.4.5 → framerudiments-0.4.7}/docs/workflow-media.md +0 -0
  79. {framerudiments-0.4.5 → framerudiments-0.4.7}/integration/test_fire_volume_gpu.py +0 -0
  80. {framerudiments-0.4.5 → framerudiments-0.4.7}/integration/test_music_spatial_gpu.py +0 -0
  81. {framerudiments-0.4.5 → framerudiments-0.4.7}/integration/test_preset_analysis.py +0 -0
  82. {framerudiments-0.4.5 → framerudiments-0.4.7}/integration/test_released_preset_analysis.py +0 -0
  83. {framerudiments-0.4.5 → framerudiments-0.4.7}/integration/test_visualisers_gpu.py +0 -0
  84. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/Run-ControlledPresetAnalysis.ps1 +0 -0
  85. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/Run-FullPresetAnalysis.ps1 +0 -0
  86. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/Run-HybridPresetAnalysis.ps1 +0 -0
  87. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/Run-PresetBehaviourAnalysis.ps1 +0 -0
  88. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/authoring_preview.py +0 -0
  89. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/bake_mantaflow_fire.py +0 -0
  90. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/build_sprite_assets.py +0 -0
  91. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/check_projectm_runtime.py +0 -0
  92. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/check_release_packages.py +0 -0
  93. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/controlled_preset_analysis.py +0 -0
  94. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/ensure_projectm_runtime.py +0 -0
  95. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/full_preset_analysis.py +0 -0
  96. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/generate_particle_gallery.py +0 -0
  97. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/generate_post_effect_gallery.py +0 -0
  98. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/generate_quality_gallery.py +0 -0
  99. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/generate_rich_lyric_gallery.py +0 -0
  100. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/generate_sprite_gallery.py +0 -0
  101. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/generate_supersampling_gallery.py +0 -0
  102. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/generate_timing_gallery.py +0 -0
  103. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/generate_visualisation_gallery.py +0 -0
  104. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/generate_visualiser_routing_gallery.py +0 -0
  105. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/install_analysis_releases.py +0 -0
  106. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/prepare_fire_atlas.py +0 -0
  107. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/prepare_pixelcue_taggers.py +0 -0
  108. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/preset_behaviour_pipeline.py +0 -0
  109. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/profile_visualisation_coverage.py +0 -0
  110. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/profile_visualisers.py +0 -0
  111. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/projectm_dll_diagnostics.py +0 -0
  112. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/render_natural_material_demo.py +0 -0
  113. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/repair_projectm_mingw.py +0 -0
  114. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/select_projectm_generator.py +0 -0
  115. {framerudiments-0.4.5 → framerudiments-0.4.7}/scripts/validate_patch.py +0 -0
  116. {framerudiments-0.4.5 → framerudiments-0.4.7}/setup.cfg +0 -0
  117. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/__main__.py +0 -0
  118. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/advanced_renderers.py +0 -0
  119. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/atlas.py +0 -0
  120. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/audio_probes.py +0 -0
  121. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/beat_alignment.py +0 -0
  122. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/beat_timeline.py +0 -0
  123. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/choreography.py +0 -0
  124. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/circular_renderers.py +0 -0
  125. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/compositor.py +0 -0
  126. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/controlled_profiling.py +0 -0
  127. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/demo.py +0 -0
  128. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/effect_catalogue.py +0 -0
  129. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/effect_renderers.py +0 -0
  130. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/effects.py +0 -0
  131. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/fire_assets/mantaflow/NOTICE.md +0 -0
  132. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/fire_assets/mantaflow/atlas.json +0 -0
  133. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/fire_assets/mantaflow/flames.png +0 -0
  134. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/fire_assets/marburg/NOTICE.md +0 -0
  135. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/fire_assets/marburg/atlas.json +0 -0
  136. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/fire_assets/marburg/flames.png +0 -0
  137. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/fire_assets.py +0 -0
  138. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/fire_fluid.py +0 -0
  139. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/fire_renderer.py +0 -0
  140. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/fire_volume.py +0 -0
  141. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/flight.py +0 -0
  142. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/gpu_spatial_backend.py +0 -0
  143. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/io.py +0 -0
  144. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/keyframes.py +0 -0
  145. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/layer_animation.py +0 -0
  146. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/layer_displacement.py +0 -0
  147. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/layer_masks.py +0 -0
  148. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/lyric_indicator.py +0 -0
  149. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/modulation.py +0 -0
  150. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/motion.py +0 -0
  151. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/music_spatial_renderers.py +0 -0
  152. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/natural_materials.py +0 -0
  153. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/output_quality.py +0 -0
  154. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/particle_engine.py +0 -0
  155. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/post_effects.py +0 -0
  156. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/preset_library.py +0 -0
  157. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/preset_profiling.py +0 -0
  158. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/profile_analysis.py +0 -0
  159. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/project.py +0 -0
  160. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/projectm_backend.py +0 -0
  161. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/quality_effects.py +0 -0
  162. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/rangoli_renderer.py +0 -0
  163. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/rich_subtitles.py +0 -0
  164. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/rudiment_renderers.py +0 -0
  165. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/scoped_effects.py +0 -0
  166. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/solid_spatial_renderers.py +0 -0
  167. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/spatial_renderers.py +0 -0
  168. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/spectrum.py +0 -0
  169. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/sprite_assets/arcade.png +0 -0
  170. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/sprite_assets/crystal.png +0 -0
  171. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/sprite_assets/fire.png +0 -0
  172. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/sprite_assets/generated-neon.png +0 -0
  173. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/sprite_assets/glass.png +0 -0
  174. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/sprite_assets/hud.png +0 -0
  175. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/sprite_assets/ice.png +0 -0
  176. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/sprite_assets/lcd-amber.png +0 -0
  177. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/sprite_assets/lcd-green.png +0 -0
  178. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/sprite_assets/lcd.png +0 -0
  179. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/sprite_assets/led.png +0 -0
  180. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/sprite_assets/manifest.json +0 -0
  181. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/sprite_assets/metal.png +0 -0
  182. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/sprite_assets/mono.png +0 -0
  183. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/sprite_assets/neon.png +0 -0
  184. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/sprite_assets/pixel.png +0 -0
  185. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/sprite_assets/plasma.png +0 -0
  186. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/sprite_assets/vfd.png +0 -0
  187. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/sprite_catalogue.py +0 -0
  188. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/sprite_renderers.py +0 -0
  189. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/stem_blend.py +0 -0
  190. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/stemlab.py +0 -0
  191. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/subtitles.py +0 -0
  192. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/super_sampling.py +0 -0
  193. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/terrain_field.py +0 -0
  194. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/timeline.py +0 -0
  195. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/visual_style.py +0 -0
  196. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/visualisation_catalogue.py +0 -0
  197. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/visualiser_assets/butterchurn-worker.mjs +0 -0
  198. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/visualiser_assets/feedback.json +0 -0
  199. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/visualiser_assets/feedback.milk +0 -0
  200. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/visualiser_assets/julia.json +0 -0
  201. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/visualiser_assets/julia.milk +0 -0
  202. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/visualiser_assets/kaleidoscope.json +0 -0
  203. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/visualiser_assets/kaleidoscope.milk +0 -0
  204. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/visualiser_assets/package-lock.json +0 -0
  205. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/visualiser_assets/package.json +0 -0
  206. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/visualiser_assets/rangoli-background.milk +0 -0
  207. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/visualiser_routing.py +0 -0
  208. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/visualiser_setup.py +0 -0
  209. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments/word_timing.py +0 -0
  210. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments.egg-info/dependency_links.txt +0 -0
  211. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments.egg-info/entry_points.txt +0 -0
  212. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments.egg-info/requires.txt +0 -0
  213. {framerudiments-0.4.5 → framerudiments-0.4.7}/src/framerudiments.egg-info/top_level.txt +0 -0
  214. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/conftest.py +0 -0
  215. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_adapters.py +0 -0
  216. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_advanced_renderers.py +0 -0
  217. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_authoring_preview.py +0 -0
  218. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_beat_alignment.py +0 -0
  219. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_behaviour_pipeline.py +0 -0
  220. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_checkpoint_batches.py +0 -0
  221. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_controlled_audio.py +0 -0
  222. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_coverage_matrix.py +0 -0
  223. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_default_antialias.py +0 -0
  224. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_effect_batch.py +0 -0
  225. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_extracted_helpers.py +0 -0
  226. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_fire_methods.py +0 -0
  227. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_flight.py +0 -0
  228. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_full_preset_analysis.py +0 -0
  229. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_gpu_ci_isolation.py +0 -0
  230. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_hybrid_launcher.py +0 -0
  231. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_keyframes.py +0 -0
  232. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_layer_masks.py +0 -0
  233. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_lyrics.py +0 -0
  234. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_music_spatial_pipeline.py +0 -0
  235. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_music_spatial_renderers.py +0 -0
  236. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_natural_materials.py +0 -0
  237. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_particle_engine.py +0 -0
  238. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_patch_validation.py +0 -0
  239. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_phase3_animation.py +0 -0
  240. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_phase3_gpu_injection.py +0 -0
  241. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_preset_profiling.py +0 -0
  242. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_projectm_dll_diagnostics.py +0 -0
  243. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_projectm_generator.py +0 -0
  244. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_projectm_runtime_preflight.py +0 -0
  245. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_pytest_temp_isolation.py +0 -0
  246. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_quality_effects.py +0 -0
  247. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_rangoli_renderer.py +0 -0
  248. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_release_metadata.py +0 -0
  249. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_repair_projectm_mingw.py +0 -0
  250. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_rudiment_renderers.py +0 -0
  251. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_scoped_effects.py +0 -0
  252. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_solid_spatial_integration.py +0 -0
  253. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_solid_spatial_renderers.py +0 -0
  254. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_spatial_renderers.py +0 -0
  255. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_spectrum.py +0 -0
  256. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_sprite_renderers.py +0 -0
  257. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_stem_blend.py +0 -0
  258. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_stem_source_integration.py +0 -0
  259. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_supersampling.py +0 -0
  260. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_timeline.py +0 -0
  261. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_variable_bpm_words.py +0 -0
  262. {framerudiments-0.4.5 → framerudiments-0.4.7}/tests/test_visualisation_modulation.py +0 -0
  263. {framerudiments-0.4.5 → framerudiments-0.4.7}/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.5
3
+ Version: 0.4.7
4
4
  Summary: Deterministic Shorts and lyric visualisers using DanceRudiments and StemLab evidence.
5
5
  Author: Kieran Simkin
6
6
  License-Expression: MIT
@@ -31,6 +31,31 @@ Dynamic: license-file
31
31
 
32
32
  # FrameRudiments
33
33
 
34
+ ## Complete x264 preset range
35
+
36
+ Version 0.4.6 accepts every named libx264 preset from `ultrafast` through
37
+ `placebo`, including the previously rejected `slower` and `veryslow` delivery
38
+ profiles. The selected preset and CRF remain explicit render arguments and are
39
+ retained in the encode command and manifest evidence. A stronger preset can
40
+ improve compression efficiency; it does not raise project resolution, mesh
41
+ density, frame rate or source sampling on its own.
42
+
43
+ The existing encoded demonstrations below remain representative because this
44
+ change alters compression controls rather than composition or motion. No new
45
+ image or video was generated solely to illustrate byte-level encoder effort.
46
+
47
+ ## Palette-controlled high-detail feedback
48
+
49
+ Version 0.4.4 adds optional Butterchurn mesh dimensions and a deterministic
50
+ multi-stop palette grade after each full-frame visualiser stage. This lets a
51
+ 1080p visualiser retain more spatial detail and conform feedback colours to a
52
+ campaign palette while clean routed overlays keep their authored appearance.
53
+ See [full-frame visualisers](docs/visualisers.md).
54
+
55
+ ![Generated test illustration comparing ungraded and palette-graded output](docs/media/palette-grade-comparison.png)
56
+
57
+ Generated test illustration; no private campaign media is included.
58
+
34
59
  ## Five fire methods and ice
35
60
 
36
61
  Version 0.4.3 adds evidence-recorded three-stop fire palettes, an optional
@@ -96,6 +121,7 @@ framerudiments --version
96
121
  framerudiments demo demo --font /path/to/a/font.ttf
97
122
  framerudiments plan demo/project.json --output demo-plan.json
98
123
  framerudiments preflight demo/project.json --output preflight --ffmpeg /path/to/ffmpeg
124
+ framerudiments preflight demo/project.json --output bounded-preflight --max-frames 3 --ffmpeg /path/to/ffmpeg
99
125
  framerudiments render demo/project.json --output render --ffmpeg /path/to/ffmpeg
100
126
  ```
101
127
 
@@ -105,6 +131,12 @@ ffprobe. Environment alternatives are `FRAMERUDIMENTS_FFMPEG` and
105
131
  font or FFmpeg location is hardcoded into the engine. The synthetic demo creates
106
132
  its own tone, sprite, LRC, CUE and four-dimensional recording.
107
133
 
134
+ For expensive long projects, `preflight --max-frames N` validates a bounded
135
+ sequential prefix and records the exact incomplete scope in `manifest.json`.
136
+ This preserves stateful particles and feedback inside the prefix without paying
137
+ for a complete unencoded pass before the complete encoded render. It never
138
+ claims later frames were checked. See [bounded preflight](docs/bounded-preflight.md).
139
+
108
140
  ## Capabilities
109
141
 
110
142
  * Portrait, landscape and square frame-addressed Pillow composition, at native
@@ -1,5 +1,30 @@
1
1
  # FrameRudiments
2
2
 
3
+ ## Complete x264 preset range
4
+
5
+ Version 0.4.6 accepts every named libx264 preset from `ultrafast` through
6
+ `placebo`, including the previously rejected `slower` and `veryslow` delivery
7
+ profiles. The selected preset and CRF remain explicit render arguments and are
8
+ retained in the encode command and manifest evidence. A stronger preset can
9
+ improve compression efficiency; it does not raise project resolution, mesh
10
+ density, frame rate or source sampling on its own.
11
+
12
+ The existing encoded demonstrations below remain representative because this
13
+ change alters compression controls rather than composition or motion. No new
14
+ image or video was generated solely to illustrate byte-level encoder effort.
15
+
16
+ ## Palette-controlled high-detail feedback
17
+
18
+ Version 0.4.4 adds optional Butterchurn mesh dimensions and a deterministic
19
+ multi-stop palette grade after each full-frame visualiser stage. This lets a
20
+ 1080p visualiser retain more spatial detail and conform feedback colours to a
21
+ campaign palette while clean routed overlays keep their authored appearance.
22
+ See [full-frame visualisers](docs/visualisers.md).
23
+
24
+ ![Generated test illustration comparing ungraded and palette-graded output](docs/media/palette-grade-comparison.png)
25
+
26
+ Generated test illustration; no private campaign media is included.
27
+
3
28
  ## Five fire methods and ice
4
29
 
5
30
  Version 0.4.3 adds evidence-recorded three-stop fire palettes, an optional
@@ -65,6 +90,7 @@ framerudiments --version
65
90
  framerudiments demo demo --font /path/to/a/font.ttf
66
91
  framerudiments plan demo/project.json --output demo-plan.json
67
92
  framerudiments preflight demo/project.json --output preflight --ffmpeg /path/to/ffmpeg
93
+ framerudiments preflight demo/project.json --output bounded-preflight --max-frames 3 --ffmpeg /path/to/ffmpeg
68
94
  framerudiments render demo/project.json --output render --ffmpeg /path/to/ffmpeg
69
95
  ```
70
96
 
@@ -74,6 +100,12 @@ ffprobe. Environment alternatives are `FRAMERUDIMENTS_FFMPEG` and
74
100
  font or FFmpeg location is hardcoded into the engine. The synthetic demo creates
75
101
  its own tone, sprite, LRC, CUE and four-dimensional recording.
76
102
 
103
+ For expensive long projects, `preflight --max-frames N` validates a bounded
104
+ sequential prefix and records the exact incomplete scope in `manifest.json`.
105
+ This preserves stateful particles and feedback inside the prefix without paying
106
+ for a complete unencoded pass before the complete encoded render. It never
107
+ claims later frames were checked. See [bounded preflight](docs/bounded-preflight.md).
108
+
77
109
  ## Capabilities
78
110
 
79
111
  * Portrait, landscape and square frame-addressed Pillow composition, at native
@@ -1,3 +1,37 @@
1
+ # FrameRudiments 0.4.7
2
+
3
+ - `preflight --max-frames N` composes a declared sequential prefix for expensive
4
+ long projects instead of forcing a complete unencoded pass before rendering.
5
+ - The manifest records full versus bounded scope, frames rendered, total frames,
6
+ sequential-state behaviour and the explicit later-frame validation limit.
7
+ - The final rendered file still receives complete decode, CFR, frame-count,
8
+ audio and encoded-checkpoint verification; bounded preflight does not weaken
9
+ or relabel final technical QA.
10
+ - Focused regression coverage preserves default full-preflight behaviour, exact
11
+ prefix boundaries, final-prefix QA capture and fail-closed limits.
12
+ - Wrapped-word layout coverage now follows visual reading order across current
13
+ Pillow text metrics instead of assuming every word remains on one row.
14
+
15
+ ![Generated workload illustration for bounded preflight](docs/media/bounded-preflight.svg)
16
+
17
+ Generated explanatory diagram; not a benchmark or rendered campaign frame.
18
+
19
+ # FrameRudiments 0.4.6
20
+
21
+ - Encoding now accepts the complete named libx264 preset range: `ultrafast`,
22
+ `superfast`, `veryfast`, `faster`, `fast`, `medium`, `slow`, `slower`,
23
+ `veryslow` and `placebo`.
24
+ - Focused regression coverage verifies every accepted preset reaches the exact
25
+ FFmpeg command and that unknown values still fail closed.
26
+ - Linux CI, gallery and release jobs now pin Ubuntu 24.04 so runner-image
27
+ migrations cannot silently change the release environment mid-validation.
28
+ - Linux render dependencies use one shared installer with bounded timeouts and
29
+ retries, preventing a stalled package mirror from hanging a release forever.
30
+ - Preset strength remains separate from composition resolution, visualiser
31
+ mesh density, frame rate and source sampling. Existing public demonstration
32
+ media therefore remains applicable; no new visual was generated for this
33
+ command-validation-only change.
34
+
1
35
  # FrameRudiments 0.4.5
2
36
 
3
37
  - Word indicators can now travel between encoded word hits with a configurable
@@ -14,6 +48,24 @@
14
48
  evidence behaviour. Private campaign artwork and audio remain outside the
15
49
  distribution.
16
50
 
51
+ ## High-detail, palette-controlled visualiser output
52
+
53
+ - Butterchurn stages accept bounded `mesh_width` and `mesh_height` values. The
54
+ existing 64×48 mesh remains the default; projects can request additional
55
+ spatial detail without changing their encoded dimensions or frame rate.
56
+ - Any Butterchurn or projectM stage can apply `output_palette_grade` after the
57
+ engine output and before the next stage or clean routing overlay. Two to
58
+ sixteen ordered CSS colours define a deterministic luminance palette; alpha,
59
+ PCM, feedback state and the source clock remain unchanged.
60
+ - The exact mesh and grade configuration is retained in plan and manifest
61
+ evidence. Focused validation covers schema bounds, deterministic pixels,
62
+ alpha preservation, stage order and routed overlays.
63
+
64
+ ![Generated comparison of ungraded and palette-graded synthetic output](docs/media/palette-grade-comparison.png)
65
+
66
+ Generated test illustration; no private campaign media. A video is omitted
67
+ because this stateless grade adds no temporal behaviour to demonstrate.
68
+
17
69
  # FrameRudiments 0.4.4
18
70
 
19
71
  - 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.
@@ -0,0 +1,45 @@
1
+ # Bounded sequential preflight
2
+
3
+ `framerudiments preflight` remains a full, unencoded composition pass by
4
+ default. For a long or unusually expensive project, `--max-frames N` composes
5
+ only the first `N` frames in order:
6
+
7
+ ```sh
8
+ framerudiments preflight project.json --output preflight-prefix --max-frames 3
9
+ ```
10
+
11
+ The mode is a cost and failure-surface check. It verifies pinned inputs,
12
+ audio identity, project construction, sequential state creation, the declared
13
+ prefix and cleanup. It saves frame zero, ordinary checkpoints encountered in
14
+ the prefix and the last rendered prefix frame. `manifest.json` records:
15
+
16
+ ```json
17
+ {
18
+ "preflight_scope": {
19
+ "mode": "bounded-prefix",
20
+ "frames_rendered": 3,
21
+ "total_frames": 15850,
22
+ "complete": false,
23
+ "sequential": true,
24
+ "note": "Only the declared sequential prefix was composed; later frames remain unvalidated."
25
+ }
26
+ }
27
+ ```
28
+
29
+ ## Why the prefix is sequential
30
+
31
+ Feedback visualisers, emitters and historical effects can depend on every
32
+ preceding frame. Randomly drawing distant checkpoints would reset or omit that
33
+ history and could create misleading evidence. The bounded mode therefore starts
34
+ at frame zero and advances normally. It does not describe later checkpoints,
35
+ the ending, full cleanup behaviour or the encoded result.
36
+
37
+ Run the complete `render` afterward. The renderer still composes every frame,
38
+ encodes the soundtrack, extracts all encoded QA checkpoints and verifies full
39
+ decode, constant frame rate, exact frame count, timestamps, dimensions, audio
40
+ shape and duration. Creative review and attended listening remain separate.
41
+
42
+ ![Generated comparison of full and bounded preflight workloads](media/bounded-preflight.svg)
43
+
44
+ Generated explanatory diagram. The short amber prefix represents frames that
45
+ were actually composed; the outlined remainder is explicitly unvalidated.
@@ -0,0 +1,19 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" width="960" height="360" viewBox="0 0 960 360" role="img" aria-labelledby="title desc">
2
+ <title id="title">Full preflight compared with bounded sequential preflight</title>
3
+ <desc id="desc">A full preflight composes every frame before rendering. A bounded preflight composes a short sequential prefix and labels the remainder unvalidated.</desc>
4
+ <rect width="960" height="360" fill="#16051f"/>
5
+ <text x="48" y="55" fill="#fff2cf" font-family="sans-serif" font-size="28" font-weight="700">Generated workflow illustration</text>
6
+ <text x="48" y="105" fill="#fff2cf" font-family="sans-serif" font-size="22">Full preflight</text>
7
+ <rect x="250" y="78" width="650" height="38" rx="19" fill="#ffb52e"/>
8
+ <text x="575" y="104" fill="#351300" text-anchor="middle" font-family="sans-serif" font-size="17" font-weight="700">every frame composed without encoding</text>
9
+ <path d="M575 126v45" stroke="#ffcf62" stroke-width="4" marker-end="url(#arrow)"/>
10
+ <text x="48" y="201" fill="#fff2cf" font-family="sans-serif" font-size="22">Complete render</text>
11
+ <rect x="250" y="174" width="650" height="38" rx="19" fill="#ff7a28"/>
12
+ <text x="575" y="200" fill="#351300" text-anchor="middle" font-family="sans-serif" font-size="17" font-weight="700">every frame composed again and encoded</text>
13
+ <text x="48" y="279" fill="#fff2cf" font-family="sans-serif" font-size="22">Bounded preflight</text>
14
+ <rect x="250" y="252" width="92" height="38" rx="19" fill="#ffb52e"/>
15
+ <rect x="342" y="252" width="558" height="38" rx="19" fill="none" stroke="#9c759f" stroke-width="3" stroke-dasharray="10 10"/>
16
+ <text x="296" y="278" fill="#351300" text-anchor="middle" font-family="sans-serif" font-size="16" font-weight="700">prefix</text>
17
+ <text x="621" y="278" fill="#d8b9dc" text-anchor="middle" font-family="sans-serif" font-size="17">later frames explicitly unvalidated</text>
18
+ <defs><marker id="arrow" markerWidth="10" markerHeight="10" refX="8" refY="3" orient="auto"><path d="M0,0 L0,6 L9,3 z" fill="#ffcf62"/></marker></defs>
19
+ </svg>
@@ -23,7 +23,7 @@ the inputs are checked again before and after a render.
23
23
  | `layers` | Ordered sprite, legacy bar and modular rudiment layers described below. |
24
24
  | Native radial petals | Use `type: "rudiment", renderer: "rangoli"` with independent scale/spin/lift axes; see [rangoli configuration and actual demo](rangoli.md). |
25
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). |
26
- | `effects[].preset_timeline` | Optional ordered projectM preset changes at canonical source seconds, using the native soft transition and retaining one feedback instance. |
26
+ | `effects` | Ordered Butterchurn/projectM stages. Butterchurn may set a denser `mesh_width`/`mesh_height`; any stage may set a multi-stop `output_palette_grade` applied before the next stage or clean routing overlay. projectM stages may use `preset_timeline` for ordered changes at canonical source seconds through the native soft transition on one retained feedback instance. See [visualisers](visualisers.md). |
27
27
  | `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. |
28
28
  | `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. |
29
29
 
@@ -22,6 +22,41 @@ Original paired presets are `feedback` (audio-reactive swirl/echo),
22
22
  distortion of the frame's texture coordinates). They are examples, not a claim
23
23
  that two independent MilkDrop implementations produce identical pixels.
24
24
 
25
+ Butterchurn stages may set `mesh_width` (16–256) and `mesh_height` (12–256).
26
+ The default remains 64×48 for pixel compatibility. A denser mesh such as
27
+ 128×72 gives the warp field more spatial detail at 1920×1080, but it does not
28
+ change the encoded dimensions or frame rate and can increase GPU cost.
29
+
30
+ Each stage may also apply a deterministic multi-stop `output_palette_grade`
31
+ after its visualiser output and before the next stage or the clean routing
32
+ overlay:
33
+
34
+ ```json
35
+ {
36
+ "id": "clay-feedback",
37
+ "engine": "butterchurn",
38
+ "preset": "feedback",
39
+ "mesh_width": 128,
40
+ "mesh_height": 72,
41
+ "output_palette_grade": {
42
+ "stops": ["#100b19", "#171b37", "#572417", "#8a3c25", "#c49986"],
43
+ "amount": 0.85
44
+ }
45
+ }
46
+ ```
47
+
48
+ The grade maps output luminance through 2–16 ordered CSS colours in
49
+ sRGB, blends that result with the original by `amount` (0–1), and preserves
50
+ alpha. It does not change PCM, motion, feedback state or the source clock.
51
+ When `visualiser_routing` keeps lyrics or sprites as a clean overlay, that
52
+ overlay is composited after the grade and retains its authored colours.
53
+
54
+ ![Generated test illustration comparing ungraded and multi-stop graded output](media/palette-grade-comparison.png)
55
+
56
+ Generated test illustration; it demonstrates the colour transform rather than
57
+ evidence from a private campaign. A video is omitted because the grade is a
58
+ stateless per-frame colour operation with no temporal behaviour.
59
+
25
60
  ## Per-element feed and clean overlay routing
26
61
 
27
62
  FrameRudiments supports an optional project-level `visualiser_routing` object.
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "framerudiments"
7
- version = "0.4.5"
7
+ version = "0.4.7"
8
8
  description = "Deterministic Shorts and lyric visualisers using DanceRudiments and StemLab evidence."
9
9
  requires-python = ">=3.11"
10
10
  readme = "README.md"
@@ -1,6 +1,6 @@
1
1
  """Offline frame composition on a traceable musical clock."""
2
2
 
3
- __version__ = "0.4.5"
3
+ __version__ = "0.4.7"
4
4
 
5
5
  from .project import Project
6
6
  from .render import render, preflight
@@ -76,7 +76,13 @@ def main(argv=None):
76
76
  item.add_argument("--output", required=True, help="A new evidence/output directory; never overwrites")
77
77
  item.add_argument("--ffmpeg")
78
78
  item.add_argument("--ffprobe")
79
- if name == "render":
79
+ if name == "preflight":
80
+ item.add_argument(
81
+ "--max-frames",
82
+ type=int,
83
+ help="Compose only this many initial sequential frames; later frames remain unvalidated",
84
+ )
85
+ else:
80
86
  item.add_argument("--preset", default="fast")
81
87
  item.add_argument("--crf", type=int, default=20)
82
88
  args = parser.parse_args(argv)
@@ -161,7 +167,11 @@ def main(argv=None):
161
167
  print(output)
162
168
  else:
163
169
  runner = preflight if args.command == "preflight" else render
164
- extra = {"preset": args.preset, "crf": args.crf} if args.command == "render" else {}
170
+ extra = (
171
+ {"preset": args.preset, "crf": args.crf}
172
+ if args.command == "render"
173
+ else {"max_frames": args.max_frames}
174
+ )
165
175
  result = runner(args.project, args.output, ffmpeg=args.ffmpeg, ffprobe=args.ffprobe, **extra)
166
176
  print(json.dumps({"state": result["state"], "frames": result["frames"], "output": args.output}))
167
177
  return 0
@@ -8,6 +8,20 @@ import shutil
8
8
  import subprocess
9
9
 
10
10
 
11
+ X264_PRESETS = (
12
+ "ultrafast",
13
+ "superfast",
14
+ "veryfast",
15
+ "faster",
16
+ "fast",
17
+ "medium",
18
+ "slow",
19
+ "slower",
20
+ "veryslow",
21
+ "placebo",
22
+ )
23
+
24
+
11
25
  def binaries(ffmpeg=None, ffprobe=None):
12
26
  ffmpeg = ffmpeg or os.environ.get("FRAMERUDIMENTS_FFMPEG") or shutil.which("ffmpeg")
13
27
  if not ffmpeg:
@@ -56,7 +70,7 @@ def audio_filters(project):
56
70
 
57
71
 
58
72
  def command(project, output, ffmpeg, *, preset="fast", crf=20):
59
- if preset not in {"ultrafast", "superfast", "veryfast", "faster", "fast", "medium", "slow"}:
73
+ if preset not in X264_PRESETS:
60
74
  raise ValueError("Unsupported encoder preset")
61
75
  if not isinstance(crf, int) or not 0 <= crf <= 51:
62
76
  raise ValueError("CRF must be an integer in [0,51]")
@@ -107,9 +107,38 @@ def _prepare(project, output, ffmpeg, ffprobe, scene, renderers):
107
107
  return project, output, ffmpeg, ffprobe, compositor
108
108
 
109
109
 
110
- def preflight(project, output, *, ffmpeg=None, ffprobe=None, scene=None, renderers=None):
111
- p, out, ffmpeg, ffprobe, compositor = _prepare(project, output, ffmpeg, ffprobe, scene, renderers)
112
- selected = set(checkpoints(p))
110
+ def preflight(
111
+ project,
112
+ output,
113
+ *,
114
+ ffmpeg=None,
115
+ ffprobe=None,
116
+ scene=None,
117
+ renderers=None,
118
+ max_frames=None,
119
+ ):
120
+ p = Project.load(project) if not isinstance(project, Project) else project
121
+ if max_frames is None:
122
+ frame_count = p.frame_count
123
+ elif type(max_frames) is not int or not 1 <= max_frames <= p.frame_count:
124
+ raise ValueError(f"Preflight max_frames must be an integer in [1,{p.frame_count}]")
125
+ else:
126
+ frame_count = max_frames
127
+ p, out, ffmpeg, ffprobe, compositor = _prepare(p, output, ffmpeg, ffprobe, scene, renderers)
128
+ selected = {frame for frame in checkpoints(p) if frame < frame_count}
129
+ selected.add(frame_count - 1)
130
+ scope = dict(
131
+ mode="full" if frame_count == p.frame_count else "bounded-prefix",
132
+ frames_rendered=frame_count,
133
+ total_frames=p.frame_count,
134
+ complete=frame_count == p.frame_count,
135
+ sequential=True,
136
+ note=(
137
+ "All project frames were composed."
138
+ if frame_count == p.frame_count
139
+ else "Only the declared sequential prefix was composed; later frames remain unvalidated."
140
+ ),
141
+ )
113
142
  effects = None
114
143
  try:
115
144
  effects = (
@@ -118,7 +147,7 @@ def preflight(project, output, *, ffmpeg=None, ffprobe=None, scene=None, rendere
118
147
  else None
119
148
  )
120
149
  with (out / "rudiment-analysis.jsonl").open("w", encoding="utf-8") as analysis:
121
- for n in range(p.frame_count):
150
+ for n in range(frame_count):
122
151
  image, context = compositor.frame(n, apply_quality=False)
123
152
  if effects:
124
153
  if n in selected:
@@ -141,10 +170,15 @@ def preflight(project, output, *, ffmpeg=None, ffprobe=None, scene=None, rendere
141
170
  p.verify_inputs()
142
171
  result = dict(
143
172
  p.summary(),
173
+ preflight_scope=scope,
144
174
  composition=compositor.evidence(),
145
175
  full_frame_effects=effects.evidence() if effects else None,
146
176
  analysis_sidecar=_sidecar(out),
147
- state="preflight passed; no encoded video",
177
+ state=(
178
+ "full preflight passed; no encoded video"
179
+ if scope["complete"]
180
+ else "bounded-prefix preflight passed; later frames unvalidated; no encoded video"
181
+ ),
148
182
  )
149
183
  write_json(out / "manifest.json", result)
150
184
  return result
@@ -8,7 +8,7 @@ async function initialise(config) {
8
8
  const engine = window.butterchurn.default || window.butterchurn;
9
9
  const viz = engine.createVisualizer(null, canvas, {
10
10
  width: config.width, height: config.height, pixelRatio: 1, textureRatio: 1,
11
- meshWidth: 64, meshHeight: 48,
11
+ meshWidth: config.mesh_width, meshHeight: config.mesh_height,
12
12
  });
13
13
  const r = viz.renderer, gl = r.gl;
14
14
  for (const name of ['targetFrameBuffer', 'targetTexture', 'calcTimeAndFPS']) {
@@ -114,5 +114,6 @@ async function initialise(config) {
114
114
  return {engine: 'butterchurn', version: '2.6.7', opengl: gl.getParameter(gl.VERSION),
115
115
  renderer: info ? gl.getParameter(info.UNMASKED_RENDERER_WEBGL) : gl.getParameter(gl.RENDERER),
116
116
  input: 'full composed RGBA injected into feedback before real MilkDrop warp/composite',
117
- clock: 'pinned calcTimeAndFPS bridge: output frame / fps; fixed fps', seed: config.seed};
117
+ clock: 'pinned calcTimeAndFPS bridge: output frame / fps; fixed fps', seed: config.seed,
118
+ mesh_width: config.mesh_width, mesh_height: config.mesh_height};
118
119
  }
@@ -3,13 +3,14 @@
3
3
  from array import array
4
4
  import base64
5
5
  import json
6
+ import math
6
7
  import mmap
7
8
  import os
8
9
  from pathlib import Path
9
10
  import shutil
10
11
  import subprocess
11
12
 
12
- from PIL import Image
13
+ from PIL import Image, ImageColor, ImageOps
13
14
 
14
15
  from .encoding import audio_filters
15
16
  from .io import fields, integer, number, sha256
@@ -31,6 +32,57 @@ def _preset_ref(project, engine, preset, *, trusted=False):
31
32
  return project.ref(preset)
32
33
 
33
34
 
35
+ def _colour(value, label):
36
+ if not isinstance(value, str):
37
+ raise ValueError(f"{label} must be a CSS colour string")
38
+ try:
39
+ rgb = ImageColor.getrgb(value)
40
+ except ValueError as exc:
41
+ raise ValueError(f"{label} must be a CSS colour string") from exc
42
+ if len(rgb) != 3:
43
+ raise ValueError(f"{label} must not include alpha")
44
+ return "#" + "".join(f"{channel:02x}" for channel in rgb)
45
+
46
+
47
+ def _palette_grade(config, label):
48
+ if config is None:
49
+ return None
50
+ if not isinstance(config, dict):
51
+ raise ValueError(f"{label} must be an object")
52
+ fields(config, {"stops", "amount"}, label)
53
+ stops = config.get("stops")
54
+ if not isinstance(stops, list) or not 2 <= len(stops) <= 16:
55
+ raise ValueError(f"{label}.stops must contain 2 to 16 CSS colours")
56
+ return dict(
57
+ stops=[_colour(value, f"{label}.stops[{index}]") for index, value in enumerate(stops)],
58
+ amount=number(config.get("amount", 1), f"{label}.amount", minimum=0, maximum=1),
59
+ )
60
+
61
+
62
+ def apply_palette_grade(image, config):
63
+ """Map output luminance through an ordered palette while preserving alpha."""
64
+ if config is None or config["amount"] == 0:
65
+ return image
66
+ source = image.convert("RGBA")
67
+ alpha = source.getchannel("A")
68
+ rgb = source.convert("RGB")
69
+ grey = ImageOps.grayscale(rgb)
70
+ colours = [ImageColor.getrgb(value) for value in config["stops"]]
71
+ tables = [[], [], []]
72
+ for value in range(256):
73
+ position = value * (len(colours) - 1) / 255
74
+ lower = min(math.floor(position), len(colours) - 2)
75
+ fraction = position - lower
76
+ for channel in range(3):
77
+ tables[channel].append(
78
+ round(colours[lower][channel] * (1 - fraction) + colours[lower + 1][channel] * fraction)
79
+ )
80
+ graded = Image.merge("RGB", tuple(grey.point(table) for table in tables))
81
+ result = Image.blend(rgb, graded, config["amount"]).convert("RGBA")
82
+ result.putalpha(alpha)
83
+ return result
84
+
85
+
34
86
  def effect_specs(project):
35
87
  configs = project.data.get("effects", [])
36
88
  if not isinstance(configs, list) or len(configs) > 8:
@@ -47,6 +99,9 @@ def effect_specs(project):
47
99
  "seed",
48
100
  "trusted_preset",
49
101
  "preset_timeline",
102
+ "mesh_width",
103
+ "mesh_height",
104
+ "output_palette_grade",
50
105
  },
51
106
  "full-frame effect",
52
107
  )
@@ -56,6 +111,8 @@ def effect_specs(project):
56
111
  engine = cfg.get("engine")
57
112
  if engine not in {"butterchurn", "projectm"}:
58
113
  raise ValueError("Full-frame engine must be butterchurn or projectm")
114
+ if engine != "butterchurn" and ("mesh_width" in cfg or "mesh_height" in cfg):
115
+ raise ValueError("mesh_width and mesh_height require Butterchurn")
59
116
  ref = _preset_ref(
60
117
  project,
61
118
  engine,
@@ -108,6 +165,15 @@ def effect_specs(project):
108
165
  input_mix=number(cfg.get("input_mix", 0.65), "input mix", minimum=0.001, maximum=1),
109
166
  seed=integer(cfg.get("seed", 0), "visualiser seed", maximum=2**32 - 1),
110
167
  preset_timeline=resolved_timeline,
168
+ mesh_width=integer(
169
+ cfg.get("mesh_width", 64), "Butterchurn mesh width", minimum=16, maximum=256
170
+ ),
171
+ mesh_height=integer(
172
+ cfg.get("mesh_height", 48), "Butterchurn mesh height", minimum=12, maximum=256
173
+ ),
174
+ output_palette_grade=_palette_grade(
175
+ cfg.get("output_palette_grade"), "full-frame effect.output_palette_grade"
176
+ ),
111
177
  )
112
178
  )
113
179
  return specs
@@ -174,7 +240,7 @@ class EffectAudio:
174
240
 
175
241
 
176
242
  class ButterchurnBackend:
177
- def __init__(self, size, fps, preset, mix, seed, work):
243
+ def __init__(self, size, fps, preset, mix, seed, work, *, mesh_width=64, mesh_height=48):
178
244
  runtime = Path(os.environ.get("FRAMERUDIMENTS_BUTTERCHURN_RUNTIME", ""))
179
245
  browser = os.environ.get("FRAMERUDIMENTS_BROWSER")
180
246
  node = os.environ.get("FRAMERUDIMENTS_NODE") or shutil.which("node")
@@ -216,6 +282,8 @@ class ButterchurnBackend:
216
282
  preset=json.loads(Path(preset).read_text(encoding="utf-8")),
217
283
  mix=mix,
218
284
  seed=seed,
285
+ mesh_width=mesh_width,
286
+ mesh_height=mesh_height,
219
287
  work=str(Path(work).resolve()),
220
288
  profile_root=str(profile_root),
221
289
  )
@@ -323,6 +391,7 @@ class EffectChain:
323
391
  if type(opacity) not in (int, float) or not 0 <= opacity <= 1:
324
392
  raise ValueError("Stage injection opacity must be between zero and one")
325
393
  self.stage_injections.setdefault(before, []).append((tuple(names), opacity))
394
+ default_factories = factories is None
326
395
  if factories is None:
327
396
  from .projectm_backend import ProjectMBackend
328
397
 
@@ -330,14 +399,23 @@ class EffectChain:
330
399
  try:
331
400
  self.audio = EffectAudio(project, ffmpeg, output)
332
401
  for spec in specs:
333
- backend = factories[spec["engine"]](
402
+ backend_args = [
334
403
  (project.width, project.height),
335
404
  project.fps,
336
405
  spec["preset"]["path"],
337
406
  spec["input_mix"],
338
407
  spec["seed"],
339
408
  output,
409
+ ]
410
+ backend_kwargs = (
411
+ dict(
412
+ mesh_width=spec.get("mesh_width", 64),
413
+ mesh_height=spec.get("mesh_height", 48),
414
+ )
415
+ if default_factories and spec["engine"] == "butterchurn"
416
+ else {}
340
417
  )
418
+ backend = factories[spec["engine"]](*backend_args, **backend_kwargs)
341
419
  self.backends.append(backend)
342
420
  except BaseException:
343
421
  self.close()
@@ -395,6 +473,7 @@ class EffectChain:
395
473
  image = backend.process(image, context, pcm)
396
474
  if image.size != (self.audio.project.width, self.audio.project.height) or image.mode != "RGBA":
397
475
  raise ValueError("Visualiser must return frame-sized RGBA")
476
+ image = apply_palette_grade(image, self.specs[index].get("output_palette_grade"))
398
477
  self.next_frame += 1
399
478
  if overlay is not None:
400
479
  final = image.convert("RGBA")