@adatechnology/game-audio 0.1.2 → 0.2.1

package/dist/index.js

@@ -283,8 +283,8 @@ function finishModulator(pending, sourceFrequency) {
   const depth = typeof modulator.depth === "object" && "scaleOf" in modulator.depth ? sourceFrequency * modulator.depth.factor : pending.depth ?? 0;
   return { target: modulator.target, ...modulator.wave ? { wave: modulator.wave } : {}, rate: pending.rate, depth, ...modulator.base === void 0 ? {} : { base: modulator.base } };
 }
-function finishEnvelope(envelope, duration, level) {
-  return envelope.map(([time, value, curve, fixed2]) => ({ time: timeOf(time, duration), value: fixed2 === "fixed" ? value : value * level, curve }));
+function finishEnvelope(envelope2, duration, level) {
+  return envelope2.map(([time, value, curve, fixed2]) => ({ time: timeOf(time, duration), value: fixed2 === "fixed" ? value : value * level, curve }));
 }
 function planLayer(layer, scope, defaults, levelInEnvelope, soundLevel) {
   const pending = drawLayer(layer, scope);
@@ -523,6 +523,83 @@ function noiseClassRecipe(row, id = `sfx_${row.id}`) {
 }
 var GAME_SFX_BANK = { id: "game_sfx", sounds: [...GAME_SFX_CLASSES, GAME_SFX_FALLBACK].map((row) => noiseClassRecipe(row)) };
 
+// src/recipes/scene.ts
+var ATTACK = 2e-3;
+function lengthOf(d, attack) {
+  if (typeof d === "number") return attack + d;
+  if (Array.isArray(d)) return [attack + d[0], attack + d[1]];
+  return { ...d, add: (d.add ?? 0) + attack };
+}
+var envelope = (attack) => [
+  [0, 1e-4, "set", "fixed"],
+  [attack, 1, "exp"],
+  ["1d", 1e-4, "exp", "fixed"]
+];
+function sceneNoise(o) {
+  const a = o.a ?? ATTACK;
+  const over = typeof o.d === "number" ? o.d : 0;
+  return {
+    filters: {
+      mode: "serial",
+      bank: [{ type: o.type ?? "lowpass", frequency: o.f2 === void 0 ? { set: o.f } : { set: o.f, to: o.f2, curve: "exp", over }, q: o.q ?? 0.7 }]
+    },
+    duration: lengthOf(o.d, a),
+    gain: o.vol,
+    ...o.delay === void 0 ? {} : { at: o.delay },
+    ...o.wet === void 0 ? {} : { wet: o.wet },
+    source: { kind: "noise", offset: "random", offsetScale: 1.5, loop: true },
+    envelope: envelope(a)
+  };
+}
+function sceneTone(o) {
+  return {
+    source: { kind: "osc", wave: o.wave ?? "sine", frequency: { from: o.f, to: o.f2 ?? "from", curve: "exp", over: "duration" } },
+    duration: lengthOf(o.d, ATTACK),
+    gain: o.vol,
+    ...o.delay === void 0 ? {} : { at: o.delay },
+    ...o.wet === void 0 ? {} : { wet: o.wet },
+    envelope: envelope(ATTACK)
+  };
+}
+function sceneVoice(o) {
+  return {
+    duration: lengthOf(o.d, 0),
+    gain: o.vol,
+    wet: 0.45,
+    source: {
+      kind: "formant_voice",
+      wave: o.wave ?? "sawtooth",
+      frequency: { from: o.f0, to: o.f1, curve: "linear", over: "duration" },
+      vibrato: { rate: [4, 10], depth: 0.08 },
+      formants: [
+        { frequency: o.fA, q: 4 },
+        { frequency: o.fB, q: 6 }
+      ],
+      breath: { frequency: o.fB, q: 1.1, gain: o.noise },
+      mix: 3.2
+    },
+    envelope: [
+      [0, 1e-4, "set", "fixed"],
+      [0.1, 1, "exp"],
+      ["0.6d", 1, "set"],
+      ["1d", 1e-4, "exp", "fixed"]
+    ]
+  };
+}
+var sceneMany = (count, make) => Array.from({ length: count }, make);
+function sceneRecipe(id, layers, line, options = {}) {
+  return {
+    id,
+    bus: options.bus ?? "world",
+    pan: true,
+    layers,
+    falloff: DISTANCE_CURVES.art_scene,
+    ...options.vars ? { vars: options.vars } : {},
+    ...options.group ? { group: options.group } : {},
+    sources: [`cena:${line}`]
+  };
+}
+
 // src/library/crowd_rumble.json
 var crowd_rumble_default = {
   id: "crowd_rumble",
@@ -1076,10 +1153,10 @@ function realizeCalls(plan, target) {
       assign(filter.frequency, band.frequency, time);
       if (band.q !== void 0) filter.Q.value = band.q;
     }
-    const envelope = context.createGain();
-    applyEnvelope(envelope.gain, layer.envelope, time);
-    oscillator.connect(envelope);
-    envelope.connect(filter);
+    const envelope2 = context.createGain();
+    applyEnvelope(envelope2.gain, layer.envelope, time);
+    oscillator.connect(envelope2);
+    envelope2.connect(filter);
     oscillator.start(time);
     oscillator.stop(end(layer, time));
     return oscillator;
@@ -1116,12 +1193,12 @@ function realizeNoiseLayer(plan, layer, target) {
     rampTo(node.frequency, filter.frequency, time);
     return node;
   });
-  const envelope = context.createGain();
-  applyEnvelope(envelope.gain, layer.envelope, time);
+  const envelope2 = context.createGain();
+  applyEnvelope(envelope2.gain, layer.envelope, time);
   let tail = source;
   for (const filter of filters) tail = tail.connect(filter);
-  tail.connect(envelope);
-  envelope.connect(outputStage(plan, layer, target));
+  tail.connect(envelope2);
+  envelope2.connect(outputStage(plan, layer, target));
   source.start(time, layer.source.kind === "noise" ? layer.source.offset : 0);
   source.stop(end2(layer, time));
   return [source];
@@ -1135,10 +1212,10 @@ function realizeToneLayer(plan, layer, target) {
     assign(oscillator.frequency, layer.source.frequency, time);
     rampTo(oscillator.frequency, layer.source.frequency, time);
   }
-  const envelope = context.createGain();
-  applyEnvelope(envelope.gain, layer.envelope, time);
-  oscillator.connect(envelope);
-  envelope.connect(outputStage(plan, layer, target));
+  const envelope2 = context.createGain();
+  applyEnvelope(envelope2.gain, layer.envelope, time);
+  oscillator.connect(envelope2);
+  envelope2.connect(outputStage(plan, layer, target));
   oscillator.start(time);
   oscillator.stop(end2(layer, time));
   return [oscillator];
@@ -1167,10 +1244,10 @@ function realizeVoiceLayer(plan, layer, target) {
   breathBand.connect(breathLevel);
   for (const formant of formants) formant.connect(mix);
   breathLevel.connect(mix);
-  const envelope = context.createGain();
-  applyEnvelope(envelope.gain, layer.envelope, time);
-  mix.connect(envelope);
-  envelope.connect(outputStage(plan, layer, target));
+  const envelope2 = context.createGain();
+  applyEnvelope(envelope2.gain, layer.envelope, time);
+  mix.connect(envelope2);
+  envelope2.connect(outputStage(plan, layer, target));
   const stop = end2(layer, time);
   oscillator.start(time);
   vibrato.start(time);
@@ -1208,17 +1285,17 @@ function realizeSiren(plan, target) {
     return { lfo, depth, target: modulator.target };
   });
   const lfos = depths.map(({ lfo }) => lfo);
-  const envelope = context.createGain();
-  applyEnvelope(envelope.gain, layer.envelope, time);
-  for (const { depth, target: modulated } of depths) if (modulated === "gain") depth.connect(envelope.gain);
+  const envelope2 = context.createGain();
+  applyEnvelope(envelope2.gain, layer.envelope, time);
+  for (const { depth, target: modulated } of depths) if (modulated === "gain") depth.connect(envelope2.gain);
   const filters = (layer.filters?.bank ?? []).map((filter) => filterNode(context, filter, time));
   let tail = oscillator;
   for (const filter of filters) tail = tail.connect(filter);
-  tail.connect(envelope);
-  envelope.connect(target.output);
+  tail.connect(envelope2);
+  envelope2.connect(target.output);
   if (layer.wet && target.wet) {
     const send = gainNode(context, layer.wet);
-    envelope.connect(send);
+    envelope2.connect(send);
     send.connect(target.wet);
   }
   const stop = end2(layer, time);
@@ -1234,11 +1311,11 @@ function noiseLayer(layer, target, time) {
   const { context } = target;
   const source = noiseSource(target, layer.source.kind === "noise" && layer.source.loop);
   const filters = (layer.filters?.bank ?? []).map((filter) => filterNode(context, filter, time));
-  const envelope = context.createGain();
-  applyEnvelope(envelope.gain, layer.envelope, time);
+  const envelope2 = context.createGain();
+  applyEnvelope(envelope2.gain, layer.envelope, time);
   let tail = source;
   for (const filter of filters) tail = tail.connect(filter);
-  tail.connect(envelope).connect(target.output);
+  tail.connect(envelope2).connect(target.output);
   source.start(time, layer.source.kind === "noise" ? layer.source.offset : 0);
   source.stop(time + layer.duration + layer.tail);
   return source;
@@ -1251,9 +1328,9 @@ function toneLayer(layer, target, time) {
     assign(oscillator.frequency, layer.source.frequency, time);
     rampTo(oscillator.frequency, layer.source.frequency, time);
   }
-  const envelope = context.createGain();
-  applyEnvelope(envelope.gain, layer.envelope, time);
-  oscillator.connect(envelope).connect(target.output);
+  const envelope2 = context.createGain();
+  applyEnvelope(envelope2.gain, layer.envelope, time);
+  oscillator.connect(envelope2).connect(target.output);
   oscillator.start(time);
   oscillator.stop(time + layer.duration + layer.tail);
   return oscillator;
@@ -1810,8 +1887,8 @@ function createAudioTestModule(options = {}) {
     const layers2 = planned.layers.map((layer, index) => {
       const source = layer.source.kind === "noise" ? `noise@${layer.source.offset.toFixed(4)}` : layer.source.kind === "osc" ? `${layer.source.wave}@${layer.source.frequency.value ?? layer.source.frequency.from}` : layer.source.kind;
       const filters = (layer.filters?.bank ?? []).map((filter) => `${filter.type}@${(filter.frequency.value ?? filter.frequency.from ?? 0).toFixed(1)}`).join(" ");
-      const envelope = layer.envelope.map((point) => `${point.time.toFixed(3)}:${point.value.toPrecision(3)}`).join(" ");
-      return `  ${text.sheet.layer} ${index + 1}: ${source} at ${layer.at.toFixed(3)} for ${layer.duration.toFixed(3)} ${filters} [${envelope}]`;
+      const envelope2 = layer.envelope.map((point) => `${point.time.toFixed(3)}:${point.value.toPrecision(3)}`).join(" ");
+      return `  ${text.sheet.layer} ${index + 1}: ${source} at ${layer.at.toFixed(3)} for ${layer.duration.toFixed(3)} ${filters} [${envelope2}]`;
     });
     return [head, ...layers2].join("\n");
   };
@@ -2057,6 +2134,11 @@ export {
   planSound,
   realize,
   resolveMix,
+  sceneMany,
+  sceneNoise,
+  sceneRecipe,
+  sceneTone,
+  sceneVoice,
   streamFor,
   streamSeed,
   unlockContext