﻿Polivoks — محاكاة لجهاز التوليف Polivoks: التثبيت والاستخدام
============================================================

الصيغ:
- نظام Windows x64: Polivoks.vst3 (لبرنامج DAW لديك) وPolivoks.exe (تطبيق مستقل).
- نظام macOS 10.15 أو أحدث، بمعالجات Apple Silicon وIntel: Polivoks.component (صيغة Audio Unit
  لبرامج Logic Pro وGarageBand وMainStage)، و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 -> Plug-Ins (في الإصدارات الأقدم Preferences بدلًا
   من Settings)، وفعّل "Use VST3 Plug-In System Folders" ثم اضغط "Rescan".
3. ستظهر الإضافة في المتصفح ضمن Plug-Ins -> VST3 (ربما داخل مجلد Ivan Abrosimov).
   اسحبها إلى مسار MIDI.

بدون برنامج DAW: Polivoks.exe تطبيق مستقل مزوّد بلوحة مفاتيح على الشاشة.
من Options -> Audio/MIDI Settings: اختر واجهة الصوت ولوحة مفاتيح MIDI لديك.

قد يعرض Windows تحذير SmartScreen بشأن Polivoks.exe لأن البرنامج غير موقَّع.
انقر "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. يستخدم Ableton Live وبرامج DAW الأخرى على Mac الإضافة Polivoks.vst3 — فعّل VST3 في إعدادات
   الإضافات في برنامج DAW وأعد الفحص.


