ZLEqualizer：实践指南

面对实际交付，我看ZLEqualizer的重点不在星标，而在这项能力：用于音乐制作与音频处理的动态均衡器插件，提供多频段调节能力。把它放到日常自动化流程中，最容易暴露的是输入边界、依赖和失败处理如果不清楚就很难稳定复用，不能只看演示是否顺利。更实际的做法是用一项范围明确的真实任务完成最小试跑，同时核对配置时间、输出质量、异常信息和维护痕迹，不要直接在关键项目上。整体来看，它适合愿意先做小范围验证并复查原始文档的团队拿来做对照测试，最终决定仍应回到真实结果和维护状态。

ZL 均衡器

ZL Equalizer是一个均衡器插件。

从源代码构建

安装依赖项

请确保您的 OS 上安装并配置了 Clang（AppleClang 16+ 或 LLVM/Clang 17+）、cmake 3.25+、ninja。

在 Linux 上，您可以使用以下命令安装其余依赖项：

sudo apt-get update && sudo apt install libasound2-dev libx11-dev libxcomposite-dev libxcursor-dev libxext-dev libxinerama-dev libxrandr-dev libxrender-dev libfreetype-dev libfontconfig1-dev libxi-dev

克隆和构建

设置环境后，您可以克隆 ZL 均衡器代码，填充所有子模块，然后配置和构建代码。请设定：

• 变量 ZL_JUCE_FORMATS 作为您想要的插件格式的列表，e.g.，"VST3;LV2"
  • AAX 插件需要使用 PACE 反盗版签名工具进行数字签名，然后才能在 Pro Tools 的商用版本中运行。
• 变量ZL_EQ_BAND_NUM作为波段数，默认24个波段
  • 使用不同的 ZL_EQ_BAND_NUM 构建的插件可能会相互兼容。
• 变量 ZL_HWY_STATIC_TARGET 作为 SIMD 目标
  • 如果您使用的是 x86-64 并且您的 CPU 支持 SSE2，请设置 ZL_HWY_STATIC_TARGET=SSE2。
  • 如果您使用的是 x86-64 并且您的 CPU 支持 SSE2/SSE4，请设置 ZL_HWY_STATIC_TARGET=SSE4。
  • 如果您使用的是 x86-64 并且您的 CPU 支持 SSE2/SSE4/AVX2，请设置 ZL_HWY_STATIC_TARGET=AVX2。
  • 如果您使用的是arm64，请设置ZL_HWY_STATIC_TARGET=NEON。
• 如果您的 OS 上有多个编译器，您可能需要传递额外的标志以确保 cmake 使用 LLVM/Clang。
  • 在 Linux 上，您可以传递 -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++。
  • 在 Windows 上，您可以传递 -DCMAKE_C_COMPILER=clang-cl -DCMAKE_CXX_COMPILER=clang-cl。

git clone https://github.com/ZL-Audio/ZLEqualizer
cd ZLEqualizer
git submodule update --init --recursive
cmake -B Builds -G Ninja -DCMAKE_BUILD_TYPE=Release -DZL_JUCE_FORMATS="VST3;LV2" -DZL_HWY_STATIC_TARGET="NEON" .
cmake --build Builds --config Release

构建完成后，插件应该已复制到相应的文件夹中。如果你想禁用复制过程，可以通过-DZL_JUCE_COPY_PLUGIN=FALSE，找到Builds/ZLEqualizer_artefacts/Release下的二进制文件夹并手动复制它们。

参考文献

尤里·伊万佐夫关于理想双线性和双二次数字滤波器。 （2025）。

尤里·伊万佐夫关于线性数字滤波器的状态空间。 （2025）。

马丁·维卡内克. 匹配的单极数字搁架滤波器。 （2019）。

马丁·维卡内克. 匹配的二阶数字滤波器。 （2016）。

奈杰尔·雷德蒙. 级联过滤器。 （2016）。

亚伦·威什尼克。 用于音乐应用的时变滤波器。 DAFx。 （2014）。

克利夫·莫勒。 Makima 分段三次插值。 MathWorks 博客。 （2019）。