﻿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ラーンのデフォルトの割り当て（midi-map.xml）、言語と初回起動フラグ
  （settings.xml）：
    Windows: %APPDATA%\Polivoks
    macOS:   ~/Library/Application Support/Polivoks


操作
----
- すべてのノブは、オリジナル機のパネルと同じ配置です。ダブルクリックすると、
  ノブがデフォルト値に戻ります。
- すべてのコントロールの詳しいガイドがプラグインに組み込まれています：
  右上の歯車アイコン -> 「ガイド」タブ（13言語すべてに対応）。
- 「ホールド」スイッチ（右下、アンプセクション内。オリジナル機の表記は「ВКЛ.」）：
  上（「ON」）：鍵盤を離しても、弾いたノートが鳴り続けます。
  すべての鍵盤を離してから新しいコードを弾くと、ホールド中のコードと入れ替わります。オンにすると、
  最後に弾いたノートが鳴ります（まだ何も弾いていない場合は、最初のノートを弾くまで無音です）。
  下（「OFF」）：通常モードです。
- 「出力」スイッチ：「ON」で音が出力され、「OFF」でプラグインがミュートされます。
- モジュレーションホイール（CC1）またはエクスプレッションペダル（CC11）は、
  オリジナル機と同様にカットオフペダルとして機能します。
- オリジナル機にはどちらもありませんが、ピッチベンドとサステインペダルも使用できます。
- 外部入力：プラグインにはオーディオ入力がありますが、
  インストゥルメントの入力にオーディオを送れるかどうかはDAWによって異なります
  （Abletonではまだ確認していません）。入力レベルは「外部入力」ノブで設定します。
  「ホールド」と組み合わせると（ノートを1つ弾きます）、フィルターをエフェクトとして使えます。

上部バー（オリジナル機にはありません）
左から順に：「ライブラリ」、◀ プリセット名 ▶、評価、「保存」、「作者を支援」。
右側に「テンポ」と歯車アイコン。

下部の鍵盤
- MIDIの全音域（C-1…G9）に対応し、画面には4オクターブが表示されます。両端の矢印、マウスホイール、
  またはタッチパッドのジェスチャーでスクロールします。鍵盤をマウスでクリックすると、
  ノートが鳴ります。


表示言語
--------
- 13言語：英語、中国語、ヒンディー語、スペイン語、アラビア語、フランス語、ベンガル語、ポルトガル語、
  インドネシア語、ウルドゥー語、ロシア語、ドイツ語、日本語。
- 言語はAboutウィンドウ、または設定（歯車アイコン -> 「ガイド」タブ -> 「表示言語」）で選択します。
  翻訳されるのは、パネルの表記、上部バー、ライブラリ、設定、ファクトリープリセット名、ガイド、
  およびDAWに表示されるパラメーター名と値です。「ПОЛИВОКС」ロゴは、オリジナル機のままです。
- 一部のDAWでは、プラグインまたはプロジェクトを再読み込みするまで、パラメーター名が更新されません。


プラグイン情報と作者への支援
----------------------------
- 各フォーマット（DAW上のVST3、Logic上のAU、スタンドアロン版）を初めて起動すると、
  Aboutウィンドウが表示されます（デフォルトは英語です。
  ウィンドウ上部のリストで言語を選択できます）。「続ける」で閉じると、以降は表示されません。
- もう一度開くには、上部バーの「作者を支援」を押します。寄付の方法と連絡先が記載されています。
- 利用規約はLicenseフォルダーにあります（お使いの言語のファイルがあります）。


プリセット
----------
- 「ライブラリ」（またはプリセット名をクリック）で一覧が開きます。行をクリックすると読み込まれます。
  左側のフィルター：「すべて」／「ファクトリー」／「ユーザー」、「最低評価」（星1〜5）、
  名前と説明による検索。◀ ▶の矢印は、これらのフィルターに沿ってプリセットを切り替えます。
- 評価：星をクリックすると評価され、同じ星をもう一度クリックすると評価が解除されます。
  評価は一覧でも上部バーでも付けられます。評価は、
  このコンピューター上のすべてのプラグインインスタンスで共有されます。
