注意：对音高轮事件做出反应不是microwave的硬编码功能，而是用户可以自己定义的行为！

Fadeout模板

templates:
  - name: Fadeout
    value:
      Controller:
        kind: Damper
        map0: { Property: OffVelocitySet }
        map1: 0.0

Fadeout模板提供了一个描述波形应该被淡出的程度的值。它以以下方式工作：

• 当键被按下时，OffVelocitySet解析为0.0。因此，无论制音踏板状态如何，Controller也会解析为0.0。因此，波形保持稳定。
• 一旦键被释放，OffVelocitySet将解析为1.0。现在，Controller将在1.0（map0 = 制音踏板释放）和0.0（map1 = 制音踏板按下）之间进行插值。因此，除非按下制音踏板，否则波形将淡出。

注意：与前面的示例一样，对阻尼踏板的反应不是硬编码到 microwave 中的功能，而是一种可定制的行为。

EnvelopeL 和 EnvelopeR 模板

templates:
  - name: EnvelopeL
    value:
      Mul:
        - Controller:
            kind: Pan
            map0: { Property: Velocity }
            map1: 0.0
        - Controller:
            kind: Volume
            map0: 0.0
            map1: 0.25
  - name: EnvelopeR
    value:
      Mul:
        - Controller:
            kind: Pan
            map0: 0.0
            map1: { Property: Velocity }
        - Controller:
            kind: Volume
            map0: 0.0
            map1: 0.25

这些模板旨在提供一个合理的包络幅度 ≈ -18dB，该幅度对声像控制器、音量控制器和按下键的力度敏感。结果是以下量的乘积

• 声像控制器：从 1 到 0（左声道）或从 0 到 1（右声道）（≈ -6dB）
• 力度控制器：从 0 到 0.25（≈ -12dB）
• 键力度：从 0 到 1

注意：您不必将包络幅度与这些量绑定。例如，您可以替换声像控制器为平衡控制器。使用与您的用例相匹配的低频源。

envelopes 部分

每个波形都需要引用在配置文件 envelopes 部分中定义的包络。包络将内部波形缓冲区的结果传输到主音频管道，并限制波形的寿命。

包络定义通常如下所示

envelopes:
  - name: Piano
    in_buffer: 7
    out_buffers: [0, 1]
    out_levels: [EnvelopeL, EnvelopeR]
    fadeout: Fadeout
    attack_time: 0.01
    decay_rate: 1.0
    release_time: 0.25

具有

• name：包络的名称。
• in_buffer：包含应被包络的信号的波形缓冲区。
• out_buffers：应将包络信号写入的主音频管道的（立体声）缓冲区。
• out_levels：在写入主音频管道时应用的幅度因子。使用 EnvelopeL/EnvelopeR 作为值是有意义的，但用户可以选择他们认为有用的任何低频源表达式。
• fadeout：波形应淡出的量。重要：如果此值设置为常数 0.0，则波形将永远不会淡出，并继续消耗 CPU 资源，最终可能导致音频线程过载。
• attack_time：线性攻击时间（秒）。
• decay_rate：攻击阶段完成后，1/秒（逆半衰期）的指数衰减率。
• release_time：线性释放时间（秒）。当 fadeout 除以 release_time 乘以 dt 的积分达到 1.0 时，波形被认为耗尽。

stages 部分 / 主音频管道

stages 部分定义了在主音频线程运行时依次评估的章节。并非所有章节（例如 MidiOut）都贡献于主音频管道，但鉴于它们将被添加到用户界面，因此在这里声明它们也是合理的。其中一些阶段，即 输出目标，对音符输入敏感。在这种情况下，必须设置 note_input 属性，它可以具有以下值

• 前景：仅在指定的输出目标当前活动时激活音符。
• 背景：在接收到音符事件时始终激活音符。

磁控管合成器 – 创建您自己的波形

要启用模块化的 magnetron 合成器引擎，请添加以下阶段

stages:
  - stage_type: Magnetron
    note_input: Foreground
    num_buffers: # Number of waveform audio buffers
    waveforms:   # Waveform definitions

waveforms 部分

waveforms 部分定义了在触发波形时依次应用的波形渲染阶段。

您可以根据需要混合和匹配任意多个阶段，以创建您所需的定制声音。以下示例配置定义了一个意外发现的类似古钢琴音色的波形。

waveforms:
  - name: Funky Clavinet
    envelope: Piano
    stages:
      - stage_type: Generator
        generator_type: Oscillator
        out_buffer: 0
        out_level: 440.0
        oscillator_type: Sin
        frequency: WaveformPitch
      - stage_type: Processor
        in_buffer: 0
        out_buffer: 1
        processor_type: Oscillator
        oscillator_type: Triangle
        frequency: WaveformPitch
        modulation: ByFrequency
      - stage_type: Processor
        in_buffer: 1
        out_buffer: 7
        processor_type: Filter
        filter_type: HighPass2
        resonance:
          Mul:
            - WaveformPitch
            - Fader:
                movement: 10.0
                map0: 2.0
                map1: 4.0
          quality: 5.0

渲染声音时应用以下阶段：

1. 生成具有波形标称频率 F 和振幅 440 的正弦波。将此波形写入缓冲区 0。
2. 生成频率为 F 和振幅为 1.0 的三角波。以缓冲区 0 中存储的量对波形频率（以赫兹为单位）进行逐样本调制。将调制后的波形写入缓冲区 1。
3. 对缓冲区 1 中存储的样本应用二阶高通滤波器。高通滤波器的共振频率在 0.1 秒内从 2F 上升到 4F。将结果写入缓冲区 7。
4. 围绕缓冲区 7 中的信号包裹一个包络，并将包裹后的信号传输到主音频管道的缓冲区 0 和 1。这是在 envelopes 部分的 Piano 包络中定义的行为（见上文）。

