@onjmin/dtm 1.0.1 → 1.0.3

package/dist/index.d.mts

@@ -2086,6 +2086,8 @@ type SoundFontInstance = {
         destination: AudioNode;
         pitch: number;
         volume: number;
+        /** 元ノートのvelocity(0-127)。音量ではなく音色の明るさにだけ効く。 */
+        velocity?: number;
         when: number;
         duration: number;
     }) => void;

package/dist/index.d.ts

@@ -2086,6 +2086,8 @@ type SoundFontInstance = {
         destination: AudioNode;
         pitch: number;
         volume: number;
+        /** 元ノートのvelocity(0-127)。音量ではなく音色の明るさにだけ効く。 */
+        velocity?: number;
         when: number;
         duration: number;
     }) => void;

package/dist/index.js

@@ -9916,6 +9916,45 @@ var SoundFont = class _SoundFont {
   static afterTime = 0.5;
   static fonts = /* @__PURE__ */ new Map();
   static ch = -1;
+  // ── ヒューマナイズ（疑似ラウンドロビン）──
+  // サンプルを複数持たない代わりに、発音のたびピッチと音量をごく僅かにランダムへ
+  // ブレさせて「毎回寸分違わず同じ波形」という機械的な均一さを崩す。
+  /** 発音ごとのピッチ微揺らぎ幅（セント、±この値の範囲で一様乱数）。 */
+  static humanizeDetuneCents = 4;
+  /** 発音ごとの音量微揺らぎ幅（比率、0.06 = ±6%の範囲で一様乱数）。 */
+  static humanizeGainRatio = 0.06;
+  // ── ベロシティ→明るさ連動フィルタ ──
+  // velocity は音量にしか効かず音色（明るさ）が変わらないのを補うため、
+  // ローパスのカットオフを velocity に連動させる（弱いほど丸く、強いほど明るく）。
+  // 連動元は必ず velocity であって volume ではない。volume には
+  // 「トラック音量フェーダー×velocity」が既に畳み込まれている（sequencer.ts参照）ため、
+  // volume を使うとフェーダーを下げただけで音色まで暗くなり、音量がゲインと音色へ
+  // 二重に効いてしまう。音量フェーダーは音色を変えてはならない。
+  /** velocity=0 のときのローパスカットオフ(Hz)。 */
+  static brightnessMinHz = 2400;
+  /** velocity=127 のときのローパスカットオフ(Hz)。サンプルの帯域を実質塞がない値。 */
+  static brightnessMaxHz = 2e4;
+  /** ベロシティ→明るさフィルタのQ値。共鳴が付かないButterworth特性。 */
+  static brightnessQ = Math.SQRT1_2;
+  /**
+   * この明るさ比率以上ならフィルタ自体を挿入しない。最強ベロシティの音は改修前と
+   * 完全に同一の信号経路を通り、余計な音痩せや位相変化が起きないようにするため。
+   */
+  static brightnessBypassAbove = 0.98;
+  // ── ロングトーン用ビブラート(ピッチLFO) ──
+  // 伸ばす音が完全に静止していると不自然に聞こえるため、一定長以上持続する
+  // 音符にだけ、発音直後フェードインしつつ穏やかなピッチ揺れを掛ける。
+  // 閾値・速さは歌声合成側の vibrato.ts (VIBRATO_MIN_SEC/VIBRATO_RATE_HZ) と
+  // 同じ考え方だが、MIDI楽器はここでは独立した定数として持つ
+  // （koeのCurveInput契約に縛られない汎用のWeb Audio LFOのため）。
+  /** ロングトーン判定の最短秒数。これ未満の音符にはビブラートを掛けない。 */
+  static longToneThresholdSec = 0.35;
+  /** ロングトーンビブラートの速さ(Hz)。 */
+  static vibratoRateHz = 5.5;
+  /** ロングトーンビブラートの深さ(セント)。歌声用(±35セント)より控えめ。 */
+  static vibratoDepthCents = 12;
+  /** ロングトーンビブラートのフェードイン秒数。発音直後は素直な音程を保つ。 */
+  static vibratoFadeSec = 0.2;
   static toURL(fontName) {
     return `https://surikov.github.io/webaudiofontdata/sound/${fontName}.js`;
   }
@@ -9956,6 +9995,7 @@ var SoundFont = class _SoundFont {
     destination,
     pitch = 60,
     volume = 1,
+    velocity,
     when = 0,
     duration = 1
   } = {}) {
@@ -9973,23 +10013,58 @@ var SoundFont = class _SoundFont {
     src.buffer = buffer;
     src.playbackRate.setValueAtTime(_param.playbackRate, 0);
     Object.assign(src, _param.src);
+    const humanizeCents = (Math.random() * 2 - 1) * _SoundFont.humanizeDetuneCents;
+    const humanizeGainMul = 1 + (Math.random() * 2 - 1) * _SoundFont.humanizeGainRatio;
+    src.detune.setValueAtTime(humanizeCents, 0);
+    const effectiveVolume = volume * humanizeGainMul;
+    const brightness = velocity === void 0 ? 1 : Math.max(0, Math.min(1, velocity / 127));
+    const filter = brightness >= _SoundFont.brightnessBypassAbove ? void 0 : ctx.createBiquadFilter();
+    if (filter) {
+      filter.type = "lowpass";
+      filter.frequency.setValueAtTime(
+        _SoundFont.brightnessMinHz + (_SoundFont.brightnessMaxHz - _SoundFont.brightnessMinHz) * brightness,
+        0
+      );
+      filter.Q.setValueAtTime(_SoundFont.brightnessQ, 0);
+    }
     g.gain.setValueAtTime(0, ctx.currentTime);
     const attackTime = 5e-3;
     const startGainTime = Math.max(ctx.currentTime, _when);
     g.gain.setValueAtTime(0, startGainTime);
-    g.gain.linearRampToValueAtTime(volume, startGainTime + attackTime);
+    g.gain.linearRampToValueAtTime(effectiveVolume, startGainTime + attackTime);
     const _duration = duration + _SoundFont.afterTime;
     const end = _when + (isDrum ? buffer.duration : src.loop ? _duration : Math.min(_duration, _param.max));
     if (!isDrum) {
-      g.gain.setValueAtTime(volume, startGainTime + attackTime);
+      g.gain.setValueAtTime(effectiveVolume, startGainTime + attackTime);
       g.gain.linearRampToValueAtTime(0, end);
     }
-    src.connect(g).connect(destination);
+    if (filter) src.connect(filter).connect(g);
+    else src.connect(g);
+    g.connect(destination);
+    let vibratoOsc;
+    let vibratoDepth;
+    if (!isDrum && duration >= _SoundFont.longToneThresholdSec) {
+      vibratoOsc = ctx.createOscillator();
+      vibratoOsc.type = "sine";
+      vibratoOsc.frequency.setValueAtTime(_SoundFont.vibratoRateHz, 0);
+      vibratoDepth = ctx.createGain();
+      vibratoDepth.gain.setValueAtTime(0, startGainTime);
+      vibratoDepth.gain.linearRampToValueAtTime(
+        _SoundFont.vibratoDepthCents,
+        startGainTime + _SoundFont.vibratoFadeSec
+      );
+      vibratoOsc.connect(vibratoDepth).connect(src.detune);
+      vibratoOsc.start(_when);
+      vibratoOsc.stop(end);
+    }
     src.start(_when);
     src.stop(end);
     src.onended = () => {
       src.disconnect();
+      filter?.disconnect();
       g.disconnect();
+      vibratoOsc?.disconnect();
+      vibratoDepth?.disconnect();
     };
   }
 };
