﻿Polivoks — Polivoks 合成器仿真：安装与使用
==========================================

支持格式：
- Windows x64：Polivoks.vst3（用于 DAW）和 Polivoks.exe（独立程序）。
- macOS 10.15 或更高版本，Apple Silicon 和 Intel：Polivoks.component（用于 Logic Pro、GarageBand、
  MainStage 的 Audio Unit）、Polivoks.vst3（用于 Ableton Live、Bitwig、Reaper、
  Cubase 及其他 DAW）以及 Polivoks.app（独立程序）。


安装 — Windows
--------------
1. 将整个 Polivoks.vst3 文件夹复制到
   C:\Program Files\Common Files\VST3\
2. Ableton Live：Options -> Settings（旧版本中为 Preferences） -> Plug-Ins：
   打开“Use VST3 Plug-In System Folders”，然后点击“Rescan”。
3. 插件会出现在浏览器的 Plug-Ins -> VST3 下（可能位于 Ivan Abrosimov 文件夹中）。
   将其拖到 MIDI 轨道上。

不使用 DAW：Polivoks.exe 是带屏幕键盘的独立程序。
Options -> Audio/MIDI Settings：选择您的音频接口和 MIDI 键盘。

由于程序未签名，Windows 可能会对 Polivoks.exe 显示 SmartScreen 警告。
请点击“更多信息”（More info） -> “仍要运行”（Run anyway）。


安装 — macOS
------------
1. 复制文件：
     Polivoks.component -> ~/Library/Audio/Plug-Ins/Components/
     Polivoks.vst3      -> ~/Library/Audio/Plug-Ins/VST3/
   （~/Library 文件夹是隐藏的：在 Finder 中选择“前往”（Go） -> “前往文件夹…”（Go to Folder…），
   然后输入路径。）
2. 本插件尚未使用 Apple 证书签名，因此 macOS 会阻止从互联网下载的文件。
   请在“终端”中运行以下命令一次：
     xattr -dr com.apple.quarantine ~/Library/Audio/Plug-Ins/Components/Polivoks.component
     xattr -dr com.apple.quarantine ~/Library/Audio/Plug-Ins/VST3/Polivoks.vst3
     xattr -dr com.apple.quarantine /path/to/Polivoks.app
3. Logic Pro：Logic Pro -> Settings -> Plug-in Manager。找到 Ivan Abrosimov -> Polivoks；
   如果它未通过验证，请点击“Reset & Rescan Selection”。
   插件位于 AU Instruments -> Ivan Abrosimov -> Polivoks。
4. Mac 上的 Ableton Live 及其他 DAW 使用 Polivoks.vst3——请在 DAW 的插件设置中启用 VST3 并重新扫描。


数据存储位置
------------
- 您的预设（*.polivoks）：
    Windows: Documents\Polivoks\Presets
    macOS:   ~/Library/Audio/Presets/Ivan Abrosimov/Polivoks
- 评分（ratings.xml）、默认 MIDI Learn 映射（midi-map.xml）、语言和首次启动标记（settings.xml）：
    Windows: %APPDATA%\Polivoks
    macOS:   ~/Library/Application Support/Polivoks


控制
----
- 所有旋钮的布局与原机面板相同。双击可将旋钮恢复为默认值。
- 插件内置了每个控件的详细指南：右上角齿轮 -> 「使用指南」标签页（提供全部 13 种语言）。
- 「保持」开关（右下方，放大器区域；原机上标为“ВКЛ.”）：
  向上（「开」）——松开琴键后，弹奏的音符继续发声；松开所有琴键后再弹的新和弦会替换正在保持的和弦；
  打开时，最后弹奏的音符会发声（如果尚未弹奏任何音符，则在弹奏第一个音符之前保持静音）。
  向下（「关」）——普通模式。
- 「输出」开关：「开」——声音通过，「关」——插件静音。
- 调制轮（CC1）或表情踏板（CC11）用作截止频率踏板，与原机相同。
- 弯音和延音踏板均可使用，尽管原机两者都没有。
- 外部输入：插件带有音频输入，
  但 DAW 是否会把音频送入乐器插件的输入取决于 DAW（尚未在 Ableton 中验证）。输入电平由
  「外部输入」旋钮设置；配合「保持」（弹奏一个音符）使用时，滤波器可用作效果器。

顶部栏（原机没有）
从左到右：「预设库」、◀ 预设名称 ▶、评分、「保存」、「支持作者」；
右侧为「节拍」和齿轮。

底部键盘
- 完整 MIDI 音域（C-1…G9），屏幕上显示 4 个八度。可用两端的箭头、鼠标滚轮或触控板手势滚动。
  用鼠标点击琴键即可弹奏音符。