أين تُحفظ بياناتك
-----------------
- إعداداتك المسبقة (*.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


عناصر التحكم
------------
- جميع المقابض موزّعة كما في اللوحة الأصلية. النقر المزدوج يعيد المقبض إلى قيمته الافتراضية.
- تتضمن الإضافة دليلًا مفصّلًا لكل عنصر تحكم: الترس في أعلى اليمين -> تبويب «الدليل» (بجميع
  اللغات الثلاث عشرة).
- مفتاح «تثبيت النغمات» (أسفل اليمين، في قسم المضخِّم؛ وعلى الجهاز الأصلي "ВКЛ."): للأعلى
  («تشغيل») — تستمر النغمات التي عزفتها بعد ترك المفاتيح؛ والكورد الجديد الذي تعزفه بعد ترك كل
  المفاتيح يحلّ محل الكورد المثبَّت؛ وعند تشغيله تُسمع آخر نغمة عُزفت (وإن لم يُعزف شيء بعد —
  فصمت حتى أول نغمة). للأسفل («إيقاف») — الوضع العادي.
- مفتاح «الخرج»: «تشغيل» — يمر الصوت، «إيقاف» — تُكتم الإضافة.
- تعمل عجلة التعديل (CC1) أو دوّاسة التعبير (CC11) كدوّاسة القطع، كما في الجهاز الأصلي.
- يعمل ثني الطبقة ودوّاسة الاستدامة، مع أن الجهاز الأصلي لم يكن يحتوي على أيٍّ منهما.
- الدخل الخارجي: للإضافة مدخل صوتي، لكن إرسال برنامج DAW للصوت إلى مدخل الآلة يتوقف على
  البرنامج نفسه (لم يُختبر ذلك بعد في Ableton). يُضبط مستوى الدخل بمقبض «خارجي»؛ ومع
  «تثبيت النغمات» (اعزف نغمة واحدة) يعمل المرشِّح كمؤثر صوتي.

الشريط العلوي (غير موجود في الأصل)
من اليسار إلى اليمين: «المكتبة»، ◀ اسم الإعداد المسبق ▶، التقييم، «حفظ»، «ادعم المطوّر»؛ وعلى
اليمين — «الإيقاع» والترس.

لوحة المفاتيح في الأسفل
- نطاق MIDI الكامل (C-1…G9)، و4 أوكتافات على الشاشة. مرّر بالأسهم على الطرفين أو بعجلة الفأرة
  أو بإيماءة على لوحة اللمس. انقر مفتاحًا بالفأرة لعزف نغمة.


لغة الواجهة
-----------
- 13 لغة: الإنجليزية، والصينية، والهندية، والإسبانية، والعربية، والفرنسية، والبنغالية،
  والبرتغالية، والإندونيسية، والأردية، والروسية، والألمانية، واليابانية.
- اختر اللغة في نافذة "حول" أو في الإعدادات (الترس -> تبويب «الدليل» -> «لغة الواجهة»).
  تُترجَم: تسميات اللوحة، والشريط العلوي، والمكتبة، والإعدادات، وأسماء الإعدادات المسبقة
  المصنعية، والدليل، وأسماء المعاملات وقيمها التي يعرضها برنامج DAW لديك. يبقى
  الشعار "ПОЛИВОКС" كما في الأصل.
- بعض برامج DAW لا تعيد قراءة أسماء المعاملات إلا بعد إعادة تحميل الإضافة أو المشروع.


حول الإضافة ودعم المطوّر
------------------------
- عند التشغيل الأول لكل صيغة (VST3 في برنامج DAW، وAU في Logic، والتطبيق المستقل) تظهر نافذة
  "حول" (بالإنجليزية افتراضيًا؛ اختر اللغة من القائمة أعلى النافذة). أغلقها بزر «متابعة» —
  ولن تظهر مرة أخرى.
- لفتحها مجددًا، اضغط «ادعم المطوّر» في الشريط العلوي: ستجد هناك التبرعات ومعلومات الاتصال.
- شروط الاستخدام موجودة في مجلد License (ملف بلغتك).


الإعدادات المسبقة
-----------------
- زر «المكتبة» (أو النقر على اسم الإعداد المسبق) يفتح القائمة. انقر صفًا لتحميله. الفلاتر على
  اليسار: «الكل» / «المصنعية» / «الخاصة بي»، و«أدنى تقييم» (1–5 نجوم)، والبحث بالاسم والوصف.
  تتنقّل الأسهم ◀ ▶ بين الإعدادات المسبقة مع مراعاة هذه الفلاتر.
- التقييم: انقر نجمة للتقييم، وانقر النجمة نفسها مرة أخرى لمسح التقييم. يمكنك التقييم في
  القائمة وفي الشريط العلوي. التقييمات مشتركة بين جميع نسخ الإضافة على هذا الكمبيوتر.
- زر «حفظ» يخزّن الصوت الحالي كإعداد مسبق خاص بك. إذا كان الاسم مستخدمًا، يُستبدل الإعداد
  المسبق (وتنبّهك رسالة تحذير بذلك). احذف إعداداتك المسبقة من المكتبة: «حذف»،
  ثم «تأكيد الحذف؟».
- تُحفظ إعداداتك المسبقة في مجلد الإعدادات المسبقة (انظر "أين تُحفظ بياناتك"؛ وزر
  «فتح مجلد الإعدادات» في المكتبة). يمكنك نسخها بين أجهزة الكمبيوتر.
- علامة النجمة وكلمة «معدَّل» بجانب الاسم تعنيان أن الصوت يختلف عن الإعداد المسبق المحفوظ.
- لا تحفظ الإعدادات المسبقة الإيقاع ولا مفتاح «الخرج».


الإيقاع
-------
- «المشروع» — يُؤخذ الإيقاع والشبكة من برنامج DAW لديك. «يدوي» — اضبط الإيقاع في الحقل على
  اليمين: اسحب لأعلى/لأسفل (مع الضغط على Shift لخطوات أدق)، أو استخدم عجلة الفأرة، أو انقر
  مرتين واكتب رقمًا (30–300 BPM).
- لا يوجد مشروع في التطبيق المستقل، لذا لا يحتوي إلا على حقل الإيقاع اليدوي.
- إذا لم يُبلغ برنامج DAW عن الإيقاع، تستخدم الإضافة إيقاعها الخاص.

مزامنة الإيقاع
- المعدِّل: زر «مزامنة الإيقاع» أسفل مقبض السرعة. عندما يضيء، يتحول مقبض «السرعة» إلى
  «التقسيم»: من 4 مازورات إلى 1/32، بما فيها القيم المنقوطة (.) والثلاثية (T). يظهر الإيقاع
  الحالي ومصدره على اليمين. في وضع «المشروع» أثناء التشغيل يتبع طور المعدِّل شبكة المشروع؛ وعند
  التوقف يواصل المعدِّل العمل بالإيقاع نفسه.
- تكرار الأغلفة: لمفتاح «وضع الغلاف» في المرشِّح وفي المضخِّم ثلاثة أوضاع —
  «مرة واحدة» / «تكرار» / «الإيقاع». في وضع «الإيقاع» يبدأ الغلاف من جديد عند كل تقسيم من
  تقسيمات الشبكة (مقبض «التقسيم» المجاور) ما دام أحد المفاتيح مضغوطًا أو
  «تثبيت النغمات» مفعّلًا.


الترس في أعلى اليمين
--------------------
تُفتح لوحة على الجانب الأيمن من النافذة (وتصبح النافذة أعرض). التبويبات:
- تبويب «الدليل» — يُفتح أولًا: اختيار اللغة ودليل مفصّل لجميع المعاملات باللغة المختارة (جدول
  المحتويات قابل للنقر). تنطبق اللغة على الإضافة بأكملها.
- تبويب «MIDI» — ميزة MIDI Learn (أدناه).

ميزة MIDI Learn (الترس -> تبويب «MIDI»)
تربط كثير من برامج DAW (مثل Ableton مع Push) المعاملات بوحدة التحكم تلقائيًا — وعندها لا تحتاج
إلى MIDI Learn. وتفيد هذه الميزة حيث لا يفعل برنامج DAW ذلك.
1. الترس -> تبويب «MIDI» -> «تفعيل MIDI LEARN» — تضيء المقابض.
2. انقر على مقبض أو مفتاح — فيتم تحديده.
3. حرّك مقبضًا في وحدة التحكم لديك — يتم الربط، ويظهر رقم CC على المقبض.
- في هذا الوضع، انقر بالزر الأيمن على عنصر مربوط لإزالة ربطه؛ وفي القائمة على
  اليمين علامة × لكل ربط.
- للخروج من هذا الوضع: «خروج» على اللافتة فوق اللوحة، أو الزر في الإعدادات، أو Esc.
- تُحفظ الروابط مع المشروع. «حفظ كروابط افتراضية» — تبدأ النسخ الجديدة من الإضافة بهذه الروابط
  (الملف midi-map.xml، انظر "أين تُحفظ بياناتك").
- يجب أن تصل إشارة وحدة التحكم إلى مسار MIDI الذي يحمل الإضافة (في Ableton: مدخل المسار هو وحدة
  التحكم لديك، وMonitor على In، أو على Auto مع تفعيل التسجيل للمسار). إذا كانت وحدة التحكم
  نفسها معيّنة في MIDI Map الخاصة بـ Ableton (Ctrl+M في Windows، وCmd+M في Mac)، فإن Ableton
  يلتقطها قبل الإضافة.
- لا يتحكم CC المربوط إلا في المعامل: إذا ربطت CC1 (عجلة التعديل) أو CC64 (الاستدامة)، تتعطل
  وظيفتهما المعتادة في هذه الإضافة.
