﻿Polivoks — Emulasi synthesizer Polivoks: instalasi dan penggunaan
=================================================================

Format:
- Windows x64: Polivoks.vst3 (untuk DAW Anda) dan Polivoks.exe (aplikasi mandiri).
- macOS 10.15 atau lebih baru, Apple Silicon dan Intel: Polivoks.component (Audio Unit untuk
  Logic Pro, GarageBand, MainStage), Polivoks.vst3 (Ableton Live, Bitwig, Reaper, Cubase, dan
  DAW lainnya) serta Polivoks.app (aplikasi mandiri).


INSTALASI — WINDOWS
-------------------
1. Salin seluruh folder Polivoks.vst3 ke
   C:\Program Files\Common Files\VST3\
2. Ableton Live: Options -> Settings (Preferences di versi lama) -> Plug-Ins: aktifkan
   "Use VST3 Plug-In System Folders" lalu tekan "Rescan".
3. Plugin akan muncul di browser pada Plug-Ins -> VST3 (mungkin di dalam folder
   Ivan Abrosimov). Seret ke trek MIDI.

Tanpa DAW: Polivoks.exe adalah aplikasi mandiri dengan keyboard di layar.
Options -> Audio/MIDI Settings: pilih antarmuka audio dan keyboard MIDI Anda.

Windows mungkin menampilkan peringatan SmartScreen untuk Polivoks.exe
karena program ini tidak ditandatangani.
Klik "More info" -> "Run anyway".


INSTALASI — macOS
-----------------
1. Salin file:
     Polivoks.component -> ~/Library/Audio/Plug-Ins/Components/
     Polivoks.vst3      -> ~/Library/Audio/Plug-Ins/VST3/
   (Folder ~/Library tersembunyi: di Finder gunakan Go -> Go to Folder… lalu ketik jalurnya.)
2. Plugin ini belum ditandatangani dengan sertifikat Apple, sehingga macOS memblokir file yang
   diunduh dari internet. Jalankan perintah berikut sekali di Terminal:
     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. Cari Ivan Abrosimov -> Polivoks; jika
   gagal validasi, tekan "Reset & Rescan Selection".
   Plugin berada di AU Instruments -> Ivan Abrosimov -> Polivoks.
4. Ableton Live dan DAW lain di Mac menggunakan Polivoks.vst3 — aktifkan VST3 di pengaturan
   plugin DAW, lalu pindai ulang.


LOKASI PENYIMPANAN DATA ANDA
----------------------------
- Preset Anda (*.polivoks):
    Windows: Documents\Polivoks\Presets
    macOS:   ~/Library/Audio/Presets/Ivan Abrosimov/Polivoks
- Penilaian (ratings.xml), pemetaan MIDI Learn default (midi-map.xml), bahasa, dan penanda
  peluncuran pertama (settings.xml):
    Windows: %APPDATA%\Polivoks
    macOS:   ~/Library/Application Support/Polivoks


KONTROL
-------
- Semua knob ditata seperti pada panel aslinya. Klik dua kali mengembalikan knob ke nilai
  default.
- Panduan terperinci untuk setiap kontrol tersedia di dalam plugin: roda gigi di kanan atas ->
  tab PANDUAN (dalam ke-13 bahasa).
- Sakelar TAHAN (kanan bawah, di bagian amplifier; "ВКЛ." pada aslinya):
  atas (ON) — nada yang dimainkan tetap berbunyi setelah tuts dilepas; akor baru yang dimainkan
  setelah semua tuts dilepas menggantikan akor yang ditahan; saat dinyalakan, nada terakhir
  yang dimainkan akan berbunyi (jika belum ada yang dimainkan — senyap hingga nada pertama).
  Bawah (OFF) — mode normal.
- Sakelar OUTPUT: ON — suara diteruskan, OFF — plugin dibisukan.
- Roda modulasi (CC1) atau pedal ekspresi (CC11) berfungsi sebagai pedal cutoff, seperti pada
  aslinya.
- Pitch bend dan pedal sustain berfungsi, meskipun aslinya tidak memiliki keduanya.
- Input eksternal: plugin memiliki input audio, tetapi apakah DAW Anda mengirim audio ke input
  instrumen bergantung pada DAW-nya (belum diuji di Ableton). Level input diatur dengan knob
  EKSTERNAL; bersama TAHAN (mainkan satu nada), filter berfungsi sebagai efek.

Bilah atas (tidak ada pada aslinya)
Dari kiri ke kanan: PUSTAKA, ◀ nama preset ▶, penilaian, SIMPAN, DUKUNG PEMBUATNYA;
di kanan — TEMPO dan roda gigi.

Keyboard di bawah
- Seluruh rentang MIDI (C-1…G9), 4 oktaf di layar. Gulir dengan panah di kedua ujung, roda
  mouse, atau gestur touchpad. Klik tuts dengan mouse untuk memainkan nada.


BAHASA ANTARMUKA
----------------
- 13 bahasa: Inggris, Tionghoa, Hindi, Spanyol, Arab, Prancis, Bengali, Portugis, Indonesia,
  Urdu, Rusia, Jerman, Jepang.
- Pilih bahasa di jendela Tentang atau di pengaturan (roda gigi -> tab PANDUAN ->
  BAHASA ANTARMUKA). Yang diterjemahkan: label panel, bilah atas, pustaka, pengaturan, nama
  preset pabrik, panduan, serta nama dan nilai parameter yang ditampilkan DAW Anda. Logo
  "ПОЛИВОКС" tetap seperti pada aslinya.
