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.
- {framerudiments-0.4.0/src/framerudiments.egg-info → framerudiments-0.4.1}/PKG-INFO +22 -1
- {framerudiments-0.4.0 → framerudiments-0.4.1}/README.md +21 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/RELEASE_NOTES.md +13 -0
- framerudiments-0.4.1/docs/controlled-audio-response.md +105 -0
- framerudiments-0.4.1/docs/media/rangoli-transcript.md +12 -0
- framerudiments-0.4.1/docs/media/rangoli.mp4 +0 -0
- framerudiments-0.4.1/docs/media/rangoli.png +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/project-format.md +1 -0
- framerudiments-0.4.1/docs/rangoli.md +69 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/pyproject.toml +1 -1
- framerudiments-0.4.1/scripts/Run-ControlledPresetAnalysis.ps1 +58 -0
- framerudiments-0.4.1/scripts/controlled_preset_analysis.py +274 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/__init__.py +1 -1
- framerudiments-0.4.1/src/framerudiments/audio_probes.py +132 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/cli.py +5 -2
- framerudiments-0.4.1/src/framerudiments/controlled_profiling.py +177 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/demo.py +28 -0
- framerudiments-0.4.1/src/framerudiments/rangoli_renderer.py +88 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/rudiment_renderers.py +3 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visualisation_catalogue.py +5 -1
- framerudiments-0.4.1/src/framerudiments/visualiser_assets/rangoli-background.milk +26 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1/src/framerudiments.egg-info}/PKG-INFO +22 -1
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments.egg-info/SOURCES.txt +13 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_advanced_renderers.py +1 -0
- framerudiments-0.4.1/tests/test_controlled_audio.py +134 -0
- framerudiments-0.4.1/tests/test_rangoli_renderer.py +47 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/AGENTS.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/LICENSE +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/MANIFEST.in +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/analysis-releases.json +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/FrameRudiments-PATCH_WORKFLOW.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/annular-modulation.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/authoring-workspace.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/beat-alignment.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/expanded-effects.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/extraction.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/full-preset-analysis.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/keyframed-mattes.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/media/beat-alignment-evidence.json +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/media/beat-alignment.mp4 +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/media/beat-alignment.png +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/media/demo-transcript.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/media/effects-pipeline.svg +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/media/full-frame-comparison.png +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/media/full-frame-demo.mp4 +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/media/media-evidence.json +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/media/preset-test-cards.png +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/media/test-card-inputs/colour-bars.png +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/media/test-card-inputs/grid-rings.png +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/media/test-card-inputs/text-card.png +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/multi-stem-modulation.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/music-reactive-3d.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/particle-smoke.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/phase3-compositing.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/preset-behaviour.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/preset-profiling.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/projectm-local-runtime.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/quality-effects.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/rich-lyric-effects.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/rudiment-renderers.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/scoped-post-effects.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/solid-spatial-renderers.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/spatial-renderers.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/spatiotemporal-supersampling.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/spectrum.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/sprite-visualisations.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/stem-sources-and-masks.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/variable-bpm-word-subtitles.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/visualisation-atlas.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/visualisation-coverage-matrix.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/visualiser-routing.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/visualisers.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/docs/workflow-media.md +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/integration/test_music_spatial_gpu.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/integration/test_preset_analysis.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/integration/test_released_preset_analysis.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/integration/test_visualisers_gpu.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/Run-FullPresetAnalysis.ps1 +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/Run-PresetBehaviourAnalysis.ps1 +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/authoring_preview.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/build_sprite_assets.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/check_projectm_runtime.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/check_release_packages.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/ensure_projectm_runtime.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/full_preset_analysis.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/generate_particle_gallery.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/generate_post_effect_gallery.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/generate_quality_gallery.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/generate_rich_lyric_gallery.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/generate_sprite_gallery.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/generate_supersampling_gallery.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/generate_timing_gallery.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/generate_visualisation_gallery.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/generate_visualiser_routing_gallery.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/install_analysis_releases.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/prepare_pixelcue_taggers.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/preset_behaviour_pipeline.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/profile_visualisation_coverage.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/profile_visualisers.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/projectm_dll_diagnostics.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/repair_projectm_mingw.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/select_projectm_generator.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/scripts/validate_patch.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/setup.cfg +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/__main__.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/advanced_renderers.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/atlas.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/beat_alignment.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/beat_timeline.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/choreography.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/circular_renderers.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/compositor.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/effect_catalogue.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/effect_renderers.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/effects.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/encoding.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/flight.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/gpu_spatial_backend.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/io.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/keyframes.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/layer_animation.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/layer_displacement.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/layer_masks.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/lyric_indicator.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/modulation.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/motion.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/music_spatial_renderers.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/output_quality.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/particle_engine.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/post_effects.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/preset_library.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/preset_profiling.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/profile_analysis.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/project.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/projectm_backend.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/quality_effects.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/render.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/rich_subtitles.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/scoped_effects.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/solid_spatial_renderers.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/spatial_renderers.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/spectrum.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/arcade.png +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/crystal.png +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/fire.png +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/generated-neon.png +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/glass.png +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/hud.png +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/ice.png +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/lcd-amber.png +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/lcd-green.png +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/lcd.png +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/led.png +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/manifest.json +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/metal.png +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/mono.png +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/neon.png +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/pixel.png +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/plasma.png +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_assets/vfd.png +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_catalogue.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/sprite_renderers.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/stem_blend.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/stemlab.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/subtitles.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/super_sampling.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/terrain_field.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/timeline.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visual_style.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visualiser_assets/butterchurn-page.js +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visualiser_assets/butterchurn-worker.mjs +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visualiser_assets/feedback.json +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visualiser_assets/feedback.milk +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visualiser_assets/julia.json +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visualiser_assets/julia.milk +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visualiser_assets/kaleidoscope.json +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visualiser_assets/kaleidoscope.milk +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visualiser_assets/package-lock.json +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visualiser_assets/package.json +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visualiser_routing.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visualiser_setup.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/visualisers.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments/word_timing.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments.egg-info/dependency_links.txt +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments.egg-info/entry_points.txt +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments.egg-info/requires.txt +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/src/framerudiments.egg-info/top_level.txt +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/conftest.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_adapters.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_authoring_preview.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_beat_alignment.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_behaviour_pipeline.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_coverage_matrix.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_default_antialias.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_effect_batch.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_extracted_helpers.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_flight.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_full_preset_analysis.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_gpu_ci_isolation.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_keyframes.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_layer_masks.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_lyrics.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_music_spatial_pipeline.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_music_spatial_renderers.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_particle_engine.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_patch_validation.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_phase3_animation.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_phase3_gpu_injection.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_pipeline.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_preset_profiling.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_projectm_dll_diagnostics.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_projectm_generator.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_projectm_runtime_preflight.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_pytest_temp_isolation.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_quality_effects.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_release_metadata.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_repair_projectm_mingw.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_rich_subtitles.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_rudiment_renderers.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_scoped_effects.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_solid_spatial_integration.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_solid_spatial_renderers.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_spatial_renderers.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_spectrum.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_sprite_renderers.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_stem_blend.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_stem_source_integration.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_supersampling.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_timeline.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_variable_bpm_words.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_visualisation_modulation.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_visualiser_routing.py +0 -0
- {framerudiments-0.4.0 → framerudiments-0.4.1}/tests/test_visualisers.py +0 -0
- {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.
|
|
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
|
+

|
|
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
|
+

|
|
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.
|
|
Binary file
|
|
Binary file
|
|
@@ -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
|
+

|
|
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.
|
|
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())
|