vizcore 0.1.0 → 1.1.0

data/examples/vj_festival_mainstage.yml

@@ -0,0 +1,17 @@
+# Example manifest for the festival mainstage set.
+#
+# Start with:
+#   vizcore start examples/vj_festival_mainstage.yml
+#
+# A writable control preset can be attached when you want HUD reactivity and
+# MIDI Learn bindings to round-trip with "Save Project":
+#
+# control_preset: assets/vj_festival_mainstage_controls.json
+scene: vj_festival_mainstage.rb
+audio_source: file
+audio_file: assets/complex_demo_loop.wav
+
+profiles:
+  mic:
+    audio_source: mic
+    audio_file:

data/examples/vj_glitch_industrial.rb

@@ -0,0 +1,164 @@
+# frozen_string_literal: true
+
+# vj_glitch_industrial.rb
+#
+# Genre   : Glitch / Industrial / Noise
+# BPM     : n/a
+# Duration: scan, tear, white_out
+# Audio   : --audio-source mic
+#           --audio-source file --audio-file examples/assets/complex_demo_loop.wav
+# Keys    : 1 scan, 2 tear, X white_out, B blackout, F freeze
+# MIDI    : note 36..38 = scenes, note 41 = white_out, CC 1 = global intensity
+Vizcore.define do
+  set :global_intensity, 0.84
+  audio_normalize mode: :adaptive, window: 2.0, target: 0.88, floor: 0.02
+
+  theme :factory_noise do
+    palette "#f8fafc", "#71717a", "#ef4444", "#111827"
+    background "#000000"
+  end
+
+  style :abrasive do
+    blend :difference
+    opacity 0.74
+  end
+
+  scene :scan do
+    use_theme :factory_noise
+
+    layer :scanner_waterfall do
+      type :spectrogram
+      scroll :vertical
+      bins 128
+      history 90
+      gain 0.9
+      use_style :abrasive
+      effect :glitch
+      effect_intensity 0.18
+      map amplitude, to: :opacity, gain: 0.9, range: 0.36..0.92, curve: :sqrt
+      map onset(:high), to: :effect_intensity, gain: 2.4, range: 0.12..0.94, attack: 1.0, release: 0.04
+      map fft_spectrum => :deform
+    end
+
+    layer :scanline_text do
+      type :text
+      content "SCAN"
+      font_size 76
+      color "#f8fafc"
+      blend :multiply
+      shadow color: "#ef4444", blur: 10
+      glow_strength 0.08
+      map high, to: :glow_strength, gain: 2.6, range: 0.06..0.7
+      map beat_pulse, to: :letter_spacing, gain: 18.0, min: 0.0, max: 22.0
+      map fft_spectrum => :deform
+    end
+  end
+
+  scene :tear do
+    use_theme :factory_noise
+
+    layer :feedback_tear do
+      shader :liquid_wobble
+      opacity 0.86
+      blend :difference
+      effect :feedback
+      effect_intensity 0.28
+      wobble 0.54
+      warp 1.1
+      map amplitude, to: :wobble, gain: 3.2, range: 0.28..1.8, curve: :sqrt
+      map onset(:high), to: :effect_intensity, gain: 2.2, range: 0.18..1.0, attack: 1.0, release: 0.05
+      map fft_spectrum => :deform
+    end
+
+    layer :tear_mesh do
+      type :mesh
+      geometry :octahedron
+      material :wireframe
+      scale 0.9
+      deform 0.36
+      blend :multiply
+      map low, to: :scale, gain: 0.8, range: 0.75..1.42
+      map beat_confidence, to: :deform, gain: 1.3, range: 0.22..1.0
+      map fft_spectrum => :color_shift
+    end
+  end
+
+  scene :white_out do
+    use_theme :factory_noise
+
+    layer :white_flash do
+      shader :glitch_flash
+      opacity 0.94
+      blend :add
+      effect :crt
+      effect_intensity 0.42
+      map amplitude, to: :opacity, gain: 1.2, range: 0.52..1.0, curve: :sqrt
+      map onset(:high), to: :effect_intensity, gain: 3.0, range: 0.22..1.0, attack: 1.0, release: 0.03
+      map fft_spectrum => :deform
+    end
+
+    layer :warning_text do
+      type :text
+      content "WHITE OUT"
+      font_size 96
+      color "#000000"
+      blend :difference
+      glow_strength 0.48
+      map mid, to: :glow_strength, gain: 2.5, range: 0.28..1.0
+      map beat_pulse, to: :font_size, gain: 26.0, min: 90.0, max: 132.0
+      map fft_spectrum => :deform
+    end
+  end
+
+  transition from: :scan, to: :tear do
+    trigger { seconds >= 36 || beat_count >= 32 }
+    effect :crossfade, duration: 0.35
+  end
+
+  transition from: :tear, to: :scan do
+    trigger { seconds >= 48 || beat_count >= 48 }
+    effect :flash, duration: 0.18
+  end
+
+  midi :controller, device: :default
+
+  midi_map note: 36 do
+    switch_scene :scan
+  end
+
+  midi_map note: 37 do
+    switch_scene :tear
+  end
+
+  midi_map note: 38 do
+    switch_scene :white_out
+  end
+
+  midi_map note: 41 do
+    switch_scene :white_out
+  end
+
+  midi_map cc: 1 do |value|
+    set :global_intensity, value / 127.0
+  end
+
+  key "1" do
+    switch_scene :scan
+  end
+
+  key "2" do
+    switch_scene :tear
+  end
+
+  key "x" do
+    switch_scene :white_out
+  end
+
+  key "b" do
+    blackout
+  end
+
+  key "f" do
+    freeze
+  end
+end

