vizcore 0.1.0 → 1.1.0

data/examples/readme_demo.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+# Minimal scene used to generate docs/assets/vizcore-demo.gif.
+# It intentionally shows one idea: detected beats expand the rings.
+Vizcore.define do
+  scene :readme_demo do
+    layer :beat_rings do
+      palette "#24f6ff", "#ff2bbd", "#caff2e"
+
+      circle count: 4 do
+        radius 92
+        stroke 3
+        map beat_pulse, to: :radius, gain: 160.0, min: 56, max: 164, attack: 1.0, release: 0.2
+      end
+    end
+  end
+end

data/examples/rhythm_geometry.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+# Recommended audio file for this scene:
+#   examples/assets/complex_demo_loop.wav
+# Drum-only sync check:
+#   spec/fixtures/audio/kick_120bpm.wav
+# Motion is gated by audio level, so silence holds the shape still.
+Vizcore.define do
+  scene :rhythm_geometry do
+    layer :morphing_geometry do
+      shader :unyo_geometry
+      sides 7.0
+      scale 1.02
+      wobble 0.72
+      twist 0.84
+      pulse 0.0
+      kick 0.0
+      snare 0.0
+      line_glow 0.38
+      effect :bloom
+      effect_intensity 0.42
+
+      map beat_count => :seed
+      map beat_pulse, to: :pulse, range: 0.0..1.65, attack: 1.0, release: 0.14
+      map amplitude, to: :scale, gain: 0.7, range: 0.82..1.25, curve: :sqrt, attack: 0.95, release: 0.18
+      map frequency_band(:low), to: :kick, gain: 3.8, range: 0.0..1.45, curve: :sqrt, attack: 1.0, release: 0.08
+      map frequency_band(:low), to: :wobble, gain: 3.0, range: 0.45..1.7, curve: :sqrt, attack: 0.95, release: 0.16
+      map frequency_band(:mid), to: :twist, gain: 2.4, range: 0.55..2.4, curve: :sqrt
+      map frequency_band(:high), to: :snare, gain: 2.2, range: 0.0..1.1, curve: :sqrt, attack: 1.0, release: 0.12
+      map frequency_band(:high), to: :line_glow, gain: 2.0, range: 0.28..1.3
+      map frequency_band(:high), to: :effect_intensity, gain: 1.4, range: 0.24..0.78
+    end
+  end
+end

data/examples/ruby_crystal_show.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+# Ruby-themed showcase using crystal, text, and particle layers.
+Vizcore.define do
+  scene :ruby_crystal do
+    layer :crystal_core do
+      shader :ruby_crystal
+      facets 6.0
+      refraction 0.48
+      blend :screen
+
+      map bass, to: :refraction, gain: 0.8, range: 0.28..0.78, curve: :sqrt
+      map mid, to: :facets, gain: 2.0, range: 5.0..10.0
+    end
+
+    layer :gem_sparks do
+      type :particle_field
+      count 2600
+      blend :add
+      map amplitude, to: :speed, gain: 2.6, range: 0.2..4.8, curve: :sqrt
+      map bass, to: :size, gain: 3.2, range: 1.8..7.0
+      map treble, to: :sparkle, gain: 2.6, range: 0.0..1.0
+    end
+
+    layer :ruby_title do
+      type :text
+      content "RUBY"
+      font_size 118
+      color "#ff335f"
+      glow_strength 0.35
+      blend :screen
+      map beat_pulse, to: :glow_strength, range: 0.24..0.9
+    end
+  end
+end

