﻿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 ইন্টারনেট থেকে ডাউনলোড করা
   ফাইল ব্লক করে। 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। 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 (যেমন Push-সহ Ableton) নিজেই প্যারামিটারগুলো কন্ট্রোলারে ম্যাপ করে — তখন 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 (সাসটেইন) ম্যাপ
  করলে এই প্লাগইনের জন্য তাদের স্বাভাবিক কাজ বন্ধ হয়ে যায়।