要创建自己的波形，请以默认配置文件为起点，并尝试通过试错法编辑它。让 microwave 的错误信息引导您找到有效的配置。

Fluid 合成器

对于播放采样声音，您需要在阶段部分添加一个 Fluid 阶段。

以下示例启动了一个 Fluid 阶段，该阶段渲染指定声音字体文件的内容。渲染的音频将被写入主音频管道的音频缓冲区 0 和 1。

stages:
  - stage_type: Fluid
    out_buffers: [0, 1]
    note_input: Foreground
    soundfont_location: <soundfont-location>

SF3 支持

如果您想使用压缩的 sf3 文件，您需要使用启用 sf3 功能的 microwave 进行编译。请注意，启动将需要更长的时间，因为需要首先解压缩声音字体。

效果 – 创建您自己的

要添加您自己的定制效果，请添加一个带有 processor_type: Effect 的 StereoProcessor 阶段。以下配置将向主音频管道添加一个旋转扬声器效果阶段。

stages:
  - stage_type: StereoProcessor
    in_buffers: [4, 5]
    out_buffers: [14, 15]
    processor_type: Effect
    effect_type: RotarySpeaker
    buffer_size: 100000
    gain:
      Controller:
        kind: Sound9
        map0: 0.0
        map1: 0.5
    rotation_radius: 20.0
    speed:
      Fader:
        movement:
          Controller:
            kind: Sound10
            map0: -2.0
            map1: 1.0
        map0: 1.0
        map1: 7.0

该配置定义了以下属性：

• in_buffers：缓冲区 4 和 5 用于作为效果输入。
• out_buffers：缓冲区 14 和 15 用于作为效果输出。
• buffer_size：固定延迟缓冲区大小为 100000 个样本。
• gain：输入增益范围为 0.0 到 0.5。输入增益可以通过 F9 键或 MIDI CCN 78 控制。
• rotation_radius：旋转半径为 20 厘米。
• speed：旋转速度范围为 1 Hz 到 7 Hz。所选速度由 Fader 组件确定，该组件将在两个值之间逐渐淡入淡出。摇杆的运动由 F10 键或 MIDI CCN 79 控制，范围从 -2.0/s 到 1.0/s，以模拟旋转扬声器的减速和加速。

MIDI 出

要启用通过外部 MIDI 设备播放，请将以下阶段添加到音频管道中

stages:
  - stage_type: MidiOut
    note_input: Foreground
    out_device: <midi-device>
    out_channel: 0
    num_out_channels: 9
    device_id: 127
    tuning_program: 0
    tuning_method: <tuning-method>

可用的调音方法有 full、full-rt、octave-1、octave-1-rt、octave-2、octave-2-rt、fine-tuning 和 pitch-bend。

要检索可用 MIDI 设备的列表，请运行

microwave devices

MIDI 入

要监听来自外部MIDI设备的事件，您需要指定输入设备的名称

microwave devices # List MIDI devices
microwave run --midi-in name-of-my-device
microwave run --midi-in "name of my device" # If the device name contains spaces

要使 microwave 能够接收来自多通道MIDI源（如Lumatone）的事件，您需要扩展键范围并定义通道特定的音符偏移。

实时交互

您可以使用鼠标指针、触摸板或任何MIDI控制更改消息源实时控制您的波形和效果。

以下示例阶段定义了一个谐振低通滤波器，其谐振频率可以通过2,000到10,000 Hz范围内的MIDI调制轮/杆进行控制。

stage_type: Processor
in_buffer: 0
out_buffer: 7
processor_type: Filter
filter_type: LowPass2
resonance:
  Controller:
    kind: Modulation
    map0: 2000.0
    map1: 10000.0
quality: 5.0

如果您想使用鼠标的垂直轴进行声音控制，请使用 Breath 控制器。

resonance:
  Controller:
    kind: Breath
    map0: 2000.0
    map1: 10000.0

如果您想使用触摸板进行多声部声音控制，请使用 KeyPressure 属性。

resonance:
  Linear:
    input:
      Property: KeyPressure
    map0: 2000.0
    map1: 10000.0

注意：虽然 Controller 值已缩放到0..1（在音调弯曲事件的情况下为-1..1），并且需要范围映射（map0/map1 参数），但 Property 值可以直接解析。如果需要，可以使用 Mul 或 Linear 进行重新缩放。

更多设置

命令行允许您设置采样率、缓冲区大小和其他启动参数。要打印完整列表的可用命令行参数，请运行

microwave run help

# 31-EDO Lumatone preset centered around D4 (62, Layout offset -5)
microwave ref-note 62 --root 57 --luma-offs 31 --lo-key 0 --up-key 155 --midi-in lumatone steps 1:31:2

浏览器应用程序

浏览器应用程序允许您使用 microwave 及其所有功能，而无需安装任何额外的软件。只需在您的网络浏览器中打开 Web Launcher。

Web Launcher 充当命令行终端，允许您使用前几节中显示的命令行参数启动 microwave。

要与浏览器应用程序读取和写入的文件进行交互，请打开 文件管理器，它便于您在文件系统和应用程序之间交换文件。

注意：由 microwave 管理的文件存储在浏览器本地索引数据库中。不会与远程服务器交换任何数据！

帮助

要获取完整的命令行选项列表，请运行

microwave help

许可协议

microwave 静态链接到 OxiSynth 以提供音源渲染功能。这使得 二进制可执行文件 成为 OxiSynth 的派生作品。OxiSynth 根据 GNU Lesser General Public License，版本 2.1 许可。