- 「保存」は、現在の音色をユーザープリセットとして保存します。同じ名前がすでにある場合、
  プリセットは上書きされます（警告が表示されます）。ユーザープリセットはライブラリで削除できます：
  「削除」、続けて「本当に削除？」を押します。
- ユーザープリセットはプリセットフォルダーに保存されます（「データの保存場所」を参照。
  ライブラリに「プリセットフォルダーを開く」ボタンがあります）。
  プリセットはコンピューター間でコピーできます。
- 名前の横のアスタリスクと「変更あり」は、音色が保存済みのプリセットと異なることを示します。
- プリセットには、テンポと「出力」スイッチは保存されません。


テンポ
------
- 「プロジェクト」：テンポとグリッドをDAWから取得します。「手動」：右側の欄でテンポを設定します。
  上下にドラッグする（Shiftを押しながらで微調整）、マウスホイールを使う、
  またはダブルクリックして数値を入力します（30〜300 BPM）。
- スタンドアロン版にはプロジェクトがないため、手動テンポの欄のみがあります。
- DAWがテンポを通知しない場合、プラグインは独自のテンポを使用します。

テンポ同期
- モジュレーター：レートノブの下にある「テンポ同期」ボタン。点灯中は「レート」ノブが
  「音価」に変わり、4小節から1/32まで、付点（.）と3連符（T）を含む値を選べます。
  現在のテンポとその取得元が右側に表示されます。「プロジェクト」モードでは、
  再生中はモジュレーターの位相がプロジェクトのグリッドに追従し、
  停止中はモジュレーターが同じテンポで動き続けます。
- エンベロープのループ：フィルターとアンプにある「ENVモード」スイッチは3ポジションです：
  「ワンショット」／「ループ」／「テンポ」。「テンポ」ポジションでは、鍵盤を押さえている間、
  または「ホールド」がオンの間、グリッドの音価（隣の「音価」ノブで設定）ごとに
  エンベロープが再スタートします。


右上の歯車アイコン
------------------
ウィンドウの右側にパネルが開きます（ウィンドウの幅が広がります）。タブ：
- 「ガイド」：最初に開くタブです。言語の選択と、
  選択した言語による全パラメーターの詳しいガイドがあります（目次はクリックできます）。
  言語はプラグイン全体に適用されます。
- 「MIDI」：MIDIラーン（下記参照）。

MIDIラーン（歯車アイコン -> 「MIDI」タブ）
多くのDAW（例：AbletonとPush）は、パラメーターを自動的にコントローラーに割り当てます。その場合、
MIDIラーンは必要ありません。DAWにそのような機能がない場合に役立ちます。
1. 歯車アイコン -> 「MIDI」タブ -> 「MIDIラーンをオン」を押すと、ノブが点灯します。
2. ノブまたはスイッチをクリックすると、それが選択されます。
3. コントローラーのノブを動かすと割り当てが完了し、ノブにCC番号が表示されます。
- このモードでは、割り当て済みのコントロールを右クリックすると、割り当てを解除できます。
  右側のリストには、割り当てごとに×印があります。
- モードを終了するには：パネル上部のバナーにある「終了」、設定内のボタン、またはEscを使います。
- 割り当てはプロジェクトと一緒に保存されます。「デフォルトの割り当てとして保存」を押すと、
  新しいプラグインインスタンスはその割り当てで起動します（ファイルmidi-map.xml。
  「データの保存場所」を参照）。
- コントローラーのMIDIが、プラグインのあるMIDIトラックに届いている必要があります（Abletonの場合：
  トラックの入力がお使いのコントローラーで、MonitorがIn、または録音アームをオンにした状態でAuto）。
  同じコントローラーがAbletonのMIDI Map（WindowsではCtrl+M、MacではCmd+M）で割り当てられている場合、
  Abletonがプラグインより先にそれを受け取ります。
- 割り当てたCCは、そのパラメーターだけを操作します。
  CC1（モジュレーションホイール）やCC64（サステイン）を割り当てると、
  このプラグインではそれらの通常の機能が無効になります。
