spessasynth_lib 3.24.28 → 3.24.35

package/soundfont/dls/dls_soundfont.js

@@ -1,4 +1,4 @@
-import { BasicSoundFont } from "../basic_soundfont/basic_soundfont.js";
+import { BasicSoundBank } from "../basic_soundfont/basic_soundfont.js";
 import { IndexedByteArray } from "../../utils/indexed_array.js";
 import { SpessaSynthGroup, SpessaSynthGroupEnd, SpessaSynthInfo } from "../../utils/loggin.js";
 import { consoleColors } from "../../utils/other.js";
@@ -11,7 +11,7 @@ import { readLart } from "./read_lart.js";
 import { readRegion } from "./read_region.js";
 import { readDLSSamples } from "./read_samples.js";
 
-class DLSSoundFont extends BasicSoundFont
+class DLSSoundFont extends BasicSoundBank
 {
     /**
      * Loads a new DLS (Downloadable sounds) soundfont
@@ -34,7 +34,7 @@ class DLSSoundFont extends BasicSoundFont
         this.verifyText(readBytesAsString(this.dataArray, 4).toLowerCase(), "dls ");
         
         /**
-         * Read list
+         * Read the list
          * @type {RiffChunk[]}
          */
         const chunks = [];
@@ -95,7 +95,7 @@ class DLSSoundFont extends BasicSoundFont
             consoleColors.recognized
         );
         
-        // read wave list
+        // read the wave list
         let waveListChunk = findRIFFListType(chunks, "wvpl");
         if (!waveListChunk)
         {
@@ -104,7 +104,7 @@ class DLSSoundFont extends BasicSoundFont
         }
         this.readDLSSamples(waveListChunk);
         
-        // read instrument list
+        // read the instrument list
         let instrumentListChunk = findRIFFListType(chunks, "lins");
         if (!instrumentListChunk)
         {
@@ -170,9 +170,9 @@ class DLSSoundFont extends BasicSoundFont
         throw new Error(`DLS parse error: ${error} The file may be corrupted.`);
     }
     
-    destroySoundfont()
+    destroySoundBank()
     {
-        super.destroySoundfont();
+        super.destroySoundBank();
         delete this.dataArray;
     }
 }

package/soundfont/dls/read_instrument.js

@@ -82,7 +82,7 @@ export function readDLSInstrument(chunk)
     }
     // remove generators with default values
     globalZone.generators = globalZone.generators.filter(g => g.generatorValue !== generatorLimits[g.generatorType].def);
-    // override reverb and chorus with 1000 instead of 200 (if not overriden)
+    // override reverb and chorus with 1000 instead of 200 (if not override)
     // reverb
     if (globalZone.modulators.find(m => m.modulatorDestination === generatorTypes.reverbEffectsSend) === undefined)
     {

package/soundfont/dls/read_region.js

@@ -129,6 +129,7 @@ export function readRegion(chunk)
     readLittleEndian(waveLinkChunk.chunkData, 4);
     // sampleID
     const sampleID = readLittleEndian(waveLinkChunk.chunkData, 4);
+    // noinspection JSValidateTypes
     /**
      * @type {DLSSample}
      */

package/soundfont/dls/read_samples.js

@@ -35,7 +35,7 @@ function readPCM(dataChunk, bytesPerSample)
     }
     else
     {
-        normalizationFactor = maxSampleValue; // For 16-bit normalize from -32768 to 32767
+        normalizationFactor = maxSampleValue; // For 16-bit normalize from -32,768 to 32,767
     }
     const sampleLength = dataChunk.size / bytesPerSample;
     const sampleData = new Float32Array(sampleLength);
@@ -167,7 +167,6 @@ export function readDLSSamples(waveListChunk)
                 failed = true;
                 sampleData = new Float32Array(dataChunk.size / bytesPerSample);
                 break;
-            //throw new Error(`Unsupported WAVE format. Fmt reports ${waveFormat}`);
             
             case W_FORMAT_TAG.PCM:
                 sampleData = readPCM(dataChunk, bytesPerSample);