data/examples/shader_playground.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+# Minimal shader-focused scene for trying mapped parameters.
+Vizcore.define do
+  scene :shader_playground do
+    layer :liquid do
+      shader :liquid_wobble
+      param :wobble, default: 0.35, range: 0.0..2.0, step: 0.05
+      param :warp, default: 0.45, range: 0.0..3.0, step: 0.05
+      param :distortion, default: 0.25, range: 0.0..2.0, step: 0.05
+      blend :screen
+
+      map amplitude, to: :wobble, gain: 2.2, range: 0.18..1.2, curve: :sqrt
+      map bass, to: :warp, gain: 2.4, range: 0.25..2.2
+      map treble, to: :distortion, gain: 2.0, range: 0.2..1.6
+    end
+  end
+end

data/examples/unyo_liquid.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+Vizcore.define do
+  scene :unyo do
+    layer :liquid do
+      shader :liquid_wobble
+      opacity 1.0
+      blend :alpha
+      effect :feedback
+      effect_intensity 0.14
+      wobble 0.25
+      warp 0.45
+      distortion 0.25
+
+      map amplitude, to: :wobble, gain: 3.5, range: 0.12..1.4, curve: :sqrt, attack: 0.9, release: 0.18
+      map frequency_band(:low), to: :warp, gain: 2.2, range: 0.25..2.4, attack: 0.8, release: 0.2
+      map frequency_band(:high), to: :distortion, gain: 1.8, range: 0.1..1.6
+      map beat_pulse, to: :effect_intensity, range: 0.08..0.35, attack: 1.0, release: 0.2
+    end
+
+    layer :particles do
+      type :particle_field
+      count 7000
+      blend :add
+      opacity 0.55
+      size 2.8
+      force_field :vortex
+      turbulence 0.55
+      bass_explosion 0.9
+      sparkle 0.35
+
+      map amplitude, to: :speed, gain: 4.0, range: 0.4..4.0, curve: :sqrt
+      map frequency_band(:low), to: :size, gain: 6.0, range: 2.0..8.0, curve: :sqrt
+      map beat_pulse, to: :bass_explosion, gain: 1.2, range: 0.3..1.8
+    end
+
+    layer :blob_outline do
+      type :radial_blob
+      blend :add
+      opacity 0.65
+      segments 192
+      radius 0.42
+      wobble 0.2
+
+      map fft_spectrum => :spectrum
+      map amplitude, to: :wobble, gain: 2.8, range: 0.08..0.75, curve: :sqrt
+      map frequency_band(:low), to: :radius, gain: 0.8, range: 0.36..0.72
+    end
+
+    layer :title do
+      type :text
+      content "UNYO"
+      font_size 72
+      color "#f8fbff"
+      glow_strength 0.08
+      map beat_pulse, to: :glow_strength, range: 0.08..0.42, attack: 1.0, release: 0.2
+    end
+  end
+end

data/examples/vj_ambient_chill_room.rb

