vizcore 0.1.0 → 1.0.0

data/examples/vj_jpop_idol_live.rb

@@ -0,0 +1,210 @@
+# frozen_string_literal: true
+
+# vj_jpop_idol_live.rb
+#
+# Genre   : J-POP / Idol live
+# BPM     : 130-180
+# Duration: verse, pre-chorus, chorus, bridge
+# Audio   : --audio-source mic
+#           --audio-source file --audio-file examples/assets/complex_demo_loop.wav
+# Keys    : 1..4 scenes, T palette scene, B blackout, F freeze, Space tap-tempo
+# MIDI    : note 36..39 = scenes, CC 1 = global intensity
+#
+# Logo slot: place your own SVG at examples/assets/your_logo.svg and add an svg
+# layer in :verse. No logo asset is bundled here.
+Vizcore.define do
+  set :global_intensity, 0.9
+  audio_normalize mode: :adaptive, window: 3.0, target: 0.84, floor: 0.04
+  bpm 154
+  tap_tempo key: :space
+
+  theme :idol_pastel do
+    palette "#ff7eb6", "#7afcff", "#feff9c", "#fff4f4", "#bdb2ff", "#caffbf"
+    background "#090a1f"
+  end
+
+  theme :idol_vivid do
+    palette "#ff006e", "#3a86ff", "#ffbe0b", "#06d6a0", "#ffffff"
+    background "#030712"
+  end
+
+  style :penlight do
+    blend :add
+    opacity 0.76
+  end
+
+  scene :verse do
+    use_theme :idol_pastel
+
+    layer :color_base do
+      shader :gradient_pulse
+      blend :screen
+      opacity 0.48
+      map amplitude, to: :effect_intensity, gain: 0.7, range: 0.08..0.32
+      map beat_pulse, to: :pulse, range: 0.08..0.36, attack: 1.0, release: 0.16
+      map fft_spectrum => :deform
+    end
+
+    layer :logo_placeholder do
+      type :text
+      content "YOUR LOGO"
+      font "Inter"
+      font_size 46
+      align :center
+      color "#fff4f4"
+      glow_strength 0.14
+      blend :screen
+      # Replace this text with:
+      # type :svg
+      # file "assets/your_logo.svg"
+      map low, to: :glow_strength, gain: 1.4, range: 0.12..0.56
+      map beat_pulse, to: :font_size, gain: 10.0, min: 42.0, max: 56.0
+      map fft_spectrum => :deform
+    end
+  end
+
+  scene :pre_chorus do
+    use_theme :idol_pastel
+
+    layer :spark_grid do
+      shader :neon_grid
+      use_style :penlight
+      effect :bloom
+      effect_intensity 0.18
+      map high, to: :effect_intensity, gain: 1.6, range: 0.14..0.62
+      map beat_pulse, to: :pulse, range: 0.15..0.8, attack: 1.0, release: 0.12
+      map fft_spectrum => :deform
+    end
+
+    layer :pastel_particles do
+      type :particle_field
+      count 2400
+      force_field :fountain
+      size 2.6
+      use_style :penlight
+      map amplitude, to: :speed, gain: 2.6, range: 0.4..4.8, curve: :sqrt
+      map hihat, to: :sparkle, gain: 2.2, range: 0.2..1.0, attack: 1.0, release: 0.06
+      map fft_spectrum => :deform
+    end
+  end
+
+  scene :chorus do
+    use_theme :idol_vivid
+
+    layer :chorus_burst do
+      shader :kaleidoscope
+      blend :screen
+      opacity 0.92
+      effect :bloom
+      effect_intensity 0.3
+      vj_effect :mirror
+      map amplitude, to: :effect_intensity, gain: 1.6, range: 0.22..0.95, curve: :sqrt
+      map beat_pulse, to: :zoom, range: 0.12..1.0, attack: 1.0, release: 0.12
+      map fft_spectrum => :deform
+    end
+
+    layer :chorus_confetti do
+      type :particle_field
+      count 5200 # tune: lower to 3000 when FPS drops
+      force_field :burst
+      size 3.0
+      speed 2.4
+      blend :add
+      map high, to: :sparkle, gain: 2.8, range: 0.2..1.0
+      map kick, to: :bass_explosion, gain: 1.6, range: 0.4..2.0, attack: 1.0, release: 0.08
+      map fft_spectrum => :deform
+    end
+  end
+
+  scene :bridge do
+    use_theme :idol_pastel
+
+    layer :bridge_ribbon do
+      shader :waveform_ribbon
+      blend :screen
+      opacity 0.6
+      effect :motion_blur
+      effect_intensity 0.12
+      map amplitude, to: :opacity, gain: 0.8, range: 0.34..0.76, curve: :sqrt
+      map beat_pulse, to: :effect_intensity, range: 0.08..0.28
+      map fft_spectrum => :deform
+    end
+
+    layer :bridge_title do
+      type :text
+      content "BRIDGE"
+      font_size 64
+      color "#ffffff"
+      glow_strength 0.18
+      blend :screen
+      map mid, to: :glow_strength, gain: 1.8, range: 0.14..0.72
+      map beat_pulse, to: :letter_spacing, gain: 12.0, min: 0.0, max: 18.0
+      map fft_spectrum => :deform
+    end
+  end
+
+  transition from: :verse, to: :pre_chorus do
+    on_bar 8
+    effect :crossfade, duration: 0.65
+  end
+
+  transition from: :pre_chorus, to: :chorus do
+    on_bar 8
+    effect :flash, duration: 0.28
+  end
+
+  transition from: :chorus, to: :bridge do
+    on_bar 16
+    effect :crossfade, duration: 0.8
+  end
+
+  midi :controller, device: :default
+
+  midi_map note: 36 do
+    switch_scene :verse
+  end
+
+  midi_map note: 37 do
+    switch_scene :pre_chorus
+  end
+
+  midi_map note: 38 do
+    switch_scene :chorus
+  end
+
+  midi_map note: 39 do
+    switch_scene :bridge
+  end
+
+  midi_map cc: 1 do |value|
+    set :global_intensity, value / 127.0
+  end
+
+  key "1" do
+    switch_scene :verse
+  end
+
+  key "2" do
+    switch_scene :pre_chorus
+  end
+
+  key "3" do
+    switch_scene :chorus
+  end
+
+  key "4" do
+    switch_scene :bridge
+  end
+
+  key "t" do
+    switch_scene :chorus
+  end
+
+  key "b" do
+    blackout
+  end
+
+  key "f" do
+    freeze
+  end
+end