@@ -195,7 +194,7 @@ export function readDLSSamples(waveListChunk)
             }
         }
         
-        // sane defaults
+        // correct defaults
         let sampleKey = 60;
         let samplePitch = 0;
         let sampleLoopStart = 0;
@@ -210,13 +209,13 @@ export function readDLSSamples(waveListChunk)
             readLittleEndian(wsmpChunk.chunkData, 4);
             sampleKey = readLittleEndian(wsmpChunk.chunkData, 2);
             // section 1.14.2: Each relative pitch unit represents 1/65536 cents.
-            // but that doesn't seem to be true for this one: it's just cents.
+            // but that doesn't seem true for this one: it's just cents.
             samplePitch = signedInt16(
                 wsmpChunk.chunkData[wsmpChunk.chunkData.currentIndex++],
                 wsmpChunk.chunkData[wsmpChunk.chunkData.currentIndex++]
             );
             
-            // pitch correction: convert hundreds to root key
+            // pitch correction: convert hundreds to the root key
             const samplePitchSemitones = Math.trunc(samplePitch / 100);
             sampleKey += samplePitchSemitones;
             samplePitch -= samplePitchSemitones * 100;

package/soundfont/load_soundfont.js

@@ -6,7 +6,7 @@ import { SoundFont2 } from "./read_sf2/soundfont.js";
 /**
  * Loads a soundfont file
  * @param buffer {ArrayBuffer}
- * @returns {BasicSoundFont}
+ * @returns {BasicSoundBank}
  */
 export function loadSoundFont(buffer)
 {

package/soundfont/read_sf2/presets.js

@@ -26,7 +26,7 @@ export class Preset extends BasicPreset
         this.bank = readLittleEndian(presetChunk.chunkData, 2);
         this.presetZoneStartIndex = readLittleEndian(presetChunk.chunkData, 2);
         
-        // read the dwords
+        // read the dword
         this.library = readLittleEndian(presetChunk.chunkData, 4);
         this.genre = readLittleEndian(presetChunk.chunkData, 4);
         this.morphology = readLittleEndian(presetChunk.chunkData, 4);

package/soundfont/read_sf2/soundfont.js

@@ -11,7 +11,7 @@ import { consoleColors } from "../../utils/other.js";
 import { SpessaSynthGroup, SpessaSynthGroupEnd, SpessaSynthInfo } from "../../utils/loggin.js";
 import { readBytesAsString } from "../../utils/byte_functions/string.js";
 import { stbvorbis } from "../../externals/stbvorbis_sync/stbvorbis_sync.min.js";
-import { BasicSoundFont } from "../basic_soundfont/basic_soundfont.js";
+import { BasicSoundBank } from "../basic_soundfont/basic_soundfont.js";
 import { Generator } from "../basic_soundfont/generator.js";
 import { Modulator } from "../basic_soundfont/modulator.js";
 
@@ -20,7 +20,7 @@ import { Modulator } from "../basic_soundfont/modulator.js";
  * purpose: parses a soundfont2 file
  */
 
-export class SoundFont2 extends BasicSoundFont
+export class SoundFont2 extends BasicSoundBank
 {
     /**
      * Initializes a new SoundFont2 Parser and parses the given data array
@@ -54,7 +54,7 @@ export class SoundFont2 extends BasicSoundFont
         }
         /*
         Some SF2Pack description:
-        this is essentially sf2, but the entire smpl chunk is compressed (we only support ogg vorbis here)
+        this is essentially sf2, but the entire smpl chunk is compressed (we only support Ogg Vorbis here)
         and the only other difference is that the main chunk isn't "sfbk" but rather "sfpk"
          */
         const isSF2Pack = type === "sfpk";
@@ -297,9 +297,9 @@ export class SoundFont2 extends BasicSoundFont
         }
     }
     
-    destroySoundfont()
+    destroySoundBank()
     {
-        super.destroySoundfont();
+        super.destroySoundBank();
         delete this.dataArray;
     }
 }

