DSP.js 技术文档

1. 安装指南

DSP.js 是一个为 JavaScript 提供数字信号处理功能的库。由于这是一个纯 JavaScript 库，因此无需复杂的安装流程。只需将库的代码下载到本地，或者通过 <script> 标签在 HTML 文档中直接引入即可。

<script src="path_todsp.js"></script>

或者，如果您希望通过 CDN 方式引入，可以使用如下代码：

<script src="https://cdn.jsdelivr.net/npm/dsp.js/dist/dsp.js"></script>

2. 项目使用说明

DSP.js 提供了多种模块用于信号分析和生成，以下为各模块的基本使用方法：

DFT (离散傅里叶变换)

var dft = new DFT(1024, 44100); // 创建一个 DFT 对象，指定缓冲区大小和采样率
dft.forward(signal);             // 对信号进行前向变换
var spectrum = dft.spectrum;    // 获取频谱数据

FFT (快速傅里叶变换)

var fft = new FFT(2048, 44100); // 创建一个 FFT 对象，指定缓冲区大小和采样率
fft.forward(signal);            // 对信号进行前向变换
var spectrum = fft.spectrum;    // 获取频谱数据

Oscillator (信号发生器)

var osc = new Oscillator(SINEWAVE, 440, 1, 2048, 22050); // 创建一个振荡器，指定波形、频率、振幅、缓冲区大小和采样率
osc.generate();                                     // 生成信号
var signal = osc.signal;                             // 获取生成的信号

ADSR (攻击-衰减-保持-释放包络)

var envelope = new ADSR(0.01, 0.1, 0.5, 0.1, 0.2, 44100); // 创建一个 ADSR 包络，指定攻击、衰减、保持水平、保持时间、释放时间和采样率
envelope.process(signal);                             // 处理信号

IIRFilter (无限冲击响应滤波器)

var filter = IIRFilter(LOWPASS, 200, 44100); // 创建一个滤波器，指定类型、截止频率和采样率
filter.process(signal);                     // 处理信号

MultiDelay (多延迟)

var delay = MultiDelay(44100*5, 44100*1, 1.0, 0.6); // 创建一个多延迟效果器，指定最大延迟大小、延迟大小、主音量、延迟音量
delay.process(signal);                              // 处理信号

Reverb (混响)

var reverb = Reverb(20000, 6500, 0.8, 0.5, 0.9, 4500); // 创建一个混响效果器，指定最大延迟大小、延迟大小、主音量、混合音量、延迟音量和阻尼频率
reverb.process(signal);                               // 处理信号

3. 项目API使用文档

以下是 DSP.js 中各模块的 API 文档：

• DFT(bufferSize, sampleRate)：离散傅里叶变换类
• FFT(bufferSize, sampleRate)：快速傅里叶变换类
• Oscillator(waveform, frequency, amplitude, bufferSize, sampleRate)：信号发生器类
• ADSR(attack, decay, sustainLevel, sustain, release, sampleRate)：攻击-衰减-保持-释放包络类
• IIRFilter(filter, cutoff, sampleRate)：无限冲击响应滤波器类
• MultiDelay(maxDelayInSamplesSize, delayInSamples, masterVolume, delayVolume)：多延迟效果器类
• Reverb(maxDelayInSamplesSize, delayInSamples, masterVolume, mixVolume, delayVolume, dampFrequency)：混响效果器类

每个类都有其构造函数和一系列方法，具体使用请参照各模块的基本使用方法。

4. 项目安装方式

请参考上述安装指南。