界面语言
--------
- 13 种语言：英语、中文、印地语、西班牙语、阿拉伯语、法语、孟加拉语、葡萄牙语、印尼语、乌尔都语、
  俄语、德语、日语。
- 可在“关于”窗口或设置中选择（齿轮 -> 「使用指南」标签页 -> 「界面语言」）。翻译内容包括：面板标签、
  顶部栏、预设库、设置、出厂预设名称、使用指南，以及 DAW 显示的参数名称和数值。
  “ПОЛИВОКС”标志保持原机样式。
- 某些 DAW 只有在重新加载插件或工程后才会重新读取参数名称。


关于插件与支持作者
------------------
- 每种格式（DAW 中的 VST3、Logic 中的 AU、独立程序）首次启动时，会出现“关于”窗口（默认为英文；
  可在窗口顶部的列表中选择语言）。点击「继续」关闭后，它将不再出现。
- 如需再次打开，请点击顶部栏中的「支持作者」：其中有捐助方式和联系方式。
- 使用条款位于 License 文件夹中（有您所用语言的文件）。


预设
----
- 「预设库」（或点击预设名称）可打开列表。点击某一行即可载入。左侧的筛选条件：
  「全部」/「出厂」/「用户」、「最低评分」（1–5 星）、按名称和描述搜索。
  ◀ ▶ 箭头按这些筛选条件切换预设。
- 评分：点击星星进行评分，再次点击同一颗星可清除评分。可以在列表和顶部栏中评分。
  评分在这台电脑上的所有插件实例之间共享。
- 「保存」将当前音色存为您自己的预设。如果名称已被占用，预设将被覆盖（会有警告提示）。
  在预设库中删除您的预设：「删除」，然后「确定删除？」。
- 您的预设位于预设文件夹中（参见“数据存储位置”；预设库中有「打开预设文件夹」按钮）。
  可以在电脑之间复制这些预设。
- 名称旁的星号和「已修改」表示声音与已保存的预设不同。
- 预设不保存节拍和「输出」开关。


节拍
----
- 「工程」——节拍和网格来自 DAW。「手动」——在右侧的栏中设置节拍：上下拖动（按住 Shift 可微调）、
  滚动鼠标滚轮，或双击后输入数值（30–300 BPM）。
- 独立程序没有工程，因此只有手动节拍栏。
- 如果 DAW 不提供节拍信息，插件将使用自己的节拍。

节拍同步
- 调制器：速率旋钮下方的「节拍同步」按钮。点亮时，「速率」旋钮变为「拍值」：从 4 小节到 1/32，
  包括附点 (.) 和三连音 (T) 值。右侧显示当前节拍及其来源。在「工程」模式下播放时，
  调制器的相位跟随工程网格；停止时，调制器继续以相同节拍运行。
- 包络循环：滤波器和放大器中的「包络模式」开关有三个位置——「单次」/「循环」/「节拍」。
  在「节拍」位置，只要按住琴键或「保持」处于打开状态，包络就会在每个网格拍值处重新开始
  （由旁边的「拍值」旋钮设置）。


右上角齿轮
----------
窗口右侧会打开一个面板（窗口变宽）。标签页：
- 「使用指南」——最先打开：语言选择，以及以所选语言提供的全部参数详细指南（目录可点击）。
  所选语言作用于整个插件。
- 「MIDI」——MIDI Learn（见下文）。

MIDI Learn（齿轮 -> 「MIDI」标签页）
许多 DAW（例如 Ableton 配合 Push）会自行将参数映射到控制器——这时就不需要 MIDI Learn。
它适用于 DAW 不提供此功能的情况。
1. 齿轮 -> 「MIDI」标签页 -> 「开启 MIDI LEARN」——旋钮会高亮显示。
2. 点击一个旋钮或开关——它将被选中。
3. 转动控制器上的旋钮——映射完成，旋钮上会显示 CC 编号。
- 在此模式下，右键单击已映射的控件可删除其映射；右侧列表中每个映射都有一个叉号。
- 退出此模式：点击面板上方横幅中的「退出」、设置中的按钮，或按 Esc。
- 映射随工程一起保存。「保存为默认映射」——新的插件实例将以这些映射启动（文件 midi-map.xml，
  参见“数据存储位置”）。
- 控制器信号必须到达加载了插件的 MIDI 轨道（在 Ableton 中：轨道输入为您的控制器，Monitor 设为 In，
  或在开启录音预备时设为 Auto）。如果同一控制器已在 Ableton 的 MIDI Map（Windows 上为 Ctrl+M，
  Mac 上为 Cmd+M）中分配，Ableton 会先于插件接收它。
- 已映射的 CC 只控制该参数：如果映射了 CC1（调制轮）或 CC64（延音），
  它们的常规功能在此插件中将被禁用。
