@effetune/dsp 0.5.0 → 0.7.0

package/dist/effect.js

@@ -2,8 +2,8 @@ import { AssetError, ValidationError } from './errors.js';
 
 export const EFFECT_CHANNELS = Object.freeze([
   'all', 'stereo', 'left', 'right',
-  '1', '2', '3', '4', '5', '6', '7', '8',
-  '34', '56', '78'
+  '1', '2', '3', '4', '5', '6', '7', '8', '9', '10', '11', '12', '13', '14', '15', '16',
+  '34', '56', '78', '910', '1112', '1314', '1516'
 ]);
 
 const COMMON_KEYS = new Set(['id', 'enabled', 'channel', 'assets', 'parameters']);
@@ -12,6 +12,7 @@ const ASSET_NAMES_BY_EFFECT = new Map([
   ['FIRCrossover', ['impulseResponse']],
   ['FiveBandFIRPEQ', ['impulseResponse']],
   ['GroupDelayEQ', ['impulseResponse']],
+  ['GroupDelayPEQ', ['impulseResponse']],
   ['IRReverb', ['impulseResponse']],
   ['RoomEQ', ['impulseResponse']]
 ]);
@@ -85,6 +86,32 @@ export function validateParameterValue(effectType, definition, value) {
   return Array.isArray(value) ? Object.freeze([...value]) : value;
 }
 