@@ -0,0 +1,124 @@
+# frozen_string_literal: true
+
+# vj_ambient_chill_room.rb
+#
+# Genre   : Ambient / Chill Room
+# BPM     : none, or 60-90 when a pulse appears
+# Duration: slow rotation between two long scenes
+# Audio   : --audio-source mic
+#           --audio-source file --audio-file examples/assets/complex_demo_loop.wav
+# Keys    : 1 bloom, 2 nebula, B blackout, F freeze
+# MIDI    : note 36..37 = scenes, CC 1 = global intensity
+Vizcore.define do
+  set :global_intensity, 0.7
+  audio_normalize mode: :adaptive, window: 8.0, target: 0.72, floor: 0.03
+
+  theme :chill_room do
+    palette "#1e293b", "#64748b", "#a5b4fc", "#f8fafc"
+    background "#020617"
+  end
+
+  style :soft_screen do
+    blend :screen
+    opacity 0.52
+  end
+
+  scene :bloom do
+    use_theme :chill_room
+
+    layer :slow_ribbon do
+      shader :waveform_ribbon
+      use_style :soft_screen
+      effect :bloom
+      effect_intensity 0.18
+      map amplitude, to: :opacity, gain: 0.85, range: 0.28..0.86, curve: :sqrt, attack: 0.18, release: 0.72
+      map beat_pulse, to: :effect_intensity, range: 0.12..0.34, attack: 0.24, release: 0.82
+      map fft_spectrum => :deform
+    end
+
+    layer :breathing_halo do
+      type :radial_blob
+      opacity 0.46
+      blend :add
+      segments 192
+      radius 0.42
+      wobble 0.18
+      map amplitude, to: :wobble, gain: 1.3, range: 0.08..0.48, curve: :sqrt, attack: 0.2, release: 0.82
+      map beat_confidence, to: :radius, gain: 0.14, range: 0.38..0.54
+      map fft_spectrum => :deform
+    end
+  end
+
+  scene :nebula do
+    use_theme :chill_room
+
+    layer :deep_spectrum do
+      type :spectrogram
+      scroll :horizontal
+      bins 80
+      history 220
+      gain 0.62
+      opacity 0.5
+      blend :screen
+      effect :motion_blur
+      effect_intensity 0.12
+      map amplitude, to: :opacity, gain: 0.7, range: 0.22..0.68, attack: 0.18, release: 0.76
+      map beat_pulse, to: :effect_intensity, range: 0.08..0.26, release: 0.82
+      map fft_spectrum => :deform
+    end
+
+    layer :nebula_points do
+      type :particle_field
+      count 1200
+      speed 0.18
+      size 2.6
+      force_field :drift
+      turbulence 0.12
+      opacity 0.42
+      blend :add
+      map amplitude, to: :speed, gain: 0.9, range: 0.08..0.72, curve: :sqrt, attack: 0.22, release: 0.84
+      map low, to: :size, gain: 2.2, range: 1.8..5.2
+      map fft_spectrum => :deform
+    end
+  end
+
+  transition from: :bloom, to: :nebula do
+    trigger { seconds >= 90 || beat_count >= 96 }
+    effect :crossfade, duration: 3.0
+  end
+
+  transition from: :nebula, to: :bloom do
+    trigger { seconds >= 90 || beat_count >= 96 }
+    effect :crossfade, duration: 3.0
+  end
+
+  midi :controller, device: :default
+
+  midi_map note: 36 do
+    switch_scene :bloom
+  end
+
+  midi_map note: 37 do
+    switch_scene :nebula
+  end
+
+  midi_map cc: 1 do |value|
+    set :global_intensity, value / 127.0
+  end
+
+  key "1" do
+    switch_scene :bloom
+  end
+
+  key "2" do
+    switch_scene :nebula
+  end
+
+  key "b" do
+    blackout
+  end
+
+  key "f" do
+    freeze
+  end
+end

data/examples/vj_dnb_jungle.rb