@@ -11080,6 +11155,7 @@ var mountChordPlayer = (target, chords, options = {}) => {
   };
   const wafPlayDynamic = ({
     pitch,
+    velocity,
     volume,
     when,
     duration,
@@ -11093,6 +11169,7 @@ var mountChordPlayer = (target, chords, options = {}) => {
         destination,
         pitch,
         volume: volume * 0.85,
+        velocity,
         when,
         duration
       });
@@ -19551,6 +19628,7 @@ var createDtmStudio = async (options = {}) => {
         destination: getChannelStrip(e.trackId).input,
         pitch: e.pitch,
         volume: e.volume,
+        velocity: e.velocity,
         when: e.when,
         duration: e.duration
       });
@@ -19867,6 +19945,7 @@ var createDtmStudio = async (options = {}) => {
         destination: getChannelStrip(e.trackId).input,
         pitch: e.pitch,
         volume: e.volume,
+        velocity: e.velocity,
         when: e.when,
         duration: e.duration
       });
@@ -19953,6 +20032,7 @@ var createDtmStudio = async (options = {}) => {
         destination: getChannelStrip(e.trackId).input,
         pitch: e.pitch,
         volume: e.volume,
+        velocity: e.velocity,
         when: e.when,
         duration: e.duration
       });
@@ -20032,6 +20112,7 @@ var createDtmStudio = async (options = {}) => {
         destination: getChannelStrip(e.trackId).input,
         pitch: e.pitch,
         volume: e.volume,
+        velocity: e.velocity,
         when: e.when,
         duration: e.duration
       });
@@ -20071,6 +20152,7 @@ var createDtmStudio = async (options = {}) => {
       destination: getChannelStrip(e.trackId).input,
       pitch: e.pitch,
       volume: e.volume,
+      velocity: e.velocity,
       when: e.when,
       duration: e.duration
     });
