@onjmin/dtm 1.0.2 → 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

@@ -9924,14 +9924,23 @@ var SoundFont = class _SoundFont {
   /** 発音ごとの音量微揺らぎ幅（比率、0.06 = ±6%の範囲で一様乱数）。 */
   static humanizeGainRatio = 0.06;
   // ── ベロシティ→明るさ連動フィルタ ──
-  // volume は音量にしか効かず音色（明るさ）が変わらないのを補うため、
-  // ローパスのカットオフを volume に連動させる（弱いほど丸く、強いほど明るく）。
-  /** volume=0 のときのローパスカットオフ(Hz)。 */
-  static brightnessMinHz = 1200;
-  /** volume=1 のときのローパスカットオフ(Hz)。サンプルの帯域を実質塞がない値。 */
-  static brightnessMaxHz = 18e3;
+  // 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) ──
   // 伸ばす音が完全に静止していると不自然に聞こえるため、一定長以上持続する
   // 音符にだけ、発音直後フェードインしつつ穏やかなピッチ揺れを掛ける。
@@ -9986,6 +9995,7 @@ var SoundFont = class _SoundFont {
     destination,
     pitch = 60,
     volume = 1,
+    velocity,
     when = 0,
     duration = 1
   } = {}) {
@@ -9996,7 +10006,6 @@ var SoundFont = class _SoundFont {
     const zone = zones.get(pitch);
     if (!zone) return;
     const src = ctx.createBufferSource();
-    const filter = ctx.createBiquadFilter();
     const g = ctx.createGain();
     const _when = when + ctx.currentTime;
     const { buffer, _param } = zone;
@@ -10008,13 +10017,16 @@ var SoundFont = class _SoundFont {
     const humanizeGainMul = 1 + (Math.random() * 2 - 1) * _SoundFont.humanizeGainRatio;
     src.detune.setValueAtTime(humanizeCents, 0);
     const effectiveVolume = volume * humanizeGainMul;
-    filter.type = "lowpass";
-    const brightness = Math.max(0, Math.min(1, volume));
-    filter.frequency.setValueAtTime(
-      _SoundFont.brightnessMinHz + (_SoundFont.brightnessMaxHz - _SoundFont.brightnessMinHz) * brightness,
-      0
-    );
-    filter.Q.setValueAtTime(_SoundFont.brightnessQ, 0);
+    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);
@@ -10026,7 +10038,9 @@ var SoundFont = class _SoundFont {
       g.gain.setValueAtTime(effectiveVolume, startGainTime + attackTime);
       g.gain.linearRampToValueAtTime(0, end);
     }
-    src.connect(filter).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) {
@@ -10047,7 +10061,7 @@ var SoundFont = class _SoundFont {
     src.stop(end);
     src.onended = () => {
       src.disconnect();
-      filter.disconnect();
+      filter?.disconnect();
       g.disconnect();
       vibratoOsc?.disconnect();
       vibratoDepth?.disconnect();
@@ -11141,6 +11155,7 @@ var mountChordPlayer = (target, chords, options = {}) => {
   };
   const wafPlayDynamic = ({
     pitch,
+    velocity,
     volume,
     when,
     duration,
@@ -11154,6 +11169,7 @@ var mountChordPlayer = (target, chords, options = {}) => {
         destination,
         pitch,
         volume: volume * 0.85,
+        velocity,
         when,
         duration
       });
@@ -19612,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
       });
@@ -19928,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
       });
@@ -20014,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
       });
@@ -20093,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
       });
@@ -20132,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
     });
@@ -20188,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

@@ -9791,14 +9791,23 @@ var SoundFont = class _SoundFont {
   /** 発音ごとの音量微揺らぎ幅（比率、0.06 = ±6%の範囲で一様乱数）。 */
   static humanizeGainRatio = 0.06;
   // ── ベロシティ→明るさ連動フィルタ ──
-  // volume は音量にしか効かず音色（明るさ）が変わらないのを補うため、
-  // ローパスのカットオフを volume に連動させる（弱いほど丸く、強いほど明るく）。
-  /** volume=0 のときのローパスカットオフ(Hz)。 */
-  static brightnessMinHz = 1200;
-  /** volume=1 のときのローパスカットオフ(Hz)。サンプルの帯域を実質塞がない値。 */
-  static brightnessMaxHz = 18e3;
+  // 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) ──
   // 伸ばす音が完全に静止していると不自然に聞こえるため、一定長以上持続する
   // 音符にだけ、発音直後フェードインしつつ穏やかなピッチ揺れを掛ける。
@@ -9853,6 +9862,7 @@ var SoundFont = class _SoundFont {
     destination,
     pitch = 60,
     volume = 1,
+    velocity,
     when = 0,
     duration = 1
   } = {}) {
@@ -9863,7 +9873,6 @@ var SoundFont = class _SoundFont {
     const zone = zones.get(pitch);
     if (!zone) return;
     const src = ctx.createBufferSource();
-    const filter = ctx.createBiquadFilter();
     const g = ctx.createGain();
     const _when = when + ctx.currentTime;
     const { buffer, _param } = zone;
@@ -9875,13 +9884,16 @@ var SoundFont = class _SoundFont {
     const humanizeGainMul = 1 + (Math.random() * 2 - 1) * _SoundFont.humanizeGainRatio;
     src.detune.setValueAtTime(humanizeCents, 0);
     const effectiveVolume = volume * humanizeGainMul;
-    filter.type = "lowpass";
-    const brightness = Math.max(0, Math.min(1, volume));
-    filter.frequency.setValueAtTime(
-      _SoundFont.brightnessMinHz + (_SoundFont.brightnessMaxHz - _SoundFont.brightnessMinHz) * brightness,
-      0
-    );
-    filter.Q.setValueAtTime(_SoundFont.brightnessQ, 0);
+    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);
@@ -9893,7 +9905,9 @@ var SoundFont = class _SoundFont {
       g.gain.setValueAtTime(effectiveVolume, startGainTime + attackTime);
       g.gain.linearRampToValueAtTime(0, end);
     }
-    src.connect(filter).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) {
@@ -9914,7 +9928,7 @@ var SoundFont = class _SoundFont {
     src.stop(end);
     src.onended = () => {
       src.disconnect();
-      filter.disconnect();
+      filter?.disconnect();
       g.disconnect();
       vibratoOsc?.disconnect();
       vibratoDepth?.disconnect();
@@ -11008,6 +11022,7 @@ var mountChordPlayer = (target, chords, options = {}) => {
   };
   const wafPlayDynamic = ({
     pitch,
+    velocity,
     volume,
     when,
     duration,
@@ -11021,6 +11036,7 @@ var mountChordPlayer = (target, chords, options = {}) => {
         destination,
         pitch,
         volume: volume * 0.85,
+        velocity,
         when,
         duration
       });
@@ -19478,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
       });
@@ -19794,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
       });
@@ -19880,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
       });
@@ -19959,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
       });
@@ -19998,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
     });
@@ -20054,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.2",
+  "version": "1.0.3",
   "description": "MMLを中間言語に用いた、モバイルファーストなDAW / ピアノロール打ち込みコンポーネント",
   "homepage": "https://onjmin.github.io/dtm",
   "repository": {