﻿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
  (सस्टेन) मैप करते हैं, तो इस प्लगइन के लिए उनका सामान्य काम बंद हो जाता है।