@@ -20127,6 +20209,7 @@ var createDtmStudio = async (options = {}) => {
         destination: getChannelStrip("chord").input,
         pitch: e.pitch,
         volume: e.volume,
+        velocity: e.velocity,
         when: e.when,
         duration: e.duration
       });

package/dist/index.mjs

@@ -9783,6 +9783,45 @@ var SoundFont = class _SoundFont {
   static afterTime = 0.5;
   static fonts = /* @__PURE__ */ new Map();
   static ch = -1;
+  // ── ヒューマナイズ（疑似ラウンドロビン）──
+  // サンプルを複数持たない代わりに、発音のたびピッチと音量をごく僅かにランダムへ
+  // ブレさせて「毎回寸分違わず同じ波形」という機械的な均一さを崩す。
+  /** 発音ごとのピッチ微揺らぎ幅（セント、±この値の範囲で一様乱数）。 */
+  static humanizeDetuneCents = 4;
+  /** 発音ごとの音量微揺らぎ幅（比率、0.06 = ±6%の範囲で一様乱数）。 */
+  static humanizeGainRatio = 0.06;
+  // ── ベロシティ→明るさ連動フィルタ ──
+  // velocity は音量にしか効かず音色（明るさ）が変わらないのを補うため、
+  // ローパスのカットオフを velocity に連動させる（弱いほど丸く、強いほど明るく）。
+  // 連動元は必ず velocity であって volume ではない。volume には
+  // 「トラック音量フェーダー×velocity」が既に畳み込まれている（sequencer.ts参照）ため、
+  // volume を使うとフェーダーを下げただけで音色まで暗くなり、音量がゲインと音色へ
+  // 二重に効いてしまう。音量フェーダーは音色を変えてはならない。
+  /** velocity=0 のときのローパスカットオフ(Hz)。 */
+  static brightnessMinHz = 2400;
+  /** velocity=127 のときのローパスカットオフ(Hz)。サンプルの帯域を実質塞がない値。 */
+  static brightnessMaxHz = 2e4;
+  /** ベロシティ→明るさフィルタのQ値。共鳴が付かないButterworth特性。 */
+  static brightnessQ = Math.SQRT1_2;
+  /**
+   * この明るさ比率以上ならフィルタ自体を挿入しない。最強ベロシティの音は改修前と
+   * 完全に同一の信号経路を通り、余計な音痩せや位相変化が起きないようにするため。
+   */
+  static brightnessBypassAbove = 0.98;
+  // ── ロングトーン用ビブラート(ピッチLFO) ──
+  // 伸ばす音が完全に静止していると不自然に聞こえるため、一定長以上持続する
+  // 音符にだけ、発音直後フェードインしつつ穏やかなピッチ揺れを掛ける。
+  // 閾値・速さは歌声合成側の vibrato.ts (VIBRATO_MIN_SEC/VIBRATO_RATE_HZ) と
+  // 同じ考え方だが、MIDI楽器はここでは独立した定数として持つ
+  // （koeのCurveInput契約に縛られない汎用のWeb Audio LFOのため）。
+  /** ロングトーン判定の最短秒数。これ未満の音符にはビブラートを掛けない。 */
+  static longToneThresholdSec = 0.35;
+  /** ロングトーンビブラートの速さ(Hz)。 */
+  static vibratoRateHz = 5.5;
+  /** ロングトーンビブラートの深さ(セント)。歌声用(±35セント)より控えめ。 */
+  static vibratoDepthCents = 12;
+  /** ロングトーンビブラートのフェードイン秒数。発音直後は素直な音程を保つ。 */
+  static vibratoFadeSec = 0.2;
   static toURL(fontName) {
     return `https://surikov.github.io/webaudiofontdata/sound/${fontName}.js`;
   }
@@ -9823,6 +9862,7 @@ var SoundFont = class _SoundFont {
     destination,
     pitch = 60,
     volume = 1,
+    velocity,
     when = 0,
     duration = 1
   } = {}) {
@@ -9840,23 +9880,58 @@ var SoundFont = class _SoundFont {
     src.buffer = buffer;
     src.playbackRate.setValueAtTime(_param.playbackRate, 0);
     Object.assign(src, _param.src);
+    const humanizeCents = (Math.random() * 2 - 1) * _SoundFont.humanizeDetuneCents;
+    const humanizeGainMul = 1 + (Math.random() * 2 - 1) * _SoundFont.humanizeGainRatio;
+    src.detune.setValueAtTime(humanizeCents, 0);
+    const effectiveVolume = volume * humanizeGainMul;
+    const brightness = velocity === void 0 ? 1 : Math.max(0, Math.min(1, velocity / 127));
+    const filter = brightness >= _SoundFont.brightnessBypassAbove ? void 0 : ctx.createBiquadFilter();
+    if (filter) {
+      filter.type = "lowpass";
+      filter.frequency.setValueAtTime(
+        _SoundFont.brightnessMinHz + (_SoundFont.brightnessMaxHz - _SoundFont.brightnessMinHz) * brightness,
+        0
+      );
+      filter.Q.setValueAtTime(_SoundFont.brightnessQ, 0);
+    }
     g.gain.setValueAtTime(0, ctx.currentTime);
     const attackTime = 5e-3;
     const startGainTime = Math.max(ctx.currentTime, _when);
     g.gain.setValueAtTime(0, startGainTime);
-    g.gain.linearRampToValueAtTime(volume, startGainTime + attackTime);
+    g.gain.linearRampToValueAtTime(effectiveVolume, startGainTime + attackTime);
     const _duration = duration + _SoundFont.afterTime;
     const end = _when + (isDrum ? buffer.duration : src.loop ? _duration : Math.min(_duration, _param.max));
     if (!isDrum) {
-      g.gain.setValueAtTime(volume, startGainTime + attackTime);
+      g.gain.setValueAtTime(effectiveVolume, startGainTime + attackTime);
       g.gain.linearRampToValueAtTime(0, end);
     }
-    src.connect(g).connect(destination);
+    if (filter) src.connect(filter).connect(g);
+    else src.connect(g);
+    g.connect(destination);
+    let vibratoOsc;
+    let vibratoDepth;
+    if (!isDrum && duration >= _SoundFont.longToneThresholdSec) {
+      vibratoOsc = ctx.createOscillator();
+      vibratoOsc.type = "sine";
+      vibratoOsc.frequency.setValueAtTime(_SoundFont.vibratoRateHz, 0);
+      vibratoDepth = ctx.createGain();
+      vibratoDepth.gain.setValueAtTime(0, startGainTime);
+      vibratoDepth.gain.linearRampToValueAtTime(
+        _SoundFont.vibratoDepthCents,
+        startGainTime + _SoundFont.vibratoFadeSec
+      );
+      vibratoOsc.connect(vibratoDepth).connect(src.detune);
+      vibratoOsc.start(_when);
+      vibratoOsc.stop(end);
+    }
     src.start(_when);
     src.stop(end);
     src.onended = () => {
       src.disconnect();
+      filter?.disconnect();
       g.disconnect();
+      vibratoOsc?.disconnect();
+      vibratoDepth?.disconnect();
     };
   }
 };