+export function canonicalizeProcessingParameters(effectType, parameters) {
+  const canonical = { ...parameters };
+  if (effectType === 'AutoFilter' &&
+      canonical.minimumFrequency > canonical.maximumFrequency) {
+    [canonical.minimumFrequency, canonical.maximumFrequency] =
+      [canonical.maximumFrequency, canonical.minimumFrequency];
+  } else if (effectType === 'Chorus' && canonical.depth > canonical.delay) {
+    canonical.depth = canonical.delay;
+  } else if (effectType === 'FrequencyShifter' &&
+      canonical.minimumShift > canonical.maximumShift) {
+    [canonical.minimumShift, canonical.maximumShift] =
+      [canonical.maximumShift, canonical.minimumShift];
+  } else if (effectType === 'MultibandCompressor' || effectType === 'MultibandExpander' ||
+      effectType === 'MultibandBalance' || effectType === 'MultibandTransient' ||
+      effectType === 'MultibandSaturation') {
+    const count = effectType === 'MultibandTransient' || effectType === 'MultibandSaturation'
+      ? 2 : 4;
+    for (let index = 2; index <= count; index++) {
+      const key = `frequency${index}`;
+      const previous = canonical[`frequency${index - 1}`];
+      if (canonical[key] < previous) canonical[key] = previous;
+    }
+  }
+  return canonical;
+}
+
 function normalizeBaseAssets(effectType, assets) {
   const assetNames = ASSET_NAMES_BY_EFFECT.get(effectType);
   if (!assetNames) {

package/dist/generated-effects.d.ts

@@ -1,9 +1,9 @@
 // Generated by scripts/gen-dsp-library-bindings.mjs. Do not edit.
 import { Effect } from './effect.js';
 
-export type EffectType = "LevelMeter" | "Oscilloscope" | "Spectrogram" | "SpectrumAnalyzer" | "StereoMeter" | "ChannelDivider" | "DCOffset" | "FIRCrossover" | "Matrix" | "MultiChannelPanel" | "Mute" | "PolarityInversion" | "StereoBalance" | "Volume" | "Delay" | "TimeAlignment" | "AutoLeveler" | "BrickwallLimiter" | "Compressor" | "Expander" | "Gate" | "MultibandCompressor" | "MultibandExpander" | "MultibandTransient" | "PowerAmpSag" | "TransientShaper" | "BandPassFilter" | "CombFilter" | "EarphoneCableSim" | "FifteenBandGEQ" | "FifteenBandPEQ" | "FiveBandDynamicEQ" | "FiveBandFIRPEQ" | "FiveBandPEQ" | "GroupDelayEQ" | "HiPassFilter" | "LoPassFilter" | "LoudnessEqualizer" | "NarrowRange" | "RoomEQ" | "TiltEQ" | "ToneControl" | "AMRadioSimulator" | "BitCrusher" | "BluetoothSBCSimulator" | "CassetteArtifacts" | "DigitalErrorEmulator" | "DSD64IMDSimulator" | "FMRadioSimulator" | "G726ADPCMSimulator" | "GSMFullRateSimulator" | "HumGenerator" | "MP3CodecSimulator" | "NoiseBlender" | "SimpleJitter" | "SWRadioSimulator" | "TapeArtifacts" | "VinylArtifacts" | "VinylSimulator" | "AutoFilter" | "AutoPan" | "Chorus" | "DopplerDistortion" | "FrequencyShifter" | "Phaser" | "PitchShifter" | "RotarySpeaker" | "Tremolo" | "WowFlutter" | "Oscillator" | "HornResonator" | "HornResonatorPlus" | "ModalResonator" | "DattorroPlateReverb" | "FDNReverb" | "IRReverb" | "RSReverb" | "DynamicSaturation" | "Exciter" | "HardClipping" | "HarmonicDistortion" | "MultibandSaturation" | "Saturation" | "SubSynth" | "TubeSimulator" | "CrossfeedFilter" | "MSMatrix" | "MultibandBalance" | "PhaseSelectEQ" | "StereoBlend";
-type RequiredAssetEffectType = "FIRCrossover" | "FiveBandFIRPEQ" | "GroupDelayEQ" | "RoomEQ" | "IRReverb";
-export type EffectChannel = "all" | "stereo" | "left" | "right" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "34" | "56" | "78";
+export type EffectType = "LevelMeter" | "Oscilloscope" | "Spectrogram" | "SpectrumAnalyzer" | "StereoMeter" | "ChannelDivider" | "DCOffset" | "FIRCrossover" | "Matrix" | "MultiChannelPanel" | "Mute" | "PolarityInversion" | "StereoBalance" | "Volume" | "Delay" | "TimeAlignment" | "AutoLeveler" | "BrickwallLimiter" | "Compressor" | "Expander" | "Gate" | "MultibandCompressor" | "MultibandExpander" | "MultibandTransient" | "PowerAmpSag" | "TransientShaper" | "BandPassFilter" | "CombFilter" | "EarphoneCableSim" | "FifteenBandGEQ" | "FifteenBandPEQ" | "FiveBandDynamicEQ" | "FiveBandFIRPEQ" | "FiveBandPEQ" | "GroupDelayEQ" | "GroupDelayPEQ" | "HiPassFilter" | "LoPassFilter" | "LoudnessEqualizer" | "NarrowRange" | "RoomEQ" | "TiltEQ" | "ToneControl" | "AMRadioSimulator" | "BitCrusher" | "BluetoothSBCSimulator" | "CassetteArtifacts" | "DigitalErrorEmulator" | "DSD64IMDSimulator" | "FMRadioSimulator" | "G726ADPCMSimulator" | "GSMFullRateSimulator" | "HumGenerator" | "MDSimulator" | "MP3CodecSimulator" | "NoiseBlender" | "SimpleJitter" | "SWRadioSimulator" | "TapeArtifacts" | "VinylArtifacts" | "VinylSimulator" | "AutoFilter" | "AutoPan" | "Chorus" | "DopplerDistortion" | "FrequencyShifter" | "Phaser" | "PitchShifter" | "RotarySpeaker" | "Tremolo" | "WowFlutter" | "Oscillator" | "HornResonator" | "HornResonatorPlus" | "ModalResonator" | "DattorroPlateReverb" | "FDNReverb" | "IRReverb" | "RSReverb" | "DynamicSaturation" | "Exciter" | "HardClipping" | "HarmonicDistortion" | "MultibandSaturation" | "Saturation" | "SubSynth" | "TubeSimulator" | "CrossfeedFilter" | "MSMatrix" | "MultibandBalance" | "PhaseSelectEQ" | "StereoBlend";
+type RequiredAssetEffectType = "FIRCrossover" | "FiveBandFIRPEQ" | "GroupDelayEQ" | "GroupDelayPEQ" | "RoomEQ" | "IRReverb";
+export type EffectChannel = "all" | "stereo" | "left" | "right" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "13" | "14" | "15" | "16" | "34" | "56" | "78" | "910" | "1112" | "1314" | "1516";
 
 export interface CommonEffectOptions {
   readonly id?: string;
@@ -139,11 +139,11 @@ export declare class Matrix extends Effect {
 export declare function createMatrix(options?: MatrixOptions): Matrix;
 
 export interface MultiChannelPanelOptions extends CommonEffectOptions {
-  readonly mute?: readonly [boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean];
-  readonly solo?: readonly [boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean];
-  readonly volume?: readonly [number, number, number, number, number, number, number, number];
-  readonly delay?: readonly [number, number, number, number, number, number, number, number];
-  readonly link?: readonly [boolean, boolean, boolean, boolean, boolean, boolean, boolean];
+  readonly mute?: readonly [boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean];
+  readonly solo?: readonly [boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean];
+  readonly volume?: readonly [number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number];
+  readonly delay?: readonly [number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number];
+  readonly link?: readonly [boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean];
   readonly assets?: never;
 }
 
@@ -555,6 +555,19 @@ export declare class GroupDelayEQ extends Effect {
 
 export declare function createGroupDelayEQ(options: GroupDelayEQOptions): GroupDelayEQ;
 
+export interface GroupDelayPEQOptions extends CommonEffectOptions {
+  readonly latencyMode?: "0" | "128" | "256" | "512" | "1024";
+  readonly filterDelaySamples?: number;
+  readonly assets: IRReverbAssets;
+}
+
+export declare class GroupDelayPEQ extends Effect {
+  static readonly effectType: "GroupDelayPEQ";
+  constructor(options: GroupDelayPEQOptions);
+}
+
+export declare function createGroupDelayPEQ(options: GroupDelayPEQOptions): GroupDelayPEQ;
+
 export interface HiPassFilterOptions extends CommonEffectOptions {
   readonly frequency?: number;
   readonly slope?: 0 | -12 | -24 | -36 | -48 | -60 | -72 | -84 | -96;
@@ -853,6 +866,20 @@ export declare class HumGenerator extends Effect {
 
 export declare function createHumGenerator(options?: HumGeneratorOptions): HumGenerator;
 
+export interface MDSimulatorOptions extends CommonEffectOptions {
+  readonly mode?: "SP (292 kbps)" | "LP2 (132 kbps)" | "LP4 (66 kbps)";
+  readonly outputGain?: number;
+  readonly mix?: number;
+  readonly assets?: never;
+}
+
+export declare class MDSimulator extends Effect {
+  static readonly effectType: "MDSimulator";
+  constructor(options?: MDSimulatorOptions);
+}
+
+export declare function createMDSimulator(options?: MDSimulatorOptions): MDSimulator;
+
 export interface MP3CodecSimulatorOptions extends CommonEffectOptions {
   readonly codecRate?: "22.05 kHz (MPEG-2)" | "44.1 kHz (MPEG-1)";
   readonly bitrate?: "32" | "48" | "64" | "80" | "96" | "112" | "128" | "160" | "192" | "224" | "256" | "320";
@@ -1555,6 +1582,11 @@ export interface PhaseSelectEQOptions extends CommonEffectOptions {
   readonly corePhaseHigh?: readonly [number, number, number, number, number];
   readonly outerPhaseHigh?: readonly [number, number, number, number, number];
   readonly gain?: readonly [number, number, number, number, number];
+  readonly regionSolo?: readonly [boolean, boolean, boolean, boolean, boolean];
+  readonly outerBalanceLow?: readonly [number, number, number, number, number];
+  readonly coreBalanceLow?: readonly [number, number, number, number, number];
+  readonly coreBalanceHigh?: readonly [number, number, number, number, number];
+  readonly outerBalanceHigh?: readonly [number, number, number, number, number];
   readonly assets?: never;
 }
 
@@ -1613,6 +1645,7 @@ export interface EffectOptionsByType {
   readonly FiveBandFIRPEQ: FiveBandFIRPEQOptions;
   readonly FiveBandPEQ: FiveBandPEQOptions;
   readonly GroupDelayEQ: GroupDelayEQOptions;
+  readonly GroupDelayPEQ: GroupDelayPEQOptions;
   readonly HiPassFilter: HiPassFilterOptions;
   readonly LoPassFilter: LoPassFilterOptions;
   readonly LoudnessEqualizer: LoudnessEqualizerOptions;
@@ -1630,6 +1663,7 @@ export interface EffectOptionsByType {
   readonly G726ADPCMSimulator: G726ADPCMSimulatorOptions;
   readonly GSMFullRateSimulator: GSMFullRateSimulatorOptions;
   readonly HumGenerator: HumGeneratorOptions;
+  readonly MDSimulator: MDSimulatorOptions;
   readonly MP3CodecSimulator: MP3CodecSimulatorOptions;
   readonly NoiseBlender: NoiseBlenderOptions;
   readonly SimpleJitter: SimpleJitterOptions;
@@ -1706,6 +1740,7 @@ export interface EffectClassByType {
   readonly FiveBandFIRPEQ: FiveBandFIRPEQ;
   readonly FiveBandPEQ: FiveBandPEQ;
   readonly GroupDelayEQ: GroupDelayEQ;
+  readonly GroupDelayPEQ: GroupDelayPEQ;
   readonly HiPassFilter: HiPassFilter;
   readonly LoPassFilter: LoPassFilter;
   readonly LoudnessEqualizer: LoudnessEqualizer;
@@ -1723,6 +1758,7 @@ export interface EffectClassByType {
   readonly G726ADPCMSimulator: G726ADPCMSimulator;
   readonly GSMFullRateSimulator: GSMFullRateSimulator;
   readonly HumGenerator: HumGenerator;
+  readonly MDSimulator: MDSimulator;
   readonly MP3CodecSimulator: MP3CodecSimulator;
   readonly NoiseBlender: NoiseBlender;
   readonly SimpleJitter: SimpleJitter;