data/examples/vj_hiphop_cipher.rb

@@ -0,0 +1,167 @@
+# frozen_string_literal: true
+
+# vj_hiphop_cipher.rb
+#
+# Genre   : HipHop / Cipher
+# BPM     : 85-100
+# Duration: performer-friendly intro, verse, hook
+# Audio   : --audio-source mic
+#           --audio-source file --audio-file examples/assets/complex_demo_loop.wav
+# Keys    : 1 intro, V verse, H hook, B blackout, F freeze, Space tap-tempo
+# MIDI    : note 36..38 = scenes, CC 1 = global intensity
+Vizcore.define do
+  set :global_intensity, 0.78
+  audio_normalize mode: :adaptive, window: 3.5, target: 0.78, floor: 0.05
+  bpm 92
+  tap_tempo key: :space
+
+  theme :cipher_blacktop do
+    palette "#0f172a", "#f8fafc", "#facc15", "#ef4444"
+    background "#020617"
+  end
+
+  style :stage_text do
+    blend :screen
+    opacity 0.88
+  end
+
+  scene :intro do
+    use_theme :cipher_blacktop
+
+    layer :mic_check_title do
+      type :text
+      content "MIC CHECK"
+      font "Inter"
+      font_size 92
+      align :center
+      color "#f8fafc"
+      stroke width: 2, color: "#020617"
+      shadow color: "#facc15", blur: 18
+      glow_strength 0.18
+      use_style :stage_text
+      map amplitude, to: :glow_strength, gain: 1.3, range: 0.14..0.72, curve: :sqrt
+      map beat_pulse, to: :letter_spacing, gain: 10.0, min: 0.0, max: 14.0
+      map fft_spectrum => :deform
+    end
+
+    layer :intro_pulse do
+      type :radial_blob
+      opacity 0.34
+      blend :add
+      radius 0.34
+      wobble 0.12
+      map low, to: :radius, gain: 0.4, range: 0.3..0.68
+      map kick, to: :wobble, gain: 0.8, range: 0.08..0.52, attack: 1.0, release: 0.12
+      map fft_spectrum => :deform
+    end
+  end
+
+  scene :verse do
+    use_theme :cipher_blacktop
+
+    layer :quiet_backline do
+      type :waveform
+      source :audio
+      style :ribbon
+      height 0.12
+      opacity 0.36
+      blend :screen
+      map amplitude, to: :height, gain: 0.8, range: 0.08..0.28, curve: :sqrt, release: 0.34
+      map beat_pulse, to: :opacity, range: 0.28..0.52, attack: 1.0, release: 0.18
+      map fft_spectrum => :deform
+    end
+
+    layer :cipher_dots do
+      type :shape
+      opacity 0.42
+      blend :add
+      circle x: 240, y: 520, radius: 22, count: 3 do
+        stroke 2
+        map mid, to: :radius, gain: 36.0, min: 18.0, max: 56.0
+        map beat_pulse, to: :stroke, gain: 4.0, min: 1.0, max: 6.0
+      end
+      circle x: 1040, y: 180, radius: 18, count: 2 do
+        stroke 2
+        map fft_spectrum => :radius
+      end
+    end
+  end
+
+  scene :hook do
+    use_theme :cipher_blacktop
+
+    layer :hook_color do
+      shader :gradient_pulse
+      blend :screen
+      opacity 0.86
+      effect :bloom
+      effect_intensity 0.24
+      map amplitude, to: :effect_intensity, gain: 1.2, range: 0.18..0.72, curve: :sqrt
+      map beat_pulse, to: :pulse, range: 0.1..1.0, attack: 1.0, release: 0.14
+      map fft_spectrum => :deform
+    end
+
+    layer :hook_text do
+      type :text
+      content "HOOK"
+      font "Inter"
+      font_size 116
+      align :center
+      color "#facc15"
+      shadow color: "#ef4444", blur: 24
+      glow_strength 0.32
+      blend :add
+      map high, to: :glow_strength, gain: 2.0, range: 0.24..1.0
+      map beat_pulse, to: :font_size, gain: 32.0, min: 104.0, max: 140.0
+      map fft_spectrum => :deform
+    end
+  end
+
+  transition from: :intro, to: :verse do
+    trigger { beat_count >= 16 || frame_count >= 240 }
+    effect :crossfade, duration: 0.7
+  end
+
+  transition from: :verse, to: :hook do
+    trigger { beat_count >= 48 || frame_count >= 720 }
+    effect :flash, duration: 0.2
+  end
+
+  midi :controller, device: :default
+
+  midi_map note: 36 do
+    switch_scene :intro
+  end
+
+  midi_map note: 37 do
+    switch_scene :verse
+  end
+
+  midi_map note: 38 do
+    switch_scene :hook
+  end
+
+  midi_map cc: 1 do |value|
+    set :global_intensity, value / 127.0
+  end
+
+  key "1" do
+    switch_scene :intro
+  end
+
+  key "v" do
+    switch_scene :verse
+  end
+
+  key "h" do
+    switch_scene :hook
+  end
+
+  key "b" do
+    blackout
+  end
+
+  key "f" do
+    freeze
+  end
+end

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