package/synthetizer/audio_effects/effects_config.js

@@ -2,13 +2,13 @@ import { DEFAULT_CHORUS_CONFIG } from "./fancy_chorus.js";
 
 /**
  * @typedef {Object} SynthConfig
- * @property {boolean} chorusEnabled - indicates if the chorus effect is enabled.
+ * @property {boolean?} chorusEnabled - indicates if the chorus effect is enabled.
  * @property {ChorusConfig?} chorusConfig - the configuration for chorus. Pass undefined to use defaults
- * @property {boolean} reverbEnabled - indicates if the reverb effect is enabled.
+ * @property {boolean?} reverbEnabled - indicates if the reverb effect is enabled.
  * @property {AudioBuffer?} reverbImpulseResponse - the impulse response for the reverb. Pass undefined to use defaults
  * @property {{
  *      worklet: function(context: object, name: string, options?: Object)
- * }} audioNodeCreators - custom audio node creation functions for Web Audio wrappers.
+ * }?} audioNodeCreators - custom audio node creation functions for Web Audio wrappers.
  */
 
 

package/synthetizer/audio_effects/fancy_chorus.js

@@ -13,13 +13,13 @@
 
 /**
  * @typedef {Object} ChorusConfig
- * @property {number} nodesAmount - the amount of delay nodes (for each channel) and the corresponding oscillators
- * @property {number} defaultDelay - the initial delay, in seconds
- * @property {number} delayVariation - the difference between delays in the delay nodes
- * @property {number} stereoDifference - the difference of delays between two channels (added to the left channel and subtracted from the right)
- * @property {number} oscillatorFrequency - the initial delay time oscillator frequency, in Hz.
- * @property {number} oscillatorFrequencyVariation - the difference between frequencies of oscillators, in Hz
- * @property {number} oscillatorGain - how much will oscillator alter the delay in delay nodes, in seconds
+ * @property {number?} nodesAmount - the amount of delay nodes (for each channel) and the corresponding oscillators
+ * @property {number?} defaultDelay - the initial delay, in seconds
+ * @property {number?} delayVariation - the difference between delays in the delay nodes
+ * @property {number?} stereoDifference - the difference of delays between two channels (added to the left channel and subtracted from the right)
+ * @property {number?} oscillatorFrequency - the initial delay time oscillator frequency, in Hz.
+ * @property {number?} oscillatorFrequencyVariation - the difference between frequencies of oscillators, in Hz
+ * @property {number?} oscillatorGain - how much will oscillator alter the delay in delay nodes, in seconds
  */
 
 const NODES_AMOUNT = 4;

package/synthetizer/audio_effects/reverb.js

@@ -1,3 +1,5 @@
+import { reverbBufferBinary } from "./reverb_as_binary.js";
+
 /**
  * Creates a reverb processor
  * @param context {BaseAudioContext}
@@ -13,12 +15,10 @@ export function getReverbProcessor(context, reverbBuffer = undefined)
     }
     else
     {
-        // resolve relative url
-        const impulseURL = new URL("impulse_response_2.flac", import.meta.url);
-        fetch(impulseURL).then(async response =>
+        // decode
+        context.decodeAudioData(reverbBufferBinary.buffer).then(b =>
         {
-            const data = await response.arrayBuffer();
-            convolver.buffer = await context.decodeAudioData(data);
+            convolver.buffer = b;
         });
     }
     return convolver;

package/synthetizer/audio_effects/reverb_as_binary.js

@@ -0,0 +1,15 @@
+import { rb } from "./reverb_buffer.min.js";
+
+const binaryString = atob(rb);
+const binary = new Uint8Array(binaryString.length);
+for (let i = 0; i < binaryString.length; i++)
+{
+    binary[i] = binaryString.charCodeAt(i);
+}
+
+
+/**
+ * @type {ArrayBuffer}
+ */
+const reverbBufferBinary = binary.buffer;
+export { reverbBufferBinary };