@marmooo/midy 0.0.9 → 0.1.1

package/esm/midy-GM2.js

@@ -64,12 +64,6 @@ export class MidyGM2 {
             writable: true,
             value: 0
         });
-        Object.defineProperty(this, "reverbFactor", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: 0.1
-        });
         Object.defineProperty(this, "masterFineTuning", {
             enumerable: true,
             configurable: true,
@@ -82,6 +76,27 @@ export class MidyGM2 {
             writable: true,
             value: 0
         }); // cb
+        Object.defineProperty(this, "reverb", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: {
+                time: this.getReverbTime(64),
+                feedback: 0.25,
+            }
+        });
+        Object.defineProperty(this, "chorus", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: {
+                modRate: this.getChorusModRate(3),
+                modDepth: this.getChorusModDepth(19),
+                feedback: this.getChorusFeedback(8),
+                sendToReverb: this.getChorusSendToReverb(0),
+                delayTimes: this.generateDistributedArray(0.02, 2, 0.5),
+            }
+        });
         Object.defineProperty(this, "mono", {
             enumerable: true,
             configurable: true,
@@ -190,8 +205,19 @@ export class MidyGM2 {
             writable: true,
             value: {
                 reverbAlgorithm: (audioContext) => {
-                    // return this.createConvolutionReverb(audioContext);
-                    return this.createSchroederReverb(audioContext);
+                    const { time: rt60, feedback } = this.reverb;
+                    // const delay = this.calcDelay(rt60, feedback);
+                    // const impulse = this.createConvolutionReverbImpulse(
+                    //   audioContext,
+                    //   rt60,
+                    //   delay,
+                    // );
+                    // return this.createConvolutionReverb(audioContext, impulse);
+                    const combFeedbacks = this.generateDistributedArray(feedback, 4);
+                    const combDelays = combFeedbacks.map((feedback) => this.calcDelay(rt60, feedback));
+                    const allpassFeedbacks = this.generateDistributedArray(feedback, 4);
+                    const allpassDelays = allpassFeedbacks.map((feedback) => this.calcDelay(rt60, feedback));
+                    return this.createSchroederReverb(audioContext, combFeedbacks, combDelays, allpassFeedbacks, allpassDelays);
                 },
             }
         });
@@ -590,12 +616,7 @@ export class MidyGM2 {
         }
         return noteList[0];
     }