@@ -0,0 +1,170 @@
+# frozen_string_literal: true
+
+# vj_dnb_jungle.rb
+#
+# Genre   : Drum & Bass / Jungle
+# BPM     : 170-180
+# Duration: 3-scene break workout
+# Audio   : --audio-source mic
+#           --audio-source file --audio-file examples/assets/complex_demo_loop.wav
+# Keys    : 1 rollers, 2 amen, 3 reese, B blackout, F freeze, Space tap-tempo
+# MIDI    : note 36..38 = scenes, note 40 = reese, CC 1 = global intensity
+Vizcore.define do
+  set :global_intensity, 0.88
+  audio_normalize mode: :adaptive, window: 2.5, target: 0.86, floor: 0.04
+  bpm 176
+  bpm_lock true
+  tap_tempo key: :space
+
+  theme :jungle_neon do
+    palette "#00f5d4", "#00bbf9", "#f15bb5", "#fee440"
+    background "#030712"
+  end
+
+  style :fast_add do
+    blend :add
+    opacity 0.76
+  end
+
+  scene :rollers do
+    use_theme :jungle_neon
+
+    layer :star_tunnel do
+      shader :starfield
+      blend :screen
+      effect :motion_blur
+      effect_intensity 0.16
+      map amplitude, to: :warp, gain: 1.8, range: 0.18..1.3, curve: :sqrt
+      map beat_pulse, to: :effect_intensity, range: 0.12..0.42, attack: 1.0, release: 0.08
+      map fft_spectrum => :deform
+    end
+
+    layer :rolling_particles do
+      type :particle_field
+      count 4200 # tune: 2600 for laptops, 6000 for stage machines
+      force_field :flow
+      speed 2.6
+      size 1.6
+      use_style :fast_add
+      react_to amplitude do
+        change :speed, gain: 3.6, range: 1.2..7.2, curve: :sqrt
+        change :size, gain: 2.4, range: 1.2..4.6
+      end
+      map hihat, to: :sparkle, gain: 2.8, range: 0.1..1.0, attack: 1.0, release: 0.05
+      map fft_spectrum => :deform
+    end
+  end
+
+  scene :amen do
+    use_theme :jungle_neon
+
+    layer :kick_cube do
+      type :wireframe_cube
+      opacity 0.6
+      blend :add
+      map kick, to: :scale, gain: 0.9, range: 0.74..1.46, curve: :sqrt, attack: 1.0, release: 0.08
+      map low, to: :rotation_speed, gain: 1.4, range: 0.12..2.4
+      map fft_spectrum => :deform
+    end
+
+    layer :snare_cube do
+      type :wireframe_cube
+      opacity 0.48
+      blend :difference
+      map snare, to: :color_shift, gain: 2.2, range: 0.1..1.0, attack: 1.0, release: 0.06
+      map mid, to: :rotation_speed, gain: 1.6, range: 0.2..2.8
+      map fft_spectrum => :deform
+    end
+
+    layer :hat_text do
+      type :text
+      content "176 BPM"
+      font "Inter"
+      font_size 52
+      align :center
+      color "#eaffff"
+      glow_strength 0.18
+      blend :screen
+      map hihat, to: :glow_strength, gain: 2.8, range: 0.16..0.95, attack: 1.0, release: 0.05
+      map beat_pulse, to: :letter_spacing, gain: 18.0, min: 0.0, max: 24.0
+      map fft_spectrum => :deform
+    end
+  end
+
+  scene :reese do
+    use_theme :jungle_neon
+
+    layer :reese_warp do
+      shader :bass_tunnel
+      blend :screen
+      effect :feedback
+      effect_intensity 0.18
+      map bass, to: :warp, gain: 3.0, range: 0.2..2.2, curve: :sqrt
+      map kick, to: :effect_intensity, gain: 1.1, range: 0.12..0.62, attack: 1.0, release: 0.1
+      map fft_spectrum => :deform
+    end
+
+    layer :chromatic_noise do
+      shader :glitch_flash
+      blend :add
+      effect :chromatic
+      effect_intensity 0.22
+      opacity 0.58
+      map amplitude, to: :opacity, gain: 0.8, range: 0.34..0.84
+      map onset(:high), to: :effect_intensity, gain: 2.4, range: 0.12..0.9, attack: 1.0, release: 0.05
+      map fft_spectrum => :deform
+    end
+  end
+
+  transition from: :rollers, to: :amen do
+    trigger { beat_count >= 32 || frame_count >= 360 }
+    effect :crossfade, duration: 0.45
+  end
+
+  transition from: :amen, to: :rollers do
+    trigger { beat_count >= 64 || frame_count >= 720 }
+    effect :flash, duration: 0.18
+  end
+
+  midi :controller, device: :default
+
+  midi_map note: 36 do
+    switch_scene :rollers
+  end
+
+  midi_map note: 37 do
+    switch_scene :amen
+  end
+
+  midi_map note: 38 do
+    switch_scene :reese
+  end
+
+  midi_map note: 40 do
+    switch_scene :reese
+  end
+
+  midi_map cc: 1 do |value|
+    set :global_intensity, value / 127.0
+  end
+
+  key "1" do
+    switch_scene :rollers
+  end
+
+  key "2" do
+    switch_scene :amen
+  end
+
+  key "3" do
+    switch_scene :reese
+  end
+
+  key "b" do
+    blackout
+  end
+
+  key "f" do
+    freeze
+  end
+end