@@ -10947,6 +11022,7 @@ var mountChordPlayer = (target, chords, options = {}) => {
   };
   const wafPlayDynamic = ({
     pitch,
+    velocity,
     volume,
     when,
     duration,
@@ -10960,6 +11036,7 @@ var mountChordPlayer = (target, chords, options = {}) => {
         destination,
         pitch,
         volume: volume * 0.85,
+        velocity,
         when,
         duration
       });
@@ -19417,6 +19494,7 @@ var createDtmStudio = async (options = {}) => {
         destination: getChannelStrip(e.trackId).input,
         pitch: e.pitch,
         volume: e.volume,
+        velocity: e.velocity,
         when: e.when,
         duration: e.duration
       });
@@ -19733,6 +19811,7 @@ var createDtmStudio = async (options = {}) => {
         destination: getChannelStrip(e.trackId).input,
         pitch: e.pitch,
         volume: e.volume,
+        velocity: e.velocity,
         when: e.when,
         duration: e.duration
       });
@@ -19819,6 +19898,7 @@ var createDtmStudio = async (options = {}) => {
         destination: getChannelStrip(e.trackId).input,
         pitch: e.pitch,
         volume: e.volume,
+        velocity: e.velocity,
         when: e.when,
         duration: e.duration
       });
@@ -19898,6 +19978,7 @@ var createDtmStudio = async (options = {}) => {
         destination: getChannelStrip(e.trackId).input,
         pitch: e.pitch,
         volume: e.volume,
+        velocity: e.velocity,
         when: e.when,
         duration: e.duration
       });
@@ -19937,6 +20018,7 @@ var createDtmStudio = async (options = {}) => {
       destination: getChannelStrip(e.trackId).input,
       pitch: e.pitch,
       volume: e.volume,
+      velocity: e.velocity,
       when: e.when,
       duration: e.duration
     });
@@ -19993,6 +20075,7 @@ var createDtmStudio = async (options = {}) => {
         destination: getChannelStrip("chord").input,
         pitch: e.pitch,
         volume: e.volume,
+        velocity: e.velocity,
         when: e.when,
         duration: e.duration
       });

package/package.json

@@ -2,7 +2,7 @@
   "author": "onjmin",
   "license": "MIT",
   "name": "@onjmin/dtm",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "MMLを中間言語に用いた、モバイルファーストなDAW / ピアノロール打ち込みコンポーネント",
   "homepage": "https://onjmin.github.io/dtm",
   "repository": {