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

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

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

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

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

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

|
|
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.
|
|
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"
|
|
@@ -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 == "
|
|
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 =
|
|
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
|
|
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(
|
|
111
|
-
|
|
112
|
-
|
|
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(
|
|
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=
|
|
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:
|
|
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
|
-
|
|
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")
|