﻿Polivoks – Emulation des Synthesizers Polivoks: Installation und Bedienung
==========================================================================

Formate:
- Windows x64: Polivoks.vst3 (für Ihre DAW) und Polivoks.exe (Standalone-App).
- macOS 10.15 oder neuer, Apple Silicon und Intel: Polivoks.component (Audio Unit für Logic Pro,
  GarageBand, MainStage), Polivoks.vst3 (Ableton Live, Bitwig, Reaper, Cubase und andere DAWs)
  und Polivoks.app (Standalone-App).


INSTALLATION – WINDOWS
----------------------
1. Kopieren Sie den gesamten Ordner Polivoks.vst3 nach
   C:\Program Files\Common Files\VST3\
2. Ableton Live: Options -> Settings (in älteren Versionen Preferences) -> Plug-Ins:
   Aktivieren Sie „Use VST3 Plug-In System Folders“ und klicken Sie auf „Rescan“.
3. Das Plugin erscheint im Browser unter Plug-Ins -> VST3 (eventuell im Ordner
   Ivan Abrosimov). Ziehen Sie es auf eine MIDI-Spur.

Ohne DAW: Polivoks.exe ist eine Standalone-App mit Bildschirmtastatur.
Options -> Audio/MIDI Settings: Wählen Sie Ihr Audio-Interface und Ihr MIDI-Keyboard.

Windows zeigt für Polivoks.exe möglicherweise eine SmartScreen-Warnung an, da das Programm nicht
signiert ist. Klicken Sie auf „Weitere Informationen“ (More info) -> „Trotzdem ausführen“
(Run anyway).


INSTALLATION – macOS
--------------------
1. Kopieren Sie die Dateien:
     Polivoks.component -> ~/Library/Audio/Plug-Ins/Components/
     Polivoks.vst3      -> ~/Library/Audio/Plug-Ins/VST3/
   (Der Ordner ~/Library ist ausgeblendet: Wählen Sie im Finder „Gehe zu“ -> „Gehe zum Ordner …“
   (Go -> Go to Folder…) und geben Sie den Pfad ein.)
2. Das Plugin ist noch nicht mit einem Apple-Zertifikat signiert, daher blockiert macOS aus dem
   Internet geladene Dateien. Führen Sie diese Befehle einmalig im Terminal aus:
     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. Suchen Sie Ivan Abrosimov -> Polivoks;
   falls die Validierung fehlgeschlagen ist, klicken Sie auf „Reset & Rescan Selection“.
   Das Plugin finden Sie unter AU Instruments -> Ivan Abrosimov -> Polivoks.
4. Ableton Live und andere DAWs auf dem Mac verwenden Polivoks.vst3 – aktivieren Sie VST3 in den
   Plug-in-Einstellungen der DAW und starten Sie einen erneuten Scan.


WO IHRE DATEN GESPEICHERT WERDEN
--------------------------------
- Ihre Presets (*.polivoks):
    Windows: Documents\Polivoks\Presets
    macOS:   ~/Library/Audio/Presets/Ivan Abrosimov/Polivoks
- Bewertungen (ratings.xml), Standard-Zuweisungen für MIDI Learn (midi-map.xml), Sprache und die
  Markierung des ersten Starts (settings.xml):
    Windows: %APPDATA%\Polivoks
    macOS:   ~/Library/Application Support/Polivoks


BEDIENELEMENTE
--------------
- Alle Regler sind wie auf der Frontplatte des Originals angeordnet. Ein Doppelklick setzt einen
  Regler auf seinen Standardwert zurück.
- Eine ausführliche Anleitung zu jedem Bedienelement ist im Plugin integriert: Zahnrad oben
  rechts -> Tab ANLEITUNG (in allen 13 Sprachen).
- Schalter HALTEN (unten rechts, in der Verstärker-Sektion; auf dem Original „ВКЛ.“):
  oben (EIN) – gespielte Noten klingen weiter, nachdem Sie die Tasten losgelassen haben; ein
  neuer Akkord, gespielt nach dem Loslassen aller Tasten, ersetzt den gehaltenen; beim
  Einschalten klingt die zuletzt gespielte Note (wurde noch nichts gespielt – Stille bis zur
  ersten Note). Unten (AUS) – normaler Modus.
