增强音频库

关于测试覆盖率的说明

尝试使用Rust进行音频编程的实验。

将此存储库中的任何内容视为草稿。

许可证

此存储库的大部分内容根据MIT许可证发布。

某些包含完整应用的目录根据AGPLv3许可证发布。请参阅LICENSE和README.md文件。

📖 文档

• 增强音频库
• 此存储库中的应用
  • 测试插件宿主
  • 节拍器
  • 连续循环器（原生macOS）
  • 循环器VST（iced）

⬇️ 二进制下载

• 查看发行版以下载二进制文件
• App Store上的简单节拍器
• App Store上的连续循环器

💬 博文

• 初始的 'Test Plugin Host' 文章
• 简单节拍器发行版
• Rust中的通用AudioProcessors
• 连续循环器 - 8轨现场循环器和性能采样器

• 简单的独立音频应用程序
• 效果和分析
  • RMS，FFT，峰值检测，瞬态检测
  • 过滤器
  • 基于时间的效果（延迟/混响）
  • 压缩器
  • 音高转换器
  • 比特率压碎器
  • 实用工具（声像，单声道，增益）

📸 屏幕截图

👩 网页GUI

请参阅docs/misc/WEB_GUI.md。

🛠 Rust库和工具

工作区 & 构建

项目使用cargo工作区设置。在根目录下运行cargo命令应编译所有共享缓存的crate。

要构建整个项目，请运行

git submodule update --init
cargo build

要运行测试

cargo test

在OSX上，您可能想运行./scripts/test.sh而不是该命令。

构建输出应在target/debug或target/release上。

打包应用程序和VST

使用./scripts/dev.sh build打包VST。这将构建所有包，使用./scripts/dev.sh build <path>构建特定crate的输出。

循环器、节拍器和其他（flutter / macOS构建）

请参阅crates/apps下的README中的说明。

在Linux上构建

由于该项目引入了所有可能的rust crate，您需要安装相当多的依赖项。

请参阅.github/workflows/default.yml以获取Ubuntu上所需的列表。

代码检查

cargo clippy

基准测试

将使用criterion逐渐添加基准测试。为了运行基准测试，请使用

cargo bench

在macOS上分析

https://crates.io/crates/cargo-instruments

cd ./crates/oscillator
cargo instruments -t time --bench sine_oscillator_benchmark -- --bench

从基准测试生成火焰图

注意 我无法在macOS上运行此操作

可以使用cargo-flamegraph生成火焰图

cargo install flamegraph

然后可以使用此工具运行criterion基准测试并生成火焰图

cargo flamegraph --bench sine_oscillator_benchmark -- --bench

快照测试音频处理器

请参阅docs/monorepo-tooling/SNAPSHOT_TESTING.md。

调试功能

• https://crates.io/crates/cargo-whatfeatures