data/examples/vj_synthwave_retro.rb

@@ -0,0 +1,173 @@
+# frozen_string_literal: true
+
+# vj_synthwave_retro.rb
+#
+# Genre   : Synthwave / Retro 80s
+# BPM     : 100-120
+# Duration: sunset, highway, laser
+# Audio   : --audio-source mic
+#           --audio-source file --audio-file examples/assets/complex_demo_loop.wav
+# Keys    : 1 sunset, 2 highway, 3 laser, B blackout, F freeze, Space tap-tempo
+# MIDI    : note 36..38 = scenes, CC 1 = global intensity
+Vizcore.define do
+  set :global_intensity, 0.86
+  audio_normalize mode: :adaptive, window: 3.5, target: 0.82, floor: 0.04
+  bpm 112
+  tap_tempo key: :space
+
+  theme :retro_neon do
+    palette "#ff006e", "#8338ec", "#3a86ff", "#ffbe0b"
+    background "#070019"
+  end
+
+  style :neon_lines do
+    blend :add
+    opacity 0.72
+  end
+
+  scene :sunset do
+    use_theme :retro_neon
+
+    layer :sun_disc do
+      type :shape
+      use_style :neon_lines
+      circle x: 640, y: 250, radius: 170, count: 8 do
+        stroke 3
+        map amplitude, to: :radius, gain: 80.0, min: 150.0, max: 230.0, curve: :sqrt
+        map beat_pulse, to: :stroke, gain: 4.0, min: 2.0, max: 7.0
+      end
+    end
+
+    layer :sunset_spectrum do
+      type :spectrogram
+      scroll :horizontal
+      bins 64
+      history 140
+      gain 0.7
+      opacity 0.36
+      blend :screen
+      effect :bloom
+      effect_intensity 0.14
+      map high, to: :gain, gain: 1.4, range: 0.52..1.55
+      map beat_pulse, to: :effect_intensity, range: 0.1..0.42
+      map fft_spectrum => :deform
+    end
+  end
+
+  scene :highway do
+    use_theme :retro_neon
+
+    layer :road_grid do
+      type :shape
+      use_style :neon_lines
+      line x1: 110, y1: 680, x2: 640, y2: 360 do
+        stroke 2
+        map amplitude, to: :stroke, gain: 5.0, min: 1.0, max: 8.0
+      end
+      line x1: 1170, y1: 680, x2: 640, y2: 360 do
+        stroke 2
+        map beat_pulse, to: :stroke, gain: 5.0, min: 1.0, max: 8.0
+      end
+      line x1: 0, y1: 610, x2: 1280, y2: 610 do
+        stroke 2
+        map fft_spectrum => :y1
+      end
+      line x1: 0, y1: 520, x2: 1280, y2: 520 do
+        stroke 2
+        map mid, to: :stroke, gain: 5.0, min: 1.0, max: 7.0
+      end
+    end
+
+    layer :highway_grid_shader do
+      shader :neon_grid
+      blend :screen
+      opacity 0.58
+      effect :chromatic
+      effect_intensity 0.16
+      map low, to: :effect_intensity, gain: 1.4, range: 0.1..0.5
+      map beat_pulse, to: :pulse, range: 0.12..0.72
+      map fft_spectrum => :deform
+    end
+  end
+
+  scene :laser do
+    use_theme :retro_neon
+
+    layer :laser_fan do
+      type :shape
+      use_style :neon_lines
+      line x1: 120, y1: 100, x2: 1180, y2: 650 do
+        stroke 4
+        map amplitude, to: :stroke, gain: 7.0, min: 2.0, max: 12.0
+      end
+      line x1: 1180, y1: 100, x2: 120, y2: 650 do
+        stroke 4
+        map beat_pulse, to: :stroke, gain: 8.0, min: 2.0, max: 13.0
+      end
+      line x1: 640, y1: 0, x2: 640, y2: 720 do
+        stroke 3
+        map fft_spectrum => :x1
+      end
+    end
+
+    layer :laser_glow do
+      shader :glitch_flash
+      blend :add
+      opacity 0.46
+      effect :bloom
+      effect_intensity 0.24
+      vj_effect :color_shift
+      map high, to: :effect_intensity, gain: 2.1, range: 0.18..0.84
+      map kick, to: :opacity, gain: 1.1, range: 0.34..0.92
+      map fft_spectrum => :deform
+    end
+  end
+
+  transition from: :sunset, to: :highway do
+    on_bar 8
+    effect :crossfade, duration: 0.8
+  end
+
+  transition from: :highway, to: :laser do
+    on_bar 8
+    effect :flash, duration: 0.25
+  end
+
+  midi :controller, device: :default
+
+  midi_map note: 36 do
+    switch_scene :sunset
+  end
+
+  midi_map note: 37 do
+    switch_scene :highway
+  end
+
+  midi_map note: 38 do
+    switch_scene :laser
+  end
+
+  midi_map cc: 1 do |value|
+    set :global_intensity, value / 127.0
+  end
+
+  key "1" do
+    switch_scene :sunset
+  end
+
+  key "2" do
+    switch_scene :highway
+  end
+
+  key "3" do
+    switch_scene :laser
+  end
+
+  key "b" do
+    blackout
+  end
+
+  key "f" do
+    freeze
+  end
+end

