Rubber Band 库

一个音频时间拉伸和音高变换的库和实用程序。

Rubber Band 是一个库和实用程序，可以独立改变音频录音的速度和音高。

关于 Rubber Band：https://breakfastquay.com/rubberband/
代码仓库：https://hg.sr.ht/~breakfastquay/rubberband
Github 镜像：https://github.com/breakfastquay/rubberband

CI 构建：

(Linux)
(macOS, iOS)
(Windows)

许可证

Rubber Band 库在 GNU 通用公共许可证 (GPL) 下分发。您可以根据 GPL 的条款重新分发和/或修改它；可以选择使用许可证的第 2 版或任何更新的版本。有关更多信息，请参阅 COPYING 文件。

如果您希望使用 Rubber Band 库分发代码，但使用的条款不同于 GNU 通用公共许可证，您必须在这样做之前从我们获得商业许可。特别是，除非您有商业许可，否则您不能通过任何 Apple App Store 合法分发。有关许可条款，请参阅 https://breakfastquay.com/rubberband/。

如果您已获得有效的商业许可，您的许可将取代本 README 和随附的 COPYING 文件，您可以根据该许可中描述的条款重新分发和/或修改 Rubber Band。请参阅您的许可协议以获取更多详细信息。

Rubber Band 包含一个由 Jonathan Gilbert 慷慨贡献的 .NET 接口，采用类似 BSD 的许可。dotnet/rubberband-dll 和 dotnet/rubberband-sharp 目录中的文件属于此许可。如果您使用此接口，请确保遵守其许可条款。

Rubber Band 可能会链接其他库或与其他源代码一起编译，具体取决于其构建配置。无论您以何种条件重新分发 Rubber Band 代码本身，您都有责任确保仅根据这些库自身的许可条款重新分发它们。据我们所知，一些相关库代码的许可如下。有关更多详细信息，另请参阅文件 COMPILING.md。

FFTW3 - GPL 带商业专有选项
Intel IPP - 某种专有性质
SLEEF - 类似 BSD
KissFFT - 类似 BSD
libsamplerate - 从 0.1.9 版本开始类似 BSD
Speex - 类似 BSD
Pommier 数学函数 - 类似 BSD

编译 Rubber Band 库

有关如何配置和构建库的详细信息，请参阅文件 COMPILING.md。

本 README 的内容

代码组件
使用 Rubber Band 命令行工具
使用 Rubber Band 库

1. 代码组件

Rubber Band 包括：

Rubber Band 库代码。这是通常会被您的应用程序使用的代码。这些头文件位于 rubberband/ 目录中，源代码位于 src/ 中。 Rubber Band 库可能还依赖于外部重采样器和 FFT 代码，如果配置为这样；有关详细信息，请参阅 COMPILING.md 的第 7 节。
Rubber Band 命令行工具。这在 main/main.cpp 中。该程序使用 Rubber Band 库，还需要 libsndfile（http://www.mega-nerd.com/libsndfile/，根据 GNU 较小通用公共许可证许可）用于音频文件加载。
LADSPA 和 LV2 格式的音高变换音频效果插件。这些位于 ladspa-lv2/ 中。它们分别需要 LADSPA SDK 头文件 ladspa.h 和 LV2 头文件 lv2.h（未包含）。
一个 Vamp 音频分析插件，可用于检查 Rubber Band 库在使用时采取的动态拉伸比率和其他决策。这在 vamp/ 中。它需要 Vamp 插件 SDK（https://www.vamp-plugins.org/develop.html）（未包含）。

2. 使用 Rubber Band 命令行工具

Rubber Band 命令行工具构建为 build/rubberband。基本用法是

  $ rubberband -t <时间比率> -p <半音数> <输入文件.wav> <输出文件.wav>

例如，

  $ rubberband -t 1.5 -p 2.0 test.wav output.wav

将文件 test.wav 拉伸到比原始时长长 50%，将音高提高一个全音，并将输出写入 output.wav。

还有几个其他选项可用：运行 rubberband -h 获取帮助。

最重要的是 -2 和 -3 选项。这些选项在两种不同的处理引擎之间进行选择，分别称为 R2（更快）引擎和 R3（更精细）引擎。对于大多数材料，特别是复杂混音、人声和其他具有柔和起音和平滑音高变化的声音，以及具有大量低音内容的音乐，R3 引擎比 R2 产生更高质量的结果。但是，它比 R2 引擎使用更多的 CPU。

R2 引擎是 Rubber Band 库 2.x 版本之前唯一可用的方法，为了兼容性，当命令行工具被调用为 rubberband 时，它仍然是默认选项（如果既没有明确请求 -2 也没有 -3）。如果工具被调用为 rubberband-r3，则 R3 引擎是默认选项。

还有许多其他选项可用，其中大多数仅在使用 R2 引擎时有效。特别是，不同类型的音乐可能受益于不同的"清晰度"选项（-c 标志，带有从 0 到 6 的数字参数）。

3. 使用 Rubber Band 库

Rubber Band 有一个公共 API，由 RubberBand 命名空间中的一个 C++ 类组成，称为 RubberBandStretcher。您应该 #include <rubberband/RubberBandStretcher.h> 来使用这个类。类头文件中有详细的文档。

还提供了 C 语言绑定的头文件 <rubberband/rubberband-c.h>。这是 C++ 实现的包装器，由于实现是相同的，它还需要与 C++ 标准库链接。它目前还没有与 C++ 头文件分开的文档。您应该只包含这两个头文件中的一个，而不是两个都包含。

还包括一个 .NET 接口，由 Jonathan Gilbert 贡献；有关详细信息，请参阅 dotnet 目录中的文件。

命令行实用程序的源代码（main/main.cpp）提供了一个很好的示例，说明如何在离线模式下使用 Rubber Band；音高变换器插件（ladspa-lv2/RubberBandPitchShifter.cpp）可用作实时模式下 Rubber Band 的示例。

**重要提示：**在应用程序中使用 Rubber Band 之前，请确保您已阅读并理解了 Rubber Band 的许可条款。该库根据 GNU 通用公共许可证提供，这意味着使用它的任何应用程序也必须在 GPL 或兼容许可下发布（即其完整源代码也可用于修改和重新分发），除非您已单独从作者那里获得商业许可。