- Schalter AUSGANG: EIN – der Klang wird ausgegeben, AUS – das Plugin ist stummgeschaltet.
- Das Modulationsrad (CC1) oder ein Expression-Pedal (CC11) dient wie beim Original als
  Cutoff-Pedal.
- Pitch-Bend und Sustain-Pedal funktionieren, obwohl das Original keines von beiden hatte.
- Externer Eingang: Das Plugin hat einen Audioeingang, ob Ihre DAW aber Audio an den Eingang
  eines Instruments sendet, hängt von der DAW ab (in Ableton noch nicht getestet). Der
  Eingangspegel wird mit dem Regler EXTERN eingestellt; zusammen mit HALTEN (eine Note spielen)
  arbeitet der Filter als Effekt.

Obere Leiste (nicht beim Original)
Von links nach rechts: BIBLIOTHEK, ◀ Preset-Name ▶, Bewertung, SPEICHERN, AUTOR UNTERSTÜTZEN;
rechts – TEMPO und das Zahnrad.

Tastatur unten
- Gesamter MIDI-Bereich (C-1…G9), 4 Oktaven auf dem Bildschirm. Scrollen Sie mit den Pfeilen an
  den Rändern, mit dem Mausrad oder mit einer Touchpad-Geste. Klicken Sie mit der Maus auf eine
  Taste, um eine Note zu spielen.


SPRACHE DER OBERFLÄCHE
----------------------
- 13 Sprachen: Englisch, Chinesisch, Hindi, Spanisch, Arabisch, Französisch, Bengalisch,
  Portugiesisch, Indonesisch, Urdu, Russisch, Deutsch, Japanisch.
- Die Sprache wählen Sie im Fenster „Über Polivoks“ oder in den Einstellungen (Zahnrad -> Tab
  ANLEITUNG -> SPRACHE DER OBERFLÄCHE). Übersetzt werden: die Beschriftungen der Oberfläche, die
  obere Leiste, die Bibliothek, die Einstellungen, die Namen der Werks-Presets, die Anleitung
  sowie die Namen und Werte der Parameter, die Ihre DAW anzeigt. Das Logo „ПОЛИВОКС“ bleibt wie
  auf dem Original.
- Manche DAWs lesen Parameternamen erst neu ein, nachdem das Plugin oder das Projekt neu geladen
  wurde.


ÜBER DAS PLUGIN UND UNTERSTÜTZUNG DES AUTORS
--------------------------------------------
- Beim ersten Start jedes Formats (VST3 in einer DAW, AU in Logic, Standalone-App) erscheint das
  Fenster „Über Polivoks“ (standardmäßig auf Englisch; die Sprache wählen Sie in der Liste oben
  im Fenster). Schließen Sie es mit „Weiter“ – danach erscheint es nicht mehr.
- Um es erneut zu öffnen, klicken Sie in der oberen Leiste auf AUTOR UNTERSTÜTZEN: Dort finden
  Sie Spendenmöglichkeiten und Kontaktdaten.
- Die Nutzungsbedingungen befinden sich im Ordner License (eine Datei in Ihrer Sprache).


PRESETS
-------
- BIBLIOTHEK (oder ein Klick auf den Preset-Namen) öffnet die Liste. Ein Klick auf eine Zeile
  lädt das Preset.
  Filter links: ALLE / WERK / BENUTZER, MINDESTBEWERTUNG (1–5 Sterne), Suche nach Name und
  Beschreibung. Die Pfeile ◀ ▶ blättern unter Berücksichtigung dieser Filter durch die Presets.
- Bewertung: Ein Klick auf einen Stern vergibt die Bewertung, ein erneuter Klick auf denselben
  Stern löscht sie.
  Sie können in der Liste und in der oberen Leiste bewerten. Die Bewertungen gelten gemeinsam für
  alle Instanzen des Plugins auf diesem Computer.
- SPEICHERN sichert den aktuellen Sound als eigenes Preset. Ist der Name bereits vergeben, wird
  das Preset überschrieben (ein Warnhinweis macht Sie darauf aufmerksam). Eigene Presets löschen
  Sie in der Bibliothek: LÖSCHEN, dann LÖSCHEN?.