-    createConvolutionReverb(audioContext, options = {}) {
-        const { decay = 0.8, preDecay = 0, } = options;
-        const input = new GainNode(audioContext);
-        const output = new GainNode(audioContext);
-        const dryGain = new GainNode(audioContext);
-        const wetGain = new GainNode(audioContext);
+    createConvolutionReverbImpulse(audioContext, decay, preDecay) {
         const sampleRate = audioContext.sampleRate;
         const length = sampleRate * decay;
         const impulse = new AudioBuffer({
@@ -615,18 +636,17 @@ export class MidyGM2 {
                 channelData[i] = (Math.random() * 2 - 1) * attenuation;
             }
         }
+        return impulse;
+    }
+    createConvolutionReverb(audioContext, impulse) {
+        const output = new GainNode(audioContext);
         const convolverNode = new ConvolverNode(audioContext, {
             buffer: impulse,
         });
-        input.connect(convolverNode);
-        convolverNode.connect(wetGain);
-        wetGain.connect(output);
-        dryGain.connect(output);
+        convolverNode.connect(output);
         return {
-            input,
+            input: convolverNode,
             output,
-            dryGain,
-            wetGain,
             convolverNode,
         };
     }
@@ -654,17 +674,22 @@ export class MidyGM2 {
         delayNode.connect(passGain);
         return passGain;
     }
+    generateDistributedArray(center, count, varianceRatio = 0.1, randomness = 0.05) {
+        const variance = center * varianceRatio;
+        const array = new Array(count);
+        for (let i = 0; i < count; i++) {
+            const fraction = i / (count - 1 || 1);
+            const value = center - variance + fraction * 2 * variance;
+            array[i] = value * (1 - (Math.random() * 2 - 1) * randomness);
+        }
+        return array;
+    }
     // https://hajim.rochester.edu/ece/sites/zduan/teaching/ece472/reading/Schroeder_1962.pdf
     //   M.R.Schroeder, "Natural Sounding Artificial Reverberation", J.Audio Eng. Soc., vol.10, p.219, 1962
-    createSchroederReverb(audioContext, options = {}) {
-        const { combDelays = [0.31, 0.34, 0.37, 0.40], combFeedbacks = [0.86, 0.87, 0.88, 0.89], allpassDelays = [0.02, 0.05], allpassFeedbacks = [0.7, 0.7], mix = 0.5, } = options;
+    createSchroederReverb(audioContext, combDelays, combFeedbacks, allpassDelays, allpassFeedbacks) {
         const input = new GainNode(audioContext);
         const output = new GainNode(audioContext);
-        const mergerGain = new GainNode(audioContext, {
-            gain: 1 / (combDelays.length * 2),
-        });
-        const dryGain = new GainNode(audioContext, { gain: 1 - mix });
-        const wetGain = new GainNode(audioContext, { gain: mix });
+        const mergerGain = new GainNode(audioContext);
         for (let i = 0; i < combDelays.length; i++) {
             const comb = this.createCombFilter(audioContext, input, combDelays[i], combFeedbacks[i]);
             comb.connect(mergerGain);
@@ -674,68 +699,65 @@ export class MidyGM2 {
             const allpass = this.createAllpassFilter(audioContext, (i === 0) ? mergerGain : allpasses.at(-1), allpassDelays[i], allpassFeedbacks[i]);
             allpasses.push(allpass);
         }
-        allpasses.at(-1).connect(wetGain);
-        input.connect(dryGain);
-        dryGain.connect(output);
-        wetGain.connect(output);
-        return { input, output, dryGain, wetGain };
-    }
-    createChorusEffect(audioContext, options = {}) {
-        const { chorusCount = 2, chorusRate = 0.6, chorusDepth = 0.15, delay = 0.01, variance = delay * 0.1, } = options;
-        const lfo = new OscillatorNode(audioContext, { frequency: chorusRate });
-        const lfoGain = new GainNode(audioContext, { gain: chorusDepth });
+        allpasses.at(-1).connect(output);
+        return { input, output };
+    }
+    createChorusEffect(audioContext) {
+        const input = new GainNode(audioContext);
         const output = new GainNode(audioContext);
-        const chorusGains = [];
+        const sendGain = new GainNode(audioContext);
+        const lfo = new OscillatorNode(audioContext, {
+            frequency: this.chorus.modRate,
+        });
+        const lfoGain = new GainNode(audioContext, {
+            gain: this.chorus.modDepth / 2,
+        });
+        const delayTimes = this.chorus.delayTimes;
         const delayNodes = [];
-        const baseGain = 1 / chorusCount;
-        for (let i = 0; i < chorusCount; i++) {
-            const randomDelayFactor = (Math.random() - 0.5) * variance;
-            const delayTime = (i + 1) * delay + randomDelayFactor;
+        const feedbackGains = [];
+        for (let i = 0; i < delayTimes.length; i++) {
+            const delayTime = delayTimes[i];
             const delayNode = new DelayNode(audioContext, {
-                maxDelayTime: delayTime,
+                maxDelayTime: 0.1, // generally, 5ms < delayTime < 50ms
+                delayTime,
+            });
+            const feedbackGain = new GainNode(audioContext, {
+                gain: this.chorus.feedback,
             });
-            const chorusGain = new GainNode(audioContext, { gain: baseGain });
             delayNodes.push(delayNode);
-            chorusGains.push(chorusGain);
+            feedbackGains.push(feedbackGain);
+            input.connect(delayNode);
             lfoGain.connect(delayNode.delayTime);
-            delayNode.connect(chorusGain);
-            chorusGain.connect(output);
+            delayNode.connect(feedbackGain);
+            feedbackGain.connect(delayNode);
+            delayNode.connect(output);
         }
+        output.connect(sendGain);
         lfo.connect(lfoGain);
         lfo.start();
         return {
+            input,
+            output,
+            sendGain,
             lfo,
             lfoGain,
             delayNodes,
-            chorusGains,
-            output,
+            feedbackGains,
         };
     }
     connectEffects(channel, gainNode) {
         gainNode.connect(channel.merger);
-        if (channel.reverb === 0) {
-            if (channel.chorus === 0) { // no effect
-                channel.merger.connect(this.masterGain);
-            }
-            else { // chorus
-                channel.chorusEffect.delayNodes.forEach((delayNode) => {
-                    channel.merger.connect(delayNode);
-                });
-                channel.chorusEffect.output.connect(this.masterGain);
-            }
+        channel.merger.connect(this.masterGain);
+        if (0 < channel.reverbSendLevel) {
+            channel.merger.connect(channel.reverbEffect.input);
+            channel.reverbEffect.output.connect(this.masterGain);
         }
-        else {
-            if (channel.chorus === 0) { // reverb
-                channel.merger.connect(channel.reverbEffect.input);
-                channel.reverbEffect.output.connect(this.masterGain);
-            }
-            else { // reverb + chorus
-                channel.chorusEffect.delayNodes.forEach((delayNode) => {
-                    channel.merger.connect(delayNode);
-                });
-                channel.merger.connect(channel.reverbEffect.input);
-                channel.reverbEffect.output.connect(this.masterGain);
-            }
+        if (0 < channel.chorusSendLevel) {
+            channel.merger.connect(channel.chorusEffect.input);
+            channel.reverbEffect.output.connect(this.masterGain);
+        }
+        if (0 < this.chorus.sendToReverb) {
+            channel.chorusEffect.sendGain.connect(channel.reverbEffect.input);
         }
     }
     cbToRatio(cb) {
@@ -1136,23 +1158,25 @@ export class MidyGM2 {
             this.releaseSustainPedal(channelNumber, value);
         }
     }
+    // TODO
     setPortamento(channelNumber, value) {
         this.channels[channelNumber].portamento = value >= 64;
     }
-    setReverbSendLevel(channelNumber, reverb) {
+    setReverbSendLevel(channelNumber, reverbSendLevel) {
         const now = this.audioContext.currentTime;
         const channel = this.channels[channelNumber];
         const reverbEffect = channel.reverbEffect;
-        channel.reverb = reverb / 127 * this.reverbFactor;
-        reverbEffect.dryGain.gain.cancelScheduledValues(now);
-        reverbEffect.dryGain.gain.setValueAtTime(1 - channel.reverb, now);
-        reverbEffect.wetGain.gain.cancelScheduledValues(now);
-        reverbEffect.wetGain.gain.setValueAtTime(channel.reverb, now);
+        channel.reverbSendLevel = reverbSendLevel / 127;
+        reverbEffect.output.gain.cancelScheduledValues(now);
+        reverbEffect.output.gain.setValueAtTime(channel.reverbSendLevel, now);
     }
-    setChorusSendLevel(channelNumber, chorus) {
+    setChorusSendLevel(channelNumber, chorusSendLevel) {
+        const now = this.audioContext.currentTime;
         const channel = this.channels[channelNumber];
-        channel.chorus = chorus / 127;
-        channel.chorusEffect.lfoGain = channel.chorus;
+        const chorusEffect = channel.chorusEffect;
+        channel.chorusSendLevel = chorusSendLevel / 127;
+        chorusEffect.output.gain.cancelScheduledValues(now);
+        chorusEffect.output.gain.setValueAtTime(channel.chorusSendLevel, now);
     }
     setSostenutoPedal(channelNumber, value) {
         const isOn = value >= 64;
@@ -1348,11 +1372,11 @@ export class MidyGM2 {
                         this.GM2SystemOn();
                         break;
                     default:
-                        console.warn(`Unsupported Exclusive Message ${data}`);
+                        console.warn(`Unsupported Exclusive Message: ${data}`);
                 }
                 break;
             default:
-                console.warn(`Unsupported Exclusive Message ${data}`);
+                console.warn(`Unsupported Exclusive Message: ${data}`);
         }
     }
     GM1SystemOn() {
@@ -1383,9 +1407,10 @@ export class MidyGM2 {
                         return this.handleMasterFineTuningSysEx(data);
                     case 4: // https://amei.or.jp/midistandardcommittee/Recommended_Practice/e/ca25.pdf
                         return this.handleMasterCoarseTuningSysEx(data);
-                    // case 5: // TODO: Global Parameter Control
+                    case 5:
+                        return this.handleGlobalParameterControlSysEx(data);
                     default:
-                        console.warn(`Unsupported Exclusive Message ${data}`);
+                        console.warn(`Unsupported Exclusive Message: ${data}`);
                 }
                 break;
             case 8:
@@ -1394,7 +1419,7 @@ export class MidyGM2 {
                     //   // TODO
                     //   return this.handleScaleOctaveTuning1ByteFormat();
                     default:
-                        console.warn(`Unsupported Exclusive Message ${data}`);
+                        console.warn(`Unsupported Exclusive Message: ${data}`);
                 }
                 break;
             case 9:
@@ -1406,7 +1431,7 @@ export class MidyGM2 {
                     //   // TODO
                     //   return this.setControlChange();
                     default:
-                        console.warn(`Unsupported Exclusive Message ${data}`);
+                        console.warn(`Unsupported Exclusive Message: ${data}`);
                 }
                 break;
             case 10:
@@ -1415,11 +1440,11 @@ export class MidyGM2 {
                     //   // TODO
                     //   return this.handleKeyBasedInstrumentControl();
                     default:
-                        console.warn(`Unsupported Exclusive Message ${data}`);
+                        console.warn(`Unsupported Exclusive Message: ${data}`);
                 }
                 break;
             default:
-                console.warn(`Unsupported Exclusive Message ${data}`);
+                console.warn(`Unsupported Exclusive Message: ${data}`);
         }
     }
     handleMasterVolumeSysEx(data) {
@@ -1460,8 +1485,192 @@ export class MidyGM2 {
             this.masterCoarseTuning = coarseTuning - 64;
         }
     }
+    handleGlobalParameterControlSysEx(data) {
+        if (data[7] === 1) {
+            switch (data[8]) {
+                case 1:
+                    return this.handleReverbParameterSysEx(data);
+                case 2:
+                    return this.handleChorusParameterSysEx(data);
+                default:
+                    console.warn(`Unsupported Global Parameter Control Message: ${data}`);
+            }
+        }
+        else {
+            console.warn(`Unsupported Global Parameter Control Message: ${data}`);
+        }
+    }
+    handleReverbParameterSysEx(data) {
+        switch (data[9]) {
+            case 0:
+                return this.setReverbType(data[10]);
+            case 1:
+                return this.setReverbTime(data[10]);
+        }
+    }
+    setReverbType(type) {
+        this.reverb.time = this.getReverbTimeFromType(type);
+        this.reverb.feedback = (type === 8) ? 0.1 : 0.2;
+        const { audioContext, channels, options } = this;
+        for (let i = 0; i < channels.length; i++) {
+            channels[i].reverbEffect = options.reverbAlgorithm(audioContext);
+        }
+    }
+    getReverbTimeFromType(type) {
+        switch (type) {
+            case 0:
+                return this.getReverbTime(44);
+            case 1:
+                return this.getReverbTime(50);
+            case 2:
+                return this.getReverbTime(56);
+            case 3:
+                return this.getReverbTime(64);
+            case 4:
+                return this.getReverbTime(64);
+            case 8:
+                return this.getReverbTime(50);
+            default:
+                console.warn(`Unsupported Reverb Time: ${type}`);
+        }
+    }
+    setReverbTime(value) {
+        this.reverb.time = this.getReverbTime(value);
+        const { audioContext, channels, options } = this;
+        for (let i = 0; i < channels.length; i++) {
+            channels[i].reverbEffect = options.reverbAlgorithm(audioContext);
+        }
+    }
+    getReverbTime(value) {
+        return Math.pow(Math.E, (value - 40) * 0.025);
+    }
+    // mean free path equation
+    //   https://repository.dl.itc.u-tokyo.ac.jp/record/8550/files/A31912.pdf
+    //     江田和司, 拡散性制御に基づく室内音響設計に向けた音場解析に関する研究, 2015
+    //   V: room size (m^3)
+    //   S: room surface area (m^2)
+    //   meanFreePath = 4V / S (m)
+    // delay estimation using mean free path
+    //   t: degree Celsius, generally used 20
+    //   c: speed of sound = 331.5 + 0.61t = 331.5 * 0.61 * 20 = 343.7 (m/s)
+    //   delay = meanFreePath / c (s)
+    // feedback equation
+    //   RT60 means that the energy is reduced to Math.pow(10, -6).
+    //   Since energy is proportional to the square of the amplitude,
+    //   the amplitude is reduced to Math.pow(10, -3).
+    //   When this is done through n feedbacks,
+    //   Math.pow(feedback, n) = Math.pow(10, -3)
+    //   Math.pow(feedback, RT60 / delay) = Math.pow(10, -3)
+    //   RT60 / delay * Math.log10(feedback) = -3
+    //   RT60 = -3 * delay / Math.log10(feedback)
+    //   feedback = Math.pow(10, -3 * delay / RT60)
+    // delay estimation using ideal feedback
+    //   The structure of a concert hall is complex,
+    //   so estimates based on mean free path are unstable.
+    //   It is easier to determine the delay based on ideal feedback.
+    //   The average sound absorption coefficient
+    //   suitable for playing musical instruments is 0.18 to 0.28.
+    //   delay = -RT60 * Math.log10(feedback) / 3
+    calcDelay(rt60, feedback) {
+        return -rt60 * Math.log10(feedback) / 3;
+    }
+    handleChorusParameterSysEx(data) {
+        switch (data[9]) {
+            case 0:
+                return this.setChorusType(data[10]);
+            case 1:
+                return this.setChorusModRate(data[10]);
+            case 2:
+                return this.setChorusModDepth(data[10]);
+            case 3:
+                return this.setChorusFeedback(data[10]);
+            case 4:
+                return this.setChorusSendToReverb(data[10]);
+        }
+    }
+    setChorusType(type) {
+        switch (type) {
+            case 0:
+                return this.setChorusParameter(3, 5, 0, 0);
+            case 1:
+                return this.setChorusParameter(9, 19, 5, 0);
+            case 2:
+                return this.setChorusParameter(3, 19, 8, 0);
+            case 3:
+                return this.setChorusParameter(9, 16, 16, 0);
+            case 4:
+                return this.setChorusParameter(2, 24, 64, 0);
+            case 5:
+                return this.setChorusParameter(1, 5, 112, 0);
+            default:
+                console.warn(`Unsupported Chorus Type: ${type}`);
+        }
+    }
+    setChorusParameter(modRate, modDepth, feedback, sendToReverb) {
+        this.setChorusModRate(modRate);
+        this.setChorusModDepth(modDepth);
+        this.setChorusFeedback(feedback);
+        this.setChorusSendToReverb(sendToReverb);
+    }
+    setChorusModRate(value) {
+        const now = this.audioContext.currentTime;
+        const modRate = this.getChorusModRate(value);
+        this.chorus.modRate = modRate;
+        for (let i = 0; i < this.channels.length; i++) {
+            const lfo = this.channels[i].chorusEffect.lfo;
+            lfo.frequency.setValueAtTime(modRate, now);
+        }
+    }
+    getChorusModRate(value) {
+        return value * 0.122; // Hz
+    }
+    setChorusModDepth(value) {
+        const now = this.audioContext.currentTime;
+        const modDepth = this.getChorusModDepth(value);
+        this.chorus.modDepth = modDepth;
+        for (let i = 0; i < this.channels.length; i++) {
+            const chorusEffect = this.channels[i].chorusEffect;
+            chorusEffect.lfoGain.gain
+                .cancelScheduledValues(now)
+                .setValueAtTime(modDepth / 2, now);
+        }
+    }
+    getChorusModDepth(value) {
+        return (value + 1) / 3200; // second
+    }
+    setChorusFeedback(value) {
+        const now = this.audioContext.currentTime;
+        const feedback = this.getChorusFeedback(value);
+        this.chorus.feedback = feedback;
+        for (let i = 0; i < this.channels.length; i++) {
+            const chorusEffect = this.channels[i].chorusEffect;
+            for (let j = 0; j < chorusEffect.feedbackGains.length; j++) {
+                const feedbackGain = chorusEffect.feedbackGains[j];
+                feedbackGain.gain
+                    .cancelScheduledValues(now)
+                    .setValueAtTime(feedback, now);
+            }
+        }
+    }
+    getChorusFeedback(value) {
+        return value * 0.00763;
+    }
+    setChorusSendToReverb(value) {
+        const now = this.audioContext.currentTime;
+        const sendToReverb = this.getChorusSendToReverb(value);
+        this.chorus.sendToReverb = sendToReverb;
+        for (let i = 0; i < this.channels.length; i++) {
+            const chorusEffect = this.channels[i].chorusEffect;
+            chorusEffect.sendGain.gain
+                .cancelScheduledValues(now)
+                .setValueAtTime(sendToReverb, now);
+        }
+    }
+    getChorusSendToReverb(value) {
+        return value * 0.00787;
+    }
     handleExclusiveMessage(data) {
-        console.warn(`Unsupported Exclusive Message ${data}`);
+        console.warn(`Unsupported Exclusive Message: ${data}`);
     }
     handleSysEx(data) {
         switch (data[0]) {
@@ -1494,8 +1703,8 @@ Object.defineProperty(MidyGM2, "channelSettings", {
         volume: 100 / 127,
         pan: 64,
         portamentoTime: 0,
-        reverb: 0,
-        chorus: 0,
+        reverbSendLevel: 0,
+        chorusSendLevel: 0,
         bank: 121 * 128,
         bankMSB: 121,
         bankLSB: 0,

package/esm/midy-GMLite.js

@@ -893,11 +893,11 @@ export class MidyGMLite {
                     case 2: // GM System Off
                         break;
                     default:
-                        console.warn(`Unsupported Exclusive Message ${data}`);
+                        console.warn(`Unsupported Exclusive Message: ${data}`);
                 }
                 break;
             default:
-                console.warn(`Unsupported Exclusive Message ${data}`);
+                console.warn(`Unsupported Exclusive Message: ${data}`);
         }
     }
     GM1SystemOn() {
@@ -916,11 +916,11 @@ export class MidyGMLite {
                     case 1:
                         return this.handleMasterVolumeSysEx(data);
                     default:
-                        console.warn(`Unsupported Exclusive Message ${data}`);
+                        console.warn(`Unsupported Exclusive Message: ${data}`);
                 }
                 break;
             default:
-                console.warn(`Unsupported Exclusive Message ${data}`);
+                console.warn(`Unsupported Exclusive Message: ${data}`);
         }
     }
     handleMasterVolumeSysEx(data) {
@@ -938,7 +938,7 @@ export class MidyGMLite {
         }
     }
     handleExclusiveMessage(data) {
-        console.warn(`Unsupported Exclusive Message ${data}`);
+        console.warn(`Unsupported Exclusive Message: ${data}`);
     }
     handleSysEx(data) {
         switch (data[0]) {