data/examples/vj_festival_mainstage.rb

@@ -0,0 +1,245 @@
+# frozen_string_literal: true
+
+# vj_festival_mainstage.rb
+#
+# Genre   : EDM / Festival mainstage
+# BPM     : 124-132
+# Duration: opener, warmup, build, drop, outro
+# Audio   : --audio-source mic
+#           --audio-source file --audio-file examples/assets/complex_demo_loop.wav
+# Keys    : 1..5 scenes, B blackout, F freeze, Space tap-tempo
+# MIDI    : note 36..40 = scenes, CC 1 = global intensity
+#
+# Manifest: examples/vj_festival_mainstage.yml shows a reusable file-audio setup.
+Vizcore.define do
+  set :global_intensity, 0.92
+  audio_normalize mode: :adaptive, window: 3.0, target: 0.88, floor: 0.04
+  bpm 128
+  bpm_lock true
+  tap_tempo key: :space
+
+  theme :mainstage do
+    palette "#ffffff", "#00f5ff", "#ff2f92", "#fffb00"
+    background "#020617"
+  end
+
+  style :stage_glow do
+    blend :screen
+    opacity 0.82
+  end
+
+  scene :opener do
+    use_theme :mainstage
+
+    layer :opener_logo_slot do
+      type :text
+      content "MAIN STAGE"
+      font "Inter"
+      font_size 78
+      align :center
+      color "#ffffff"
+      stroke width: 2, color: "#020617"
+      shadow color: "#00f5ff", blur: 20
+      glow_strength 0.24
+      use_style :stage_glow
+      map amplitude, to: :glow_strength, gain: 1.4, range: 0.18..0.88, curve: :sqrt
+      map beat_pulse, to: :font_size, gain: 20.0, min: 72.0, max: 106.0
+      map fft_spectrum => :deform
+    end
+
+    layer :countdown_rings do
+      type :shape
+      blend :add
+      opacity 0.52
+      circle x: 640, y: 360, radius: 130, count: 6 do
+        stroke 3
+        map low, to: :radius, gain: 120.0, min: 110.0, max: 230.0
+        map beat_pulse, to: :stroke, gain: 5.0, min: 2.0, max: 8.0
+      end
+    end
+  end
+
+  scene :warmup do
+    use_theme :mainstage
+
+    layer :warmup_grid do
+      shader :neon_grid
+      use_style :stage_glow
+      effect :bloom
+      effect_intensity 0.16
+      map amplitude, to: :effect_intensity, gain: 1.1, range: 0.12..0.52, curve: :sqrt
+      map beat_pulse, to: :pulse, range: 0.12..0.62
+      map fft_spectrum => :deform
+    end
+
+    layer :warmup_cube do
+      type :wireframe_cube
+      opacity 0.64
+      blend :add
+      map bass, to: :rotation_speed, gain: 2.0, range: 0.18..3.2
+      map kick, to: :scale, gain: 0.55, range: 0.82..1.4
+      map fft_spectrum => :deform
+    end
+  end
+
+  scene :build do
+    use_theme :mainstage
+
+    layer :riser_tunnel do
+      shader :bass_tunnel
+      use_style :stage_glow
+      effect :motion_blur
+      effect_intensity 0.18
+      map amplitude, to: :warp, gain: 2.2, range: 0.18..1.8, curve: :sqrt
+      map beat_pulse, to: :effect_intensity, range: 0.12..0.55, attack: 1.0, release: 0.1
+      map fft_spectrum => :deform
+    end
+
+    layer :riser_particles do
+      type :particle_field
+      count 3600 # tune: 2400 on laptops, 7000 on mainstage GPUs
+      force_field :fountain
+      speed 1.6
+      size 2.2
+      blend :add
+      map high, to: :speed, gain: 3.8, range: 0.8..7.2, curve: :sqrt
+      map kick, to: :bass_explosion, gain: 1.2, range: 0.2..1.5, attack: 1.0, release: 0.08
+      map fft_spectrum => :deform
+    end
+  end
+
+  scene :drop, extends: :build do
+    use_theme :mainstage
+
+    group :foreground do
+      blend :add
+      opacity 0.84
+
+      layer :drop_crystal do
+        shader :ruby_crystal
+        facets 10.0
+        refraction 0.68
+        effect :chromatic
+        effect_intensity 0.2
+        map low, to: :refraction, gain: 1.2, range: 0.42..1.0, curve: :sqrt
+        map beat_pulse, to: :effect_intensity, range: 0.16..0.86, attack: 1.0, release: 0.08
+        map fft_spectrum => :deform
+      end
+
+      layer :drop_title do
+        type :text
+        content "DROP"
+        font_size 132
+        align :center
+        color "#ffffff"
+        glow_strength 0.42
+        shadow color: "#ff2f92", blur: 26
+        map amplitude, to: :glow_strength, gain: 1.4, range: 0.3..1.0
+        map kick, to: :font_size, gain: 36.0, min: 120.0, max: 172.0
+        map fft_spectrum => :deform
+      end
+    end
+  end
+
+  scene :outro do
+    use_theme :mainstage
+
+    layer :afterglow do
+      shader :waveform_ribbon
+      blend :screen
+      opacity 0.56
+      effect :feedback
+      effect_intensity 0.1
+      map amplitude, to: :opacity, gain: 0.7, range: 0.3..0.72
+      map beat_pulse, to: :effect_intensity, range: 0.06..0.24
+      map fft_spectrum => :deform
+    end
+
+    layer :thanks_text do
+      type :text
+      content "THANK YOU"
+      font_size 70
+      align :center
+      color "#ffffff"
+      glow_strength 0.18
+      blend :screen
+      map mid, to: :glow_strength, gain: 1.4, range: 0.12..0.58
+      map beat_pulse, to: :letter_spacing, gain: 12.0, min: 0.0, max: 18.0
+      map fft_spectrum => :deform
+    end
+  end
+
+  transition from: :opener, to: :warmup do
+    on_bar 8
+    effect :crossfade, duration: 0.8
+  end
+
+  transition from: :warmup, to: :build do
+    on_bar 16
+    effect :crossfade, duration: 0.75
+  end
+
+  transition from: :build, to: :drop do
+    trigger { beat_count >= 32 || frame_count >= 480 }
+    effect :flash, duration: 0.3
+  end
+
+  transition from: :drop, to: :outro do
+    on_bar 32
+    effect :crossfade, duration: 1.0
+  end
+
+  midi :controller, device: :default
+
+  midi_map note: 36 do
+    switch_scene :opener
+  end
+
+  midi_map note: 37 do
+    switch_scene :warmup
+  end
+
+  midi_map note: 38 do
+    switch_scene :build
+  end
+
+  midi_map note: 39 do
+    switch_scene :drop
+  end
+
+  midi_map note: 40 do
+    switch_scene :outro
+  end
+
+  midi_map cc: 1 do |value|
+    set :global_intensity, value / 127.0
+  end
+
+  key "1" do
+    switch_scene :opener
+  end
+
+  key "2" do
+    switch_scene :warmup
+  end
+
+  key "3" do
+    switch_scene :build
+  end
+
+  key "4" do
+    switch_scene :drop
+  end
+
+  key "5" do
+    switch_scene :outro
+  end
+
+  key "b" do
+    blackout
+  end
+
+  key "f" do
+    freeze
+  end
+end