- Beberapa DAW baru membaca ulang nama parameter setelah plugin atau proyek dimuat ulang.


TENTANG PLUGIN DAN MENDUKUNG PEMBUATNYA
---------------------------------------
- Saat setiap format dijalankan pertama kali (VST3 di DAW, AU di Logic, aplikasi mandiri),
  jendela Tentang akan muncul (secara default dalam bahasa Inggris; pilih bahasa di daftar di
  bagian atas jendela). Tutup dengan "Lanjutkan" — jendela ini tidak akan muncul lagi.
- Untuk membukanya lagi, tekan DUKUNG PEMBUATNYA di bilah atas: di sana tersedia info donasi
  dan kontak.
- Ketentuan penggunaan ada di folder License (file dalam bahasa Anda).


PRESET
------
- PUSTAKA (atau klik pada nama preset) membuka daftar. Klik baris untuk memuatnya. Filter di
  kiri: SEMUA / PABRIK / PENGGUNA, NILAI MINIMUM (1–5 bintang), pencarian berdasarkan nama dan
  deskripsi. Panah ◀ ▶ berpindah antarpreset sesuai filter tersebut.
- Penilaian: klik bintang untuk memberi nilai, klik bintang yang sama lagi untuk menghapus
  nilainya. Anda dapat menilai di daftar maupun di bilah atas. Penilaian berlaku bersama untuk
  semua instance plugin di komputer ini.
- SIMPAN menyimpan suara saat ini sebagai preset Anda sendiri. Jika nama sudah dipakai, preset
  akan ditimpa (akan muncul peringatan). Hapus preset Anda di pustaka: HAPUS, lalu
  YAKIN HAPUS?.
- Preset Anda berada di folder preset (lihat "Lokasi penyimpanan data Anda"; tombol
  BUKA FOLDER PRESET di pustaka). Anda dapat menyalinnya antarkomputer.
- Tanda bintang dan DIUBAH di samping nama berarti suara berbeda dari preset yang tersimpan.
- Preset tidak menyimpan tempo maupun sakelar OUTPUT.


TEMPO
-----
- PROYEK — tempo dan grid diambil dari DAW Anda. MANUAL — atur tempo di kolom sebelah kanan:
  seret ke atas/bawah (tahan Shift untuk langkah halus), gunakan roda mouse, atau klik dua kali
  lalu ketik angka (30–300 BPM).
- Aplikasi mandiri tidak memiliki proyek, sehingga hanya ada kolom tempo manual.
- Jika DAW tidak memberikan tempo, plugin menggunakan temponya sendiri.

Sinkron tempo
- Modulator: tombol SINKRON TEMPO di bawah knob kecepatan. Saat menyala, knob KECEPATAN menjadi
  DIVISI: dari 4 birama hingga 1/32, termasuk nilai bertitik (.) dan triplet (T). Tempo saat
  ini dan sumbernya ditampilkan di kanan. Dalam mode PROYEK, selama pemutaran fase modulator
  mengikuti grid proyek; saat berhenti, modulator tetap berjalan dengan tempo yang sama.
- Loop envelope: sakelar MODE ENV pada filter dan amplifier memiliki tiga posisi —
  Sekali / Loop / TEMPO. Pada posisi TEMPO, envelope dimulai ulang di setiap divisi grid (knob
  DIVISI di sebelahnya) selama tuts ditekan atau TAHAN menyala.


RODA GIGI DI KANAN ATAS
-----------------------
Sebuah panel terbuka di sisi kanan jendela (jendela menjadi lebih lebar). Tab:
- PANDUAN — terbuka pertama: pilihan bahasa dan panduan terperinci untuk semua parameter dalam
  bahasa yang dipilih (daftar isinya dapat diklik). Bahasa berlaku untuk seluruh plugin.
- MIDI — MIDI Learn (lihat di bawah).

MIDI Learn (roda gigi -> tab MIDI)
Banyak DAW (misalnya Ableton dengan Push) memetakan parameter ke kontroler secara otomatis —
dalam hal itu Anda tidak memerlukan MIDI Learn. Fitur ini berguna jika DAW Anda tidak
melakukannya.
1. Roda gigi -> tab MIDI -> AKTIFKAN MIDI LEARN — knob akan menyala.
2. Klik knob atau sakelar — kontrol tersebut akan terpilih.
3. Putar knob di kontroler Anda — pemetaan selesai, dan nomor CC muncul pada knob.
- Dalam mode ini, klik kanan kontrol yang sudah dipetakan untuk menghapus pemetaannya; daftar
  di kanan memiliki tanda silang untuk setiap pemetaan.
- Untuk keluar dari mode ini: KELUAR pada banner di atas panel, tombol di pengaturan, atau Esc.
- Pemetaan disimpan bersama proyek. SIMPAN SEBAGAI PEMETAAN DEFAULT — instance plugin baru akan
  dimulai dengan pemetaan tersebut (file midi-map.xml, lihat "Lokasi penyimpanan data Anda").
- Kontroler harus sampai ke trek MIDI yang berisi plugin (di Ableton: input trek adalah
  kontroler Anda, Monitor di In, atau Auto dengan record arm aktif). Jika kontroler yang sama
  ditetapkan di MIDI Map Ableton (Ctrl+M di Windows, Cmd+M di Mac), Ableton menangkapnya lebih
  dulu sebelum plugin.
- CC yang dipetakan hanya mengendalikan parameter tersebut: jika Anda memetakan CC1 (roda
  modulasi) atau CC64 (sustain), fungsi biasanya dinonaktifkan untuk plugin ini.