data/examples/vj_techno_warehouse.rb

@@ -0,0 +1,195 @@
+# frozen_string_literal: true
+
+# vj_techno_warehouse.rb
+#
+# Genre   : Techno / Warehouse
+# BPM     : 128-140
+# Duration: long-loopable
+# Audio   : --audio-source mic
+#           --audio-source file --audio-file examples/assets/complex_demo_loop.wav
+# Keys    : 1..4 scenes, B blackout, F freeze, Space tap-tempo
+# MIDI    : note 36..39 = scenes, CC 1 = global intensity
+#
+# Keep particle counts near the comments below for laptops; raise them for LED walls.
+Vizcore.define do
+  set :global_intensity, 0.85
+  audio_normalize mode: :adaptive, window: 4.0, target: 0.82, floor: 0.04
+  bpm 134
+  bpm_lock true
+  tap_tempo key: :space
+
+  theme :warehouse do
+    palette "#050505", "#e8e8e8", "#ff003c"
+    background "#000000"
+  end
+
+  style :hard_screen do
+    blend :screen
+    opacity 0.82
+  end
+
+  scene :loop do
+    use_theme :warehouse
+
+    layer :bg_grid do
+      shader :neon_grid
+      use_style :hard_screen
+      effect :crt
+      effect_intensity 0.08
+      map bass, to: :effect_intensity, gain: 0.8, range: 0.05..0.22, curve: :sqrt
+      map beat_pulse, to: :pulse, range: 0.08..0.32, attack: 1.0, release: 0.16
+      map fft_spectrum => :deform
+    end
+
+    layer :floor_mesh do
+      type :mesh
+      geometry :icosahedron
+      material :wireframe
+      scale 0.72
+      opacity 0.55
+      map amplitude, to: :opacity, gain: 0.8, range: 0.38..0.72, curve: :sqrt
+      map beat_confidence, to: :scale, gain: 0.28, range: 0.68..1.02
+      map fft_spectrum => :deform
+    end
+  end
+
+  scene :build do
+    use_theme :warehouse
+
+    layer :ribbon_pressure do
+      type :waveform
+      source :audio
+      style :ribbon
+      height 0.34
+      opacity 0.78
+      blend :screen
+      map amplitude, to: :height, gain: 1.4, range: 0.22..0.72, curve: :sqrt, attack: 0.85, release: 0.2
+      map kick, to: :color_shift, range: 0.0..0.9, attack: 1.0, release: 0.08
+      map fft_spectrum => :deform
+    end
+
+    layer :strobe_particles do
+      type :particle_field
+      count 2600 # tune: 1800 for older laptops, 5000 for stronger GPUs
+      size 2.0
+      speed 1.3
+      force_field :vortex
+      blend :add
+      react_to bass do
+        change :speed, gain: 2.6, range: 0.6..4.4, curve: :sqrt
+        change :opacity, gain: 0.9, range: 0.46..0.94
+      end
+      map beat_pulse, to: :sparkle, range: 0.1..1.0, attack: 1.0, release: 0.12
+      map fft_spectrum => :deform
+    end
+  end
+
+  scene :peak do
+    use_theme :warehouse
+
+    layer :crystal_shards do
+      shader :ruby_crystal
+      blend :screen
+      facets 11.0
+      refraction 0.62
+      effect :chromatic
+      effect_intensity 0.18
+      map low, to: :refraction, gain: 1.0, range: 0.36..0.9, curve: :sqrt
+      map kick, to: :effect_intensity, gain: 1.2, range: 0.16..0.72, attack: 1.0, release: 0.07
+      map fft_spectrum => :deform
+    end
+
+    layer :peak_mesh do
+      type :mesh
+      geometry :icosahedron
+      material :wireframe
+      scale 0.96
+      deform 0.22
+      blend :add
+      map amplitude, to: :deform, gain: 2.0, range: 0.12..1.25, curve: :sqrt
+      map beat_confidence, to: :scale, gain: 0.35, range: 0.84..1.32
+      map fft_spectrum => :color_shift
+    end
+  end
+
+  scene :breakdown do
+    use_theme :warehouse
+
+    layer :vertical_spectrum do
+      type :spectrogram
+      scroll :vertical
+      bins 96
+      history 180
+      gain 0.75
+      opacity 0.74
+      blend :screen
+      effect :feedback
+      effect_intensity 0.1
+      map amplitude, to: :opacity, range: 0.32..0.88, attack: 0.55, release: 0.35
+      map high, to: :gain, gain: 1.6, range: 0.55..1.75
+      map beat_pulse, to: :effect_intensity, range: 0.04..0.32
+      map fft_spectrum => :deform
+    end
+  end
+
+  transition from: :loop, to: :build do
+    on_bar 16
+    effect :crossfade, duration: 1.0
+  end
+
+  transition from: :build, to: :peak do
+    trigger { beat_count >= 32 || frame_count >= 480 }
+    effect :flash, duration: 0.24
+  end
+
+  transition from: :breakdown, to: :loop do
+    on_bar 16
+    effect :crossfade, duration: 1.2
+  end
+
+  midi :controller, device: :default
+
+  midi_map note: 36 do
+    switch_scene :loop
+  end
+
+  midi_map note: 37 do
+    switch_scene :build
+  end
+
+  midi_map note: 38 do
+    switch_scene :peak
+  end
+
+  midi_map note: 39 do
+    switch_scene :breakdown
+  end
+
+  midi_map cc: 1 do |value|
+    set :global_intensity, value / 127.0
+  end
+
+  key "1" do
+    switch_scene :loop
+  end
+
+  key "2" do
+    switch_scene :build
+  end
+
+  key "3" do
+    switch_scene :peak
+  end
+
+  key "4" do
+    switch_scene :breakdown
+  end
+
+  key "b" do
+    blackout
+  end
+
+  key "f" do
+    freeze
+  end
+end