- Ihre Presets liegen im Preset-Ordner (siehe „Wo Ihre Daten gespeichert werden“; Schaltfläche
  PRESET-ORDNER ÖFFNEN in der Bibliothek). Sie können sie zwischen Computern kopieren.
- Ein Sternchen und GEÄNDERT neben dem Namen bedeuten, dass der Sound vom gespeicherten Preset
  abweicht.
- Presets speichern weder das Tempo noch den Schalter AUSGANG.


TEMPO
-----
- PROJEKT – Tempo und Raster kommen aus Ihrer DAW. MANUELL – stellen Sie das Tempo im Feld rechts
  ein: nach oben/unten ziehen (mit gedrückter Shift-Taste in feinen Schritten), das Mausrad
  verwenden oder doppelklicken und eine Zahl eingeben (30–300 BPM).
- Die Standalone-App hat kein Projekt, daher gibt es dort nur das Feld für das manuelle Tempo.
- Meldet die DAW kein Tempo, verwendet das Plugin sein eigenes Tempo.

Tempo-Synchronisation
- Modulator: die Taste TEMPO-SYNC unter dem Regler RATE. Leuchtet sie, wird aus dem Regler RATE
  der Regler NOTENWERT: von 4 Takten bis 1/32, einschließlich punktierter (.) und triolischer (T)
  Werte. Das aktuelle Tempo und seine Quelle werden rechts angezeigt. Im Modus PROJEKT folgt die
  Phase des Modulators während der Wiedergabe dem Raster des Projekts; im Stillstand läuft der
  Modulator im selben Tempo weiter.
- Hüllkurven-Loops: Der Schalter ENV-MODUS im Filter und im Verstärker hat drei Stellungen –
  Einmalig / Loop / TEMPO. In der Stellung TEMPO startet die Hüllkurve bei jedem Rasterschritt
  neu (Regler NOTENWERT daneben), solange eine Taste gedrückt oder HALTEN eingeschaltet ist.


ZAHNRAD OBEN RECHTS
-------------------
Auf der rechten Seite des Fensters öffnet sich ein Bereich (das Fenster wird breiter). Tabs:
- ANLEITUNG – öffnet sich zuerst: Sprachauswahl und eine ausführliche Anleitung zu allen
  Parametern in der gewählten Sprache (das Inhaltsverzeichnis ist anklickbar). Die Sprache gilt
  für das gesamte Plugin.
- MIDI – MIDI Learn (siehe unten).

MIDI Learn (Zahnrad -> Tab MIDI)
Viele DAWs (zum Beispiel Ableton mit Push) weisen Parameter selbst einem Controller zu – dann
brauchen Sie MIDI Learn nicht. Es hilft dort, wo Ihre DAW das nicht tut.
1. Zahnrad -> Tab MIDI -> MIDI LEARN EINSCHALTEN – die Regler leuchten auf.
2. Klicken Sie auf einen Regler oder Schalter – er wird ausgewählt.
3. Bewegen Sie einen Regler an Ihrem Controller – die Zuweisung ist erstellt, und die CC-Nummer
   erscheint auf dem Regler.
- In diesem Modus entfernt ein Rechtsklick auf ein zugewiesenes Bedienelement dessen Zuweisung;
  in der Liste rechts hat jede Zuweisung ein Kreuz.
- Modus verlassen: BEENDEN auf dem Banner über der Oberfläche, die Schaltfläche in den
  Einstellungen oder Esc.
- Zuweisungen werden mit dem Projekt gespeichert. ALS STANDARD-ZUWEISUNGEN SPEICHERN – neue
  Instanzen des Plugins starten mit diesen Zuweisungen (Datei midi-map.xml, siehe „Wo Ihre Daten
  gespeichert werden“).
- Der Controller muss die MIDI-Spur mit dem Plugin erreichen (in Ableton: Der Spureingang ist Ihr
  Controller, Monitor steht auf In oder auf Auto bei aktivierter Aufnahmebereitschaft). Ist
  derselbe Controller in Abletons MIDI Map (Ctrl+M unter Windows, Cmd+M auf dem Mac) zugewiesen,
  greift Ableton ihn vor dem Plugin ab.
- Ein zugewiesener CC steuert nur den Parameter: Wenn Sie CC1 (Modulationsrad) oder CC64
  (Sustain) zuweisen, ist deren übliche Funktion für dieses Plugin deaktiviert.
