deck2video-skill / sfx_engine.py
VanyaJ's picture
Release v3.0.0: IT톡톡 Tech-Briefing HUD + 3D Wireframe Globe + Video/Image PiP + Text Scramble + Changelog/Swarm/Staircase/Pricing Matrix + 10 SFX
135f2e5 verified
Raw History Blame Contribute Delete
11.4 kB
"""
Procedural Broadcast UI & Presentation Sound Effects (SFX) Synthesizer v2.0
Generates 8 studio-grade 48kHz 16-bit Stereo WAV files with zero external dependencies:
1. `whoosh` — Airy chapter/slide transition whoosh + warm sub-thump
2. `pop` — Linear/Apple-style glass card focus pop
3. `tick` — Precision digital counter / bar-chart roll-up ticks
4. `type` — Tactile dark terminal command typing burst
5. `highlight` — Silky shimmer sweep for quote highlighter
6. `chime` — Warm Cmaj9 glass bell chime for takeaway reveal
7. `page_flip` — Realistic crisp paper page-turn rustle for 3D Open-Book / Notebook
8. `pulse` — Soft futuristic UI lock / timeline node activation pulse
"""
from pathlib import Path
import wave
import numpy as np
SAMPLE_RATE = 48000
def _save_stereo_wav(path: Path, left: np.ndarray, right: np.ndarray, peak: float = 0.85) -> Path:
path.parent.mkdir(parents=True, exist_ok=True)
max_val = max(float(np.max(np.abs(left))), float(float(np.max(np.abs(right)))), 1e-6)
scale = peak / max_val
stereo = np.stack([left * scale, right * scale], axis=-1)
pcm = np.clip(stereo * 32767.0, -32768, 32767).astype(np.int16)
with wave.open(str(path), "wb") as wf:
wf.setnchannels(2)
wf.setsampwidth(2)
wf.setframerate(SAMPLE_RATE)
wf.writeframes(pcm.tobytes())
return path
def _one_pole_lowpass(signal: np.ndarray, cutoff_hz: np.ndarray) -> np.ndarray:
out = np.zeros_like(signal)
dt = 1.0 / SAMPLE_RATE
rc = 1.0 / (2.0 * np.pi * np.maximum(cutoff_hz, 20.0))
alpha = dt / (rc + dt)
prev = 0.0
for i in range(len(signal)):
prev = prev + alpha[i] * (signal[i] - prev)
out[i] = prev
return out
def synth_whoosh_transition(out_path: Path) -> Path:
dur = 0.56
n = int(SAMPLE_RATE * dur)
t = np.linspace(0.0, dur, n, endpoint=False)
rng = np.random.default_rng(42)
noise_l = rng.standard_normal(n)
noise_r = rng.standard_normal(n)
bell = np.sin(np.pi * (t / dur)) ** 1.6
cutoff = 180.0 + 1500.0 * bell
swept_l = _one_pole_lowpass(noise_l, cutoff) - _one_pole_lowpass(noise_l, cutoff * 0.28)
swept_r = _one_pole_lowpass(noise_r, cutoff * 1.04) - _one_pole_lowpass(noise_r, cutoff * 0.28)
env = np.sin(np.pi * (t / dur)) ** 1.8
pan_l = np.cos(0.5 * np.pi * (0.25 + 0.5 * (t / dur)))
pan_r = np.sin(0.5 * np.pi * (0.25 + 0.5 * (t / dur)))
sub_freq = 78.0 - 26.0 * (t / dur)
sub_phase = 2.0 * np.pi * np.cumsum(sub_freq) / SAMPLE_RATE
sub = np.sin(sub_phase) * np.exp(-((t - 0.22) ** 2) / (2.0 * 0.085**2)) * 0.45
left = swept_l * env * pan_l * 0.9 + sub
right = swept_r * env * pan_r * 0.9 + sub
return _save_stereo_wav(out_path, left, right, peak=0.72)
def synth_card_focus_pop(out_path: Path) -> Path:
dur = 0.22
n = int(SAMPLE_RATE * dur)
t = np.linspace(0.0, dur, n, endpoint=False)
freq = 440.0 + 280.0 * np.exp(-t * 38.0)
phase = 2.0 * np.pi * np.cumsum(freq) / SAMPLE_RATE
attack = np.minimum(t / 0.004, 1.0)
decay = np.exp(-t * 21.0)
tone = np.sin(phase) * 0.75 + np.sin(phase * 2.0 + 0.3) * 0.25 * np.exp(-t * 34.0)
shimmer_l = np.sin(2.0 * np.pi * 1320.0 * t) * np.exp(-t * 42.0) * 0.14
shimmer_r = np.sin(2.0 * np.pi * 1326.0 * t + 0.5) * np.exp(-t * 42.0) * 0.14
left = (tone + shimmer_l) * attack * decay
right = (tone + shimmer_r) * attack * decay
return _save_stereo_wav(out_path, left, right, peak=0.68)
def synth_counter_tick(out_path: Path) -> Path:
dur = 0.95
n = int(SAMPLE_RATE * dur)
left = np.zeros(n)
right = np.zeros(n)
u = np.linspace(0.0, 1.0, 13)
tick_times = 0.02 + 0.78 * (1.0 - (1.0 - u) ** 1.75)
for idx, ts in enumerate(tick_times):
start_i = int(ts * SAMPLE_RATE)
tick_len = int(0.032 * SAMPLE_RATE)
end_i = min(n, start_i + tick_len)
seg_t = np.arange(end_i - start_i) / SAMPLE_RATE
pitch = 980.0 + idx * 28.0
env = np.minimum(seg_t / 0.0015, 1.0) * np.exp(-seg_t * 135.0)
gain = 0.55 + 0.45 * (idx / max(len(tick_times) - 1, 1))
sig = (np.sin(2.0 * np.pi * pitch * seg_t) + 0.35 * np.sin(2.0 * np.pi * pitch * 2.4 * seg_t)) * env * gain
pan = 0.42 + 0.16 * (idx % 2)
left[start_i:end_i] += sig * (1.0 - pan * 0.3)
right[start_i:end_i] += sig * (0.7 + pan * 0.3)
return _save_stereo_wav(out_path, left, right, peak=0.62)
def synth_terminal_type(out_path: Path) -> Path:
dur = 1.10
n = int(SAMPLE_RATE * dur)
left = np.zeros(n)
right = np.zeros(n)
rng = np.random.default_rng(108)
key_offsets = [0.02, 0.09, 0.15, 0.23, 0.29, 0.36, 0.46, 0.53, 0.60, 0.68, 0.75, 0.84, 0.93]
for idx, ts in enumerate(key_offsets):
start_i = int(ts * SAMPLE_RATE)
klen = int(0.028 * SAMPLE_RATE)
end_i = min(n, start_i + klen)
seg_t = np.arange(end_i - start_i) / SAMPLE_RATE
click_noise = rng.standard_normal(len(seg_t)) * np.exp(-seg_t * 260.0) * 0.35
thock_freq = 310.0 + (idx % 4) * 24.0
thock = np.sin(2.0 * np.pi * thock_freq * seg_t) * np.exp(-seg_t * 145.0) * 0.65
sig = (click_noise + thock) * np.minimum(seg_t / 0.001, 1.0)
left[start_i:end_i] += sig * 0.95
right[start_i:end_i] += sig * 1.0
return _save_stereo_wav(out_path, left, right, peak=0.58)
def synth_highlighter_sweep(out_path: Path) -> Path:
dur = 0.65
n = int(SAMPLE_RATE * dur)
t = np.linspace(0.0, dur, n, endpoint=False)
rng = np.random.default_rng(77)
brush = _one_pole_lowpass(rng.standard_normal(n), np.linspace(900.0, 2400.0, n)) * 0.18
freq = np.linspace(587.33, 880.0, n)
phase = 2.0 * np.pi * np.cumsum(freq) / SAMPLE_RATE
env = np.sin(np.pi * (t / dur)) ** 1.4 * np.exp(-t * 1.8)
left = (brush + np.sin(phase) * 0.55 + np.sin(phase * 1.5) * 0.25) * env
right = (brush + np.sin(phase + 0.35) * 0.55 + np.sin(phase * 1.5 + 0.2) * 0.25) * env
return _save_stereo_wav(out_path, left, right, peak=0.56)
def synth_insight_chime(out_path: Path) -> Path:
dur = 1.25
n = int(SAMPLE_RATE * dur)
t = np.linspace(0.0, dur, n, endpoint=False)
notes = [
(523.25, 0.00, 0.42),
(659.25, 0.04, 0.34),
(783.99, 0.08, 0.30),
(987.77, 0.12, 0.22),
(1174.66, 0.16, 0.18),
]
left = np.zeros(n)
right = np.zeros(n)
for freq, delay, amp in notes:
dt = np.maximum(0.0, t - delay)
active = (t >= delay).astype(float)
env = np.minimum(dt / 0.008, 1.0) * np.exp(-dt * 3.4) * active
left += np.sin(2.0 * np.pi * freq * dt) * env * amp
right += np.sin(2.0 * np.pi * (freq * 1.0015) * dt + 0.25) * env * amp
return _save_stereo_wav(out_path, left, right, peak=0.65)
def synth_page_flip(out_path: Path) -> Path:
"""Crisp tactile paper page-turn flutter for 3D Open-Book & Notebook scenes (0.48s)."""
dur = 0.48
n = int(SAMPLE_RATE * dur)
t = np.linspace(0.0, dur, n, endpoint=False)
rng = np.random.default_rng(303)
# High-passed crisp paper friction noise + subtle page settle thud
n_l = rng.standard_normal(n)
n_r = rng.standard_normal(n)
hi_l = _one_pole_lowpass(n_l, np.linspace(4800.0, 2200.0, n)) - _one_pole_lowpass(n_l, np.full(n, 950.0))
hi_r = _one_pole_lowpass(n_r, np.linspace(5100.0, 2100.0, n)) - _one_pole_lowpass(n_r, np.full(n, 950.0))
flutter_env = (np.sin(np.pi * np.clip(t / 0.36, 0, 1)) ** 1.5) * (0.75 + 0.25 * np.sin(2.0 * np.pi * 19.0 * t))
settle = np.sin(2.0 * np.pi * 135.0 * np.maximum(0.0, t - 0.30)) * np.exp(-np.maximum(0.0, t - 0.30) * 45.0) * (t >= 0.30) * 0.28
left = hi_l * flutter_env * 0.9 + settle
right = hi_r * flutter_env * 1.0 + settle
return _save_stereo_wav(out_path, left, right, peak=0.60)
def synth_data_pulse(out_path: Path) -> Path:
"""Warm futuristic dual-harmonic pulse for Bento Grid, VS Comparison & Roadmap nodes (0.38s)."""
dur = 0.38
n = int(SAMPLE_RATE * dur)
t = np.linspace(0.0, dur, n, endpoint=False)
f1 = np.linspace(330.0, 660.0, n)
p1 = 2.0 * np.pi * np.cumsum(f1) / SAMPLE_RATE
env = np.minimum(t / 0.006, 1.0) * np.exp(-t * 11.5)
sig_l = (np.sin(p1) * 0.65 + np.sin(2.0 * np.pi * 990.0 * t) * 0.25 * np.exp(-t * 18.0)) * env
sig_r = (np.sin(p1 + 0.25) * 0.65 + np.sin(2.0 * np.pi * 994.0 * t) * 0.25 * np.exp(-t * 18.0)) * env
return _save_stereo_wav(out_path, sig_l, sig_r, peak=0.62)
def synth_scramble_decode(out_path: Path) -> Path:
"""Rapid high-tech cipher/text-scramble telemetry flutter (0.62s)."""
dur = 0.62
n = int(SAMPLE_RATE * dur)
left = np.zeros(n)
right = np.zeros(n)
rng = np.random.default_rng(512)
freqs = [1480, 1760, 1320, 1980, 1620, 2120, 1540, 1880, 2240, 1680, 2400]
for idx, f in enumerate(freqs):
ts = 0.02 + idx * 0.048
s0 = int(ts * SAMPLE_RATE)
slen = int(0.026 * SAMPLE_RATE)
s1 = min(n, s0 + slen)
st = np.arange(s1 - s0) / SAMPLE_RATE
env = np.minimum(st / 0.0015, 1.0) * np.exp(-st * 150.0)
blip = np.sin(2.0 * np.pi * f * st) * env * (0.45 + 0.35 * rng.random())
pan = 0.3 + 0.4 * (idx % 2)
left[s0:s1] += blip * (1.0 - pan * 0.35)
right[s0:s1] += blip * (0.65 + pan * 0.35)
return _save_stereo_wav(out_path, left, right, peak=0.52)
def synth_sonar_ping(out_path: Path) -> Path:
"""Deep cinematic orbital / 3D wireframe briefing ping (0.88s)."""
dur = 0.88
n = int(SAMPLE_RATE * dur)
t = np.linspace(0.0, dur, n, endpoint=False)
env = np.minimum(t / 0.005, 1.0) * np.exp(-t * 4.8)
sub_env = np.minimum(t / 0.01, 1.0) * np.exp(-t * 6.5)
ping_l = (np.sin(2.0 * np.pi * 784.0 * t) * 0.55 + np.sin(2.0 * np.pi * 1568.0 * t) * 0.18) * env
ping_r = (np.sin(2.0 * np.pi * 786.0 * t + 0.3) * 0.55 + np.sin(2.0 * np.pi * 1572.0 * t) * 0.18) * env
sub = np.sin(2.0 * np.pi * 98.0 * t) * sub_env * 0.35
return _save_stereo_wav(out_path, ping_l + sub, ping_r + sub, peak=0.58)
def ensure_sfx_pack(sfx_dir: Path) -> dict[str, Path]:
"""Generates all 10 UI presentation SFX WAVs into `sfx_dir` and returns their paths."""
sfx_dir.mkdir(parents=True, exist_ok=True)
builders = {
"whoosh": ("sfx_whoosh.wav", synth_whoosh_transition),
"pop": ("sfx_card_pop.wav", synth_card_focus_pop),
"tick": ("sfx_counter_tick.wav", synth_counter_tick),
"type": ("sfx_terminal_type.wav", synth_terminal_type),
"highlight": ("sfx_highlighter_sweep.wav", synth_highlighter_sweep),
"chime": ("sfx_insight_chime.wav", synth_insight_chime),
"page_flip": ("sfx_page_flip.wav", synth_page_flip),
"pulse": ("sfx_data_pulse.wav", synth_data_pulse),
"scramble": ("sfx_scramble_decode.wav", synth_scramble_decode),
"sonar": ("sfx_sonar_ping.wav", synth_sonar_ping),
}
out = {}
for key, (fname, fn) in builders.items():
target = sfx_dir / fname
if not target.exists() or target.stat().st_size < 1000:
fn(target)
out[key] = target
return out
if __name__ == "__main__":
out_dir = Path(__file__).resolve().parent / "assets" / "sfx"
pack = ensure_sfx_pack(out_dir)
for k, p in pack.items():
print(f"Generated SFX [{k:10s}]: {p} ({p.stat().st_size:,} bytes)")