FamiStudio CLI 音频导出通道掩码使用指南

通道掩码的十六进制表示法

在FamiStudio命令行工具中，使用-wav-export-channels参数进行音频导出时，通道选择采用的是十六进制掩码表示法。这一设计可能让不熟悉十六进制的用户感到困惑，特别是当需要导出特定NES音频通道时。

NES音频通道的掩码值

NES音效芯片包含5个主要音频通道，每个通道对应的掩码值如下：

1. 方波1通道：掩码值为0x01（十进制1）
2. 方波2通道：掩码值为0x02（十进制2）
3. 三角波通道：掩码值为0x04（十进制4）
4. 噪声通道：掩码值为0x08（十进制8）
5. DPCM采样通道：掩码值为0x10（十进制16）

组合通道导出方法

要同时导出多个通道，只需将各通道的掩码值相加：

• 导出方波1和方波2通道：0x01 + 0x02 = 0x03
• 导出三角波和噪声通道：0x04 + 0x08 = 0x0C
• 导出所有通道：0x01 + 0x02 + 0x04 + 0x08 + 0x10 = 0x1F

常见问题解析

许多用户初次使用时可能会误认为掩码值是简单的十进制序列（1,2,4,8,16...），而实际上这是一个二进制位掩码的十六进制表示。例如：

• 单独导出DPCM通道的正确掩码是0x10（十进制16），而不是用户最初猜测的0x10会导致导出多个通道
• 掩码0x0A（十进制10）实际上对应的是方波2和DPCM通道的组合（0x02 + 0x08）

实用技巧

对于不熟悉十六进制的用户，可以采用以下方法确定正确的掩码值：

1. 将需要的通道对应的二进制位置1
2. 从右到左依次为：方波1、方波2、三角波、噪声、DPCM
3. 将二进制数转换为十六进制

例如，要导出方波1和DPCM通道： 二进制表示为10001（DPCM-噪声-三角波-方波2-方波1） 转换为十六进制就是0x11（十进制17）

总结

理解FamiStudio CLI音频导出通道掩码的十六进制表示法对于精确控制输出结果至关重要。通过掌握各通道对应的掩码值及其组合方式，用户可以灵活地导出任意组合的音频通道，满足各种音频处理和调试需求。