vizcore 0.1.0 → 1.0.0

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

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