Rocoder

用 Rust 编写的可实时编码的相位声码器。

Rocoder 是一个数字乐器命令行程序，通过放慢或加速音频并应用可实时编码的频率核来转换音频。它可以

• 改变音频速度
• 音调转换（尽管只沿谐波和亚谐波进行）
• 将任意代码转换应用于频域音频表示（仅限 Mac 和 Linux）
• 实时编译和重新加载转换代码
• 读取和写入音频文件
• 直接音频输入和播放

安装

1. 如果您还没有，请在 https://rustup.rs/ 安装 Rust 工具链
2. 通过运行 cargo install rocoder 来安装此工具
3. 运行 rocoder -h 开始使用！

工作原理

rocoder 是一个相当简单的，可能并不完全正确的 相位声码器。它使用 3 个步骤处理音频，了解基础知识对于高级使用是必要的，特别是与频率核一起工作。

1. 分析：输入音频在重叠的 汉宁窗口 中使用 FFT 分析。每个窗口分析发出其音频窗口的频域表示，编码为复数缓冲区。
2. 处理：如果提供了频率核，则将每个频域窗口缓冲区传递给它进行任意代码定义的处理。
3. 再合成：然后将处理过的频域缓冲区传递给逆 FFT 以进行再合成。再合成以允许音高转换和速度变化的方式进行。

使用方法

rocoder 使用一系列命令行参数进行控制。运行 rocoder -h 以列出它们。

-r, --record

从默认音频输入设备获取音频输入。设置后，rocoder 将开始记录输入，直到您按下 Enter 键。它将自动尝试修剪音频的开始/结束部分，以去除静音。

--rotate-channels

将输入音频通道旋转 1 次。对于立体声输入，这将交换左右通道。

-a, --amplitude <amplitude>

输出振幅乘数。默认为 1;

-b, --buffer <buffer-dur>

处理音频的最大持续时间。这主要用于您想更改实时代码更改的响应时间时。值以秒为单位指定，例如，-b 1.5 表示 1.5 秒。

-d, --duration <duration>

从输入源读取的音频量，如果提供了起始时间，则从起始时间开始。指定为持续时间字符串 hh:mm:ss.ss，较大的部分可以省略，例如，1:0:0 表示 1 小时，1:30 表示 90 秒，1.5 表示 1.5 秒。

-f, --factor <factor>

拉伸因子；例如，5 表示减速 5 倍，0.2 表示加速 5 倍。默认为 1（无速度变化）。

-x, --fade <fade>

应用于输出音频的淡入/淡出持续时间。有关指定格式，请参阅 --duration。默认为 1（1 秒）。

--freq-kernel <freq-kernel>

rust 频率内核的路径。

-, --input <input>

#[no_mangle]
pub fn apply(elapsed_ms: usize, input: Vec<(f32, f32)>) -> Vec<(f32, f32)> {
    todo!() // Your code here
}

#[no_mangle]
pub fn apply(elapsed_ms: usize, input: Vec<(f32, f32)>) -> Vec<(f32, f32)> {
    return input
        .iter()
        .map(|(real, im)| (real * 2.0, im * 2.0))
        .collect();
}

cargo run --release -- \
    -r -f 1 --freq-kernel path/to/kernel.rs