التأثير المشترك for YMM4 — دليل المستخدم

1. نظرة عامة

«التأثير المشترك» هو مكوّن إضافي لتأثيرات الفيديو في YukkuriMovieMaker4 (YMM4). يتيح لك تخزين تأثيرات فيديو متعددة داخل عنصر واحد من «التأثير المشترك»، وإدارتها من خلال التجميع وحفظ الإعدادات المسبقة واسترجاعها.

الميزات الرئيسية:

• تطبيق تأثيرات متعددة بالتسلسل داخل عنصر واحد
• حفظ الإعدادات المسبقة المسمّاة واسترجاعها ومشاركتها
• إدارة عدة تكوينات للتأثيرات عبر التبويبات مع تبديل فوري (يدعم الإضافة والحذف وإعادة التسمية)
• تنظيم الإعدادات بثلاثة أنواع من المجموعات الافتراضية: الكل والأخيرة والمفضلة
• سجل لقطات وإدارة فروع على غرار Git
• كتابة ذرية مع التحقق بـCRC32 وحفظ متعدد التكرار بـSHA-256
• تصدير واستيراد ملفات حزم الإعدادات (.ceprstpkg)
• النسخ والقص واللصق عبر الحافظة
• بحث متعدد المحاور مع دعم التعابير النمطية
• واجهة بـ8 لغات (اليابانية والإنجليزية والصينية المبسطة والصينية التقليدية والكورية والإسبانية والعربية والإندونيسية)
• واجهة متجاوبة تتحول تلقائياً إلى تخطيط الهاتف المحمول عند عرض أقل من 400 بكسل

يعرض ملصق الجدول الزمني عدد التأثيرات الحالي واسم الإعداد المطبّق، مثل «التأثير المشترك نشط: 3 [اسم الإعداد]»، مما يسهّل التعرف على المحتوى بنظرة واحدة.

مخرجات AviUtl ‏(.exo) غير مدعومة.

---

2. متطلبات النظام

العنصر	المتطلب
نظام التشغيل	Windows 10 / 11 (64bit)
YukkuriMovieMaker4	يُوصى بأحدث إصدار
بيئة التشغيل	.NET 10.0
وحدة معالجة الرسومات	وحدة معالجة رسومات متوافقة مع Direct2D

---

3. التثبيت

1. نزّل أحدث ملف .ymme من صفحة Releases على GitHub.
2. تأكد من أن YMM4 غير قيد التشغيل.
3. انقر نقراً مزدوجاً على ملف .ymme الذي نزّلته لتثبيته.
4. شغّل YMM4 وحدد عنصراً في الجدول الزمني.
5. اختر «التأثير المشترك» من قائمة إضافة تأثير الفيديو.

بعد التثبيت، ستظهر لوحة إدارة الإعدادات المسبقة وقائمة التأثيرات في لوحة الخصائص.

---

4. البدء السريع

1. حدد عنصر فيديو أو صورة في الجدول الزمني.
2. أضف «التأثير المشترك» من قائمة إضافة تأثير الفيديو.
3. أضف التأثيرات وضبطها في قسم «التأثيرات النشطة» أسفل لوحة الخصائص.
4. انقر على زر «+ (إضافة)» في لوحة إدارة الإعدادات، وأدخل اسماً واحفظ الإعداد.
5. لتطبيق التكوين نفسه على عنصر آخر، حدد الإعداد وانقر على زر «✓ (تطبيق)».

---

5. واجهة المستخدم

تعرض لوحة الخصائص الأقسام التالية من الأعلى إلى الأسفل.

5-1. لوحة إدارة الإعدادات المسبقة (PresetManagerControl)

هي المنطقة الرئيسية لإدارة الإعدادات، مقسّمة إلى عمودين.

المنطقة	الوصف
العمود الأيسر (قائمة المجموعات)	يعرض المجموعات التي يحددها المستخدم والمجموعات الافتراضية (الكل والأخيرة والمفضلة). انقر للتحديد، وانقر مرتين لإعادة التسمية، واسحب وأفلت لإعادة الترتيب (لا يمكن تحريك المجموعات الافتراضية). استخدم زر + لإضافة مجموعات وزر - لحذفها.
أعلى العمود الأيمن (شريط البحث)	يصفي الإعدادات بكلمة مفتاحية. انقر على الأيقونة في اليمين لتغيير هدف البحث.
وسط العمود الأيمن (قائمة الإعدادات)	يسرد الإعدادات في المجموعة المحددة. يعرض كل صف نجمة (تبديل المفضلة) والاسم وعدد التأثيرات وأيقونة معلومات (يعرض التلميح قائمة التأثيرات). يُدعم التحديد المتعدد (Ctrl+نقر، Shift+نقر).
أسفل العمود الأيمن (أزرار الإجراءات)	من اليسار: إضافة (+) وإزالة (-) وتحديث (↺) وتطبيق (✓). تمتد ملصقات الأزرار عند تمرير الماوس فوقها.
مقبض تغيير الحجم السفلي	اسحب لتغيير ارتفاع اللوحة.

5-2. فاصل الشبكة

اسحب الحدود بين العمودين لضبط عرض عمود المجموعات. تُستعاد القيمة عند الإطلاق التالي.

5-3. تخطيط الهاتف المحمول (أقل من 400 بكسل)

عندما ينخفض عرض عنصر التحكم دون 400 بكسل، تختفي قائمة المجموعات ويظهر زر قائمة الهامبرغر (≡). يؤدي النقر عليه إلى فتح قائمة المجموعات كنافذة منبثقة.

5-4. إدارة تبويبات التأثيرات (EffectTabManagerControl)

يظهر شريط تبويبات فوق «التأثيرات النشطة». يحتفظ كل تبويب بتكوين تأثيرات مستقل، وعند التبديل بين التبويبات ينعكس محتوى التبويب المحدد فوراً.

• زر + في اليمين: «إضافة علامة تبويب»
• زر × في كل تبويب: «إزالة علامة تبويب» (أول تبويب «جديد» لا يمكن حذفه)
• نقر مزدوج على اسم التبويب: إعادة تسمية (Enter أو تغيير التركيز للتأكيد، Esc للإلغاء)
• أسماء التبويبات الافتراضية: الأول «جديد»، ثم «علامة تبويب 2»، «علامة تبويب 3»، ...

5-5. التأثيرات النشطة (VideoEffectSelector)

يعرض محدد التأثيرات القياسي في YMM4 تأثيرات التبويب المحدد حالياً. عمليات الإضافة والإزالة وإعادة الترتيب والتفعيل/التعطيل تُحفظ في هذا التبويب.

---

6. إدارة المجموعات

يمكن تنظيم الإعدادات المسبقة في مجموعات. هناك «مجموعات حقيقية» و«مجموعات افتراضية».

6-1. إضافة مجموعة

1. انقر على زر «+» أسفل قائمة المجموعات.
2. أدخل اسم المجموعة في مربع الحوار وانقر «موافق».
3. تُضاف المجموعة الجديدة إلى القائمة وتُحدَّد تلقائياً.

6-2. حذف مجموعة

1. حدد المجموعة التي تريد حذفها في قائمة المجموعات.
2. انقر على زر «-» أسفل قائمة المجموعات.
3. انقر «موافق» في مربع التأكيد لحذف المجموعة وجميع إعداداتها.

ملاحظة: لا يمكن حذف مجموعة «الافتراضي» والمجموعات الافتراضية (الكل والأخيرة والمفضلة).

6-3. إعادة تسمية مجموعة

استخدم أحد الأساليب التالية:

• انقر مرتين على المجموعة لفتح مربع حوار وأدخل اسماً جديداً.
• انقر بزر الفأرة الأيمن على المجموعة واختر «إعادة تسمية» من القائمة السياقية.

ملاحظة: لا يمكن إعادة تسمية المجموعات الافتراضية.

6-4. إعادة ترتيب المجموعات

اسحب وأفلت المجموعات الحقيقية لتغيير ترتيبها. المجموعات الافتراضية ثابتة دائماً في أعلى القائمة ولا يمكن تحريكها.

---

7. إدارة الإعدادات المسبقة

7-1. إضافة إعداد مسبق (الحفظ)

1. ضع التأثيرات التي تريد حفظها في «التأثيرات النشطة».
2. اختر المجموعة المستهدفة في قائمة المجموعات (إذا كانت مجموعة افتراضية محددة، يُحفظ الإعداد في أول مجموعة حقيقية).
3. انقر على زر «+ (إضافة)» أسفل العمود الأيمن.
4. أدخل اسم الإعداد في مربع الحوار وانقر «موافق».
5. يُحفظ تكوين التأثيرات الحالي كإعداد مسبق ويُضاف إلى القائمة.

7-2. حذف إعداد مسبق

1. حدد الإعداد (الإعدادات) المراد حذفه (Ctrl+نقر أو Shift+نقر للتحديد المتعدد).
2. انقر على زر «- (إزالة)» أو انقر بالزر الأيمن واختر «إزالة».
3. انقر «موافق» في مربع التأكيد للحذف.

عند تحديد إعدادات متعددة وحذفها، تُحذف جميع الإعدادات المحددة دفعةً واحدة.

7-3. إعادة تسمية إعداد مسبق

• انقر مرتين على الإعداد لفتح مربع حوار وأدخل اسماً جديداً.
• انقر بالزر الأيمن واختر «إعادة تسمية».

7-4. إفراغ إعداد مسبق (تفريغ المحتوى)

يزيل جميع التأثيرات المحفوظة في إعداد مسبق، تاركاً الإعداد فارغاً. الإعداد نفسه يبقى موجوداً.

1. انقر بالزر الأيمن على الإعداد المستهدف.
2. اختر «إفراغ الإعداد» من القائمة السياقية.
3. انقر «موافق» في مربع التأكيد.

7-5. إعادة ترتيب الإعدادات المسبقة

اسحب وأفلت الإعدادات داخل القائمة لتغيير ترتيبها. إعادة الترتيب غير متاحة عند عرض المجموعات الافتراضية (الكل والمفضلة والأخيرة).

---

8. المجموعات الافتراضية

المجموعات الافتراضية مجموعات خاصة تظهر دائماً في أعلى قائمة المجموعات. لا يمكن حذفها أو إعادة تسميتها أو إعادة ترتيبها.

اسم المجموعة	المحتوى	الترتيب
الكل	يعرض جميع الإعدادات من كل المجموعات الحقيقية.	أبجدي (تصاعدي)
الأخيرة	يعرض آخر 10 إعدادات طُبّقت مؤخراً.	الأحدث أولاً
المفضلة	يعرض جميع الإعدادات المميّزة بنجمة.	أبجدي (تصاعدي)

عند تحديد مجموعة افتراضية وإضافة إعداد أو لصقه، يُحفظ في أول مجموعة حقيقية.

---

9. تطبيق الإعدادات المسبقة

9-1. تطبيق إعداد مسبق واحد

1. حدد الإعداد الذي تريد تطبيقه من القائمة.
2. انقر على زر «✓ (تطبيق)» أو انقر بالزر الأيمن واختر «تطبيق».
3. يُحمَّل تكوين تأثيرات الإعداد في العنصر على الجدول الزمني.

تطبيق الإعداد نفسه مجدداً: إذا حاولت تطبيق إعداد مطابق تماماً للتأثيرات الحالية، تظهر نافذة تأكيد. انقر «موافق» لإلحاق (تكديس) التأثيرات فوق الموجودة. انقر «إلغاء» للإلغاء.

9-2. تطبيق إعدادات متعددة في آنٍ واحد

1. حدد إعدادات متعددة باستخدام Ctrl+نقر أو Shift+نقر.
2. انقر على زر «✓ (تطبيق)».
3. تُدمج تأثيرات جميع الإعدادات المحددة بالترتيب وتُطبَّق.

لا يظهر مربع تأكيد التكرار عند التحديد المتعدد. أيضاً، عند تحديد إعدادين أو أكثر، لا تُحدَّث قائمة «الأخيرة» ولا يُسجَّل JSON الإعداد.

9-3. تحديث الملصق بعد التطبيق

بعد تطبيق إعداد واحد، يتحدّث ملصق الجدول الزمني ليعرض «التأثير المشترك نشط: 3 [اسم الإعداد]». يبقى اسم الإعداد معروضاً حتى إذا عُدِّلت التأثيرات يدوياً بعد ذلك.

---

10. تحديث الإعدادات المسبقة

يستبدل الإعداد المحدد بتكوين التأثيرات الحالي.

1. حدد الإعداد الذي تريد تحديثه من القائمة.
2. عدّل التأثيرات في «التأثيرات النشطة».
3. تأكد أن زر «↺ (تحديث)» نشط (يتفعّل فقط عند وجود تغييرات).
4. انقر على «↺ (تحديث)» أو انقر بالزر الأيمن واختر «تحديث».

متى يتفعّل زر التحديث: يتفعّل الزر فقط عندما يكون الإعداد المحدد هو آخر إعداد طُبِّق وكان تكوين التأثيرات الحالي يختلف عمّا هو محفوظ في الإعداد. إذا تغيّرت إحدى معاملات التأثير، يُقيَّم حالة الزر تلقائياً بعد تأخير 50ms.

---

11. البحث في الإعدادات المسبقة

أدخل كلمة مفتاحية في مربع البحث لتصفية الإعدادات في الوقت الفعلي.

11-1. تغيير وضع البحث

انقر على أيقونة التصفية في نهاية مربع البحث لفتح قائمة وتغيير هدف البحث.

وضع البحث	الهدف
اسم الإعداد المسبق (الافتراضي)	اسم الإعداد المسبق
اسم التأثير	ملصقات جميع التأثيرات الموجودة في الإعداد (قائمة مفصولة بأسطر جديدة)
عدد التأثيرات	عدد التأثيرات في الإعداد. الإدخال الرقمي يُعطي الأولوية للتطابق الكامل؛ يعود إلى التطابق الجزئي إذا لم يُوجد تطابق كامل.
البيانات الخام (JSON)	البيانات JSON الخام لتكوين التأثيرات المتسلسل. ابحث عن طريق اسم نوع التأثير أو قيم المعاملات.
الكل	يعرض الإعدادات المطابقة للاسم أو أسماء التأثيرات أو بيانات JSON الخام

11-2. البحث بالتعابير النمطية

يمكن استخدام التعابير النمطية (غير حساسة لحالة الأحرف) في جميع أوضاع البحث.

• مثال: ^blur → البحث عن الإعدادات التي يبدأ اسمها بـ«blur»
• مثال: color|shadow → البحث عن الإعدادات التي يحتوي اسمها على «color» أو «shadow»
• مثال: [0-9]+ → البحث عن الإعدادات التي يحتوي اسمها على رقم

إذا أُدخل نمط تعبير نمطي غير صالح، يعود البحث إلى مطابقة جزئية للسلاسل غير حساسة لحالة الأحرف.

---

12. المفضلة

علّم الإعدادات الأكثر استخداماً كمفضلة للوصول إليها سريعاً من المجموعة الافتراضية «المفضلة».

12-1. التعليم كمفضلة / إلغاؤه

انقر على زر النجمة في بداية كل صف في قائمة الإعدادات.

• نجمة صفراء (ذهبية) تعني أن الإعداد معلَّم كمفضلة.
• نجمة رمادية تعني أنه ليس مفضلاً.

تُحفظ التغييرات في ملف الإعداد فوراً.

12-2. عرض مجموعة المفضلة

اختر «المفضلة» في قائمة المجموعات لعرض جميع الإعدادات المميّزة بنجمة بترتيب أبجدي. إذا ألغيت تعليم إعداد كمفضلة أثناء عرض مجموعة المفضلة، يختفي الإعداد من القائمة فوراً.

---

13. النسخ والقص واللصق

استخدم الحافظة لنسخ الإعدادات المسبقة وقصّها ولصقها. تُكتب البيانات في الحافظة بتنسيق JSON نفسه المستخدم في حزم الإعدادات، حتى تتمكن من فحصها وتحريرها في محرر نص.

13-1. النسخ

1. حدد الإعداد (الإعدادات) للنسخ (يُدعم التحديد المتعدد).
2. انقر بالزر الأيمن واختر «نسخ».

تبقى الإعدادات الأصلية دون تغيير.

13-2. القص

1. حدد الإعداد (الإعدادات) للنقل (يُدعم التحديد المتعدد).
2. انقر بالزر الأيمن واختر «قص».

تُنسخ الإعدادات إلى الحافظة وتُحذف الأصول في آنٍ واحد. لا يظهر مربع تأكيد.

13-3. اللصق

1. اختر المجموعة المستهدفة في قائمة المجموعات.
2. انقر بالزر الأيمن على منطقة فارغة في قائمة الإعدادات أو على أي إعداد واختر «لصق».

متاح فقط عندما تحتوي الحافظة على JSON حزمة إعدادات صالح. تُعيَّن للإعدادات الملصوقة GUIDات جديدة (مختلفة عن المعرّفات الأصلية). إذا كانت مجموعة افتراضية محددة، تُضاف الإعدادات إلى أول مجموعة حقيقية.

13-4. تنسيق بيانات الحافظة

تستخدم البيانات المكتوبة في الحافظة تنسيق JSON التالي:

{
  "FormatId": "CombinedEffect.PresetExchange",
  "Version": 1,
  "ExportedAtUtc": "2025-01-01T00:00:00+00:00",
  "Presets": [
    {
      "Id": "...",
      "Name": "اسم الإعداد",
      "IsFavorite": false,
      "SerializedTabs": "...",
      "SerializedEffects": "..."
    }
  ]
}

---

14. تصدير واستيراد الإعدادات المسبقة

يمكن تصدير الإعدادات المسبقة واستيرادها كملفات حزمة (الامتداد .ceprstpkg)، مما يتيح مشاركتها بين البيئات والمستخدمين.

14-1. التصدير

1. حدد الإعداد (الإعدادات) للتصدير (Ctrl+نقر أو Shift+نقر للتحديد المتعدد).
2. انقر بالزر الأيمن واختر «تصدير».
3. يفتح مربع حوار حفظ الملف. حدد وجهة واسم ملف ثم احفظ.

• إعداد واحد: يُستخدم اسم الإعداد كاسم ملف افتراضي (الأحرف غير المسموح بها في أسماء الملفات تُستبدل بـ_).
• إعدادات متعددة: يُستخدم اسم الحزمة الافتراضي «التأثير_المشترك_إعدادات».

14-2. الاستيراد

1. اختر المجموعة التي تريد إضافة الإعدادات المستوردة إليها.
2. انقر بالزر الأيمن على منطقة فارغة في قائمة الإعدادات واختر «استيراد».
3. يفتح مربع اختيار الملف. اختر ملف .ceprstpkg (يمكن اختيار ملفات متعددة في آنٍ واحد).
4. تُضاف الإعدادات المستوردة إلى المجموعة الحالية.

تُعيَّن للإعدادات المستوردة GUIDات جديدة، لذا لن تتعارض مع الإعدادات الموجودة.

14-3. التوافق مع الإصدارات

تتضمن ملفات الحزمة رقم إصدار التنسيق. الإصدار الحالي هو 1. إذا حاولت استيراد حزمة بإصدار أعلى مما هو مدعوم، يظهر رسالة خطأ.

---

15. سجل اللقطات وإدارة الفروع

يوفر كل إعداد مسبق نافذة إدارة سجل على غرار Git. يمكنك حفظ تغييرات تكوين التأثيرات كلقطات وإدارتها بالفروع.

15-1. فتح نافذة السجل

1. انقر بالزر الأيمن على الإعداد الذي تريد إدارته.
2. اختر «إدارة السجل» من القائمة السياقية.
3. تفتح نافذة إدارة السجل (نافذة واحدة لكل إعداد).

15-2. تخطيط نافذة السجل

اللوحة	الوصف
اليسار (قائمة الفروع)	تسرد جميع فروع الإعداد. انقر لتحديد فرع؛ يظهر سجل لقطاته في المنتصف. أدخل اسم فرع في مربع النص أسفله وانقر «إنشاء فرع جديد» لإضافة فرع جديد.
المنتصف (قائمة اللقطات)	تسرد اللقطات من رأس الفرع المحدد للخلف. يعرض كل صف أيقونة التأكيد (مملوءة للرأس الحالي) والعلامات والرسالة والتاريخ/الوقت وملخص الفروق والمعرّف. انقر بالزر الأيمن للوصول إلى القائمة السياقية. أدخل رسالة أسفله وانقر «حفظ لقطة جديدة» لحفظ التكوين الحالي. استخدم زر «العودة إلى هذا» أسفله للرجوع إلى اللقطة المحددة.
اليمين (عرض الفروق)	يعرض الفروق بين اللقطة المحددة وتكوين التأثيرات الحالي. الإضافات باللون الأخضر والحذف باللون الأحمر والتعديلات باللون الأصفر. تُعرض تغييرات عدد التأثيرات وقيم الخصائص قبل/بعد بخط Consolas.

15-3. إنشاء لقطة

1. افتح نافذة إدارة السجل.
2. أدخل رسالة تصف التغييرات في مربع النص أسفل اللوحة المركزية.
3. انقر على «حفظ لقطة جديدة».
4. يُحفظ تكوين تأثيرات الإعداد الحالي كلقطة ويتحدّث رأس الفرع المحدد.

15-4. الرجوع إلى لقطة

1. حدد اللقطة التي تريد الرجوع إليها.
2. انقر على زر «العودة إلى هذا».
3. يُستعاد الإعداد وعنصر التأثير المشترك على الجدول الزمني إلى حالة اللقطة المحددة.

15-5. إنشاء فرع

1. أدخل اسم فرع جديداً في مربع النص أسفل اللوحة اليسرى.
2. انقر على «إنشاء فرع جديد».
3. يُنشأ فرع جديد ابتداءً من اللقطة المحددة حالياً (أو رأس الفرع الحالي).

15-6. عمليات القائمة السياقية

النقر بالزر الأيمن على لقطة يفتح قائمة سياقية.

العملية	الوصف
دمج في الحالي	يُلحق تأثيرات اللقطة المحددة في نهاية التأثيرات الحالية.
الاحتفاظ بالتغييرات (Soft)	ينقل رأس الفرع المحدد إلى اللقطة المختارة دون تغيير تأثيرات الجدول الزمني.
تجاهل التغييرات (Hard)	ينفّذ الاحتفاظ بالتغييرات (Soft) والرجوع معاً.
إدارة العلامات	يفتح نافذة إدارة العلامات للقطة.

15-7. قراءة ملخص الفروق

يظهر ملخص الفروق في عمود «التغييرات» في قائمة اللقطات.

• «تمت الإضافة (+N)»: اللقطة تحتوي على N تأثيرات أكثر من الحالة الراهنة
• «تمت الإزالة (N)»: اللقطة تحتوي على N تأثيرات أقل من الحالة الراهنة
• «معدّل»: عدد التأثيرات متساوٍ لكن المعاملات تغيّرت
• (فارغ): مطابق لتكوين التأثيرات الحالي

15-8. موقع تخزين بيانات السجل

تُحفظ بيانات السجل في مجلد History/ ضمن دليل المكوّن الإضافي. يُنشأ مجلد فرعي لكل إعداد؛ تُحفظ معلومات الفروع بملف branches.json وكل لقطة بملف {المعرّف}.json.

---

16. إدارة العلامات

يمكنك إرفاق علامات متعددة باللقطات لتنظيمها. تظهر العلامات باللون الأخضر في قائمة اللقطات.

16-1. إضافة علامة

1. انقر بالزر الأيمن على اللقطة التي تريد وضع علامة عليها.
2. اختر «إدارة العلامات» من القائمة السياقية.
3. تفتح نافذة إدارة العلامات.
4. أدخل اسم العلامة في مربع النص أعلاه وانقر «إضافة».

لا يُسمح بتكرار أسماء العلامات.

16-2. حذف علامة

1. افتح نافذة إدارة العلامات.
2. انقر على زر «إزالة» بجانب العلامة التي تريد حذفها.

---

17. حذف التأثيرات دفعةً واحدة

يمكنك إزالة جميع التأثيرات المعطّلة (غير المحددة) من عنصر التأثير المشترك دفعةً واحدة.

1. انقر بالزر الأيمن على منطقة فارغة في قائمة الإعدادات.
2. اختر «مسح» → «إزالة التأثيرات غير المحددة» من القائمة السياقية.
3. انقر «موافق» في مربع التأكيد.
4. تُحذف جميع التأثيرات المعطّلة حالياً.

لا تتأثر التأثيرات المُفعَّلة. إذا لم تكن هناك تأثيرات معطّلة، لا يحدث شيء.

---

18. واجهة متجاوبة وضبط التخطيط

18-1. ضبط ارتفاع اللوحة

اسحب مقبض تغيير الحجم (خط مزدوج) في أسفل لوحة إدارة الإعدادات لتغيير ارتفاعها. الحد الأدنى للارتفاع 200 بكسل. تُحفظ الإعداد عند تحرير الماوس وتُستعاد عند الإطلاق التالي.

18-2. ضبط عرض عمود المجموعات

اسحب فاصل الشبكة (الحدود بين قائمة المجموعات وقائمة الإعدادات) يساراً أو يميناً لضبط عرض عمود المجموعات. الحد الأدنى للعرض 120 بكسل والحد الأقصى 400 بكسل. تُحفظ الإعداد عند انتهاء السحب.

18-3. تخطيط الهاتف المحمول

عندما ينخفض عرض عنصر التحكم دون 400 بكسل، تحدث التغييرات التالية:

• يختفي لوحة قائمة المجموعات.
• يختفي فاصل الشبكة.
• يظهر زر قائمة الهامبرغر (≡) يسار شريط البحث.
• النقر عليه يفتح قائمة المجموعات كنافذة منبثقة. اختيار مجموعة يُغلق النافذة المنبثقة.

عندما يعود عرض عنصر التحكم إلى 400 بكسل أو أكثر، يتحول التخطيط تلقائياً إلى وضع سطح المكتب.

---

19. تخزين البيانات والحفاظ الآمن عليها

تُحفظ جميع بيانات الإعدادات المسبقة وتكوينات المجموعات وبيانات السجل كملفات JSON. تمنع الآليات التالية للتكرار والتحقق من التكامل فقدان البيانات بسبب عطل واحد.

19-1. الكتابة الذرية

تتبع عمليات الكتابة في الملفات هذه الخطوات:

1. الكتابة في ملف مؤقت (.tmp).
2. استخدام File.Replace لاستبدال الملف المؤقت بالملف الرئيسي، ونقل الملف القديم إلى النسخة الاحتياطية (.bak).
3. حتى إذا تعطّل التطبيق أثناء الكتابة، يكون الملف الرئيسي أو الاحتياطي دائماً في حالة صالحة.

19-2. التحقق بـCRC32

يُحسب مجموع اختباري CRC32 ويُلحق بالملف عند الكتابة. عند القراءة يُتحقق من المجموع الاختباري؛ إذا لم يتطابق يُستخدم الملف الاحتياطي للاستعادة.

19-3. التخزين متعدد التكرار بـSHA-256

تُحفظ بيانات الإعدادات وسجل المجموعات في موضعين:

• التخزين الرئيسي: مجلد presets/ ضمن دليل المكوّن الإضافي
• التخزين الاحتياطي: مجلد user/backup/CombinedEffect/

عند الإطلاق، تُقارن كلا الموضعين مع تجزئة SHA-256 والطابع الزمني المحفوظين في CombinedEffectSettings. إذا اكتُشف تناقض، تُستخدم البيانات الصحيحة لإصلاح الموضع الآخر تلقائياً (الشفاء).

19-4. الكتابة مع التأخير

تُجمَّع عمليات التغيير المتتالية مع تأخير 300ms (100ms للحذف) وتُكتب معاً، مما يقلل من حمل الإدخال/الإخراج.

19-5. التسجيل

تُحفظ سجلات العمليات والأخطاء في user/log/CombinedEffect/.

• يُنشأ ملف سجل جديد عندما يتجاوز الملف الحالي 512 كيلوبايت.
• تُحذف ملفات السجل الأقدم من 31 يوماً تلقائياً (يُفحص كل ساعة).

---

20. الترحيل من الإصدارات السابقة

إذا وُجد ملف بيانات من إصدار سابق في المسار أدناه، يُرحَّل تلقائياً عند أول إطلاق.

%AppData%\YukkuriMovieMaker4\user\plugins\CombinedEffect\presets.json

بعد الترحيل، يُعاد تسمية الملف القديم إلى presets.json.migrated. لا يُحذف الملف القديم إذا فشل الترحيل.

يشمل الترحيل:

• قائمة المجموعات بالتنسيق القديم (تُستثنى المجموعات المكافئة للافتراضية «الكل» و«المفضلة»)
• الإعدادات التابعة لكل مجموعة (الاسم وحالة المفضلة وتكوين التأثيرات)

---

21. بنية الملفات والمجلدات

المسار (نسبةً إلى دليل المكوّن الإضافي)	المحتوى
presets/	مجلد التخزين الرئيسي لبيانات الإعدادات
presets/groups.json	تكوين المجموعات (أسماء المجموعات وقوائم معرّفات الإعدادات)
presets/{GUID}.json	بيانات كل إعداد مسبق (الاسم والمفضلة وJSON تكوين التأثيرات)
presets/recent_ids.json	قائمة معرّفات الإعدادات المستخدمة مؤخراً (حد أقصى 10)
presets/UISettings.json	إعدادات الواجهة (ارتفاع اللوحة وعرض عمود المجموعات)
History/	مجلد تخزين بيانات سجل اللقطات
History/{GUID الإعداد}/branches.json	قائمة فروع ذلك الإعداد
History/{GUID الإعداد}/{GUID اللقطة}.json	بيانات كل لقطة
user/backup/CombinedEffect/	التخزين الاحتياطي (نسبةً إلى دليل تثبيت YMM4)
user/log/CombinedEffect/	مجلد تخزين ملفات السجل (نسبةً إلى دليل تثبيت YMM4)

تُحفظ بيانات الإعدادات في التخزين الرئيسي والاحتياطي معاً. إذا فُقد أحدهما يمكن الاستعادة من الآخر. إذا حُذف كلاهما لا يمكن استعادة الإعدادات.

---

22. دعم متعدد اللغات

تتحوّل واجهة المستخدم بالكامل تلقائياً وفقاً لإعداد اللغة في YMM4. لا حاجة لأي إعداد إضافي.

رمز اللغة	اللغة
ja-jp	اليابانية
en-us	الإنجليزية
zh-cn	الصينية المبسطة
zh-tw	الصينية التقليدية
ko-kr	الكورية
es-es	الإسبانية
ar-sa	العربية
id-id	الإندونيسية

---

23. مرجع المعاملات

المعامل	النوع	الافتراضي	قابل للتحريك	الوصف
التأثيرات النشطة (Effects)	ImmutableList<IVideoEffect>	(فارغ)	لا	قائمة تأثيرات الفيديو المراد إدارتها. استخدم محدد التأثيرات القياسي في YMM4 للإضافة والإزالة وإعادة الترتيب والتفعيل/التعطيل. تُعالج كخط أنابيب من الأعلى للأسفل. التأثيرات المعطّلة تُتجاوز.
EffectTabsJson	String (JSON)	(سلسلة فارغة)	لا	خاصية داخلية تخزّن حالة تبويبات التأثيرات (معرّف التبويب المحدد، أسماء التبويبات، وJSON التأثيرات لكل تبويب). تُحدَّث تلقائياً عند إضافة/حذف/إعادة تسمية/تبديل التبويبات.
SelectedPresetJson	String (JSON)	(سلسلة فارغة)	لا	خاصية داخلية تحتفظ بمعلومات الإعداد المطبّق حالياً. تُعيَّن تلقائياً عند تطبيق إعداد. لا يُنصح بتحريرها مباشرةً. تُستخدم لعرض اسم الإعداد في ملصق الجدول الزمني.
PresetManagerVisible	bool	true	لا	علامة داخلية تتحكم في ظهور لوحة إدارة الإعدادات. مستثناة من التسلسل JSON ‏([JsonIgnore]).

تنسيق عرض الملصق

الحالة	التنسيق	مثال
بدون إعداد مطبّق	{اسم التأثير} نشط: {N}	التأثير المشترك نشط: 3
إعداد مطبّق	{اسم التأثير} نشط: {N} [{اسم الإعداد}]	التأثير المشترك نشط: 3 [مجموعة تأثيرات أ]

---

24. مرجع سريع

عمليات التبويبات

العملية	الطريقة	ملاحظات
إضافة علامة تبويب	زر «+» في يمين شريط التبويبات	ينشئ تبويباً جديداً بتكوين تأثيرات فارغ
إزالة علامة تبويب	زر «×» في التبويب	أول تبويب «جديد» لا يمكن حذفه
إعادة تسمية تبويب	نقر مزدوج على التبويب للتحرير	Enter/تغيير التركيز للتأكيد، Esc للإلغاء
تبديل التبويب	النقر على تبويب	تنعكس تأثيرات التبويب المحدد في «التأثيرات النشطة»

عمليات المجموعات

العملية	الطريقة	القيد
إضافة مجموعة	زر «+» أسفل قائمة المجموعات	لا يوجد
حذف مجموعة	زر «-» أسفل قائمة المجموعات	لا يمكن حذف المجموعات الافتراضية والافتراضية
إعادة تسمية مجموعة	نقر مزدوج، أو نقر أيمن → «إعادة تسمية»	لا يمكن إعادة تسمية المجموعات الافتراضية
إعادة ترتيب المجموعات	السحب والإفلات	لا يمكن تحريك المجموعات الافتراضية

عمليات الإعدادات المسبقة

العملية	الطريقة	ملاحظات
إضافة إعداد	زر «+ (إضافة)»	يُحفظ في أول مجموعة حقيقية عند تحديد مجموعة افتراضية
حذف إعداد	زر «- (إزالة)»، أو نقر أيمن → «إزالة»	يظهر مربع تأكيد. يُدعم التحديد المتعدد.
إعادة تسمية إعداد	نقر مزدوج، أو نقر أيمن → «إعادة تسمية»	لا يوجد
إعادة ترتيب الإعدادات	السحب والإفلات	غير متاح عند عرض المجموعات الافتراضية
تطبيق إعداد	زر «✓ (تطبيق)»، أو نقر أيمن → «تطبيق»	مربع تأكيد للمحتوى المطابق
تحديث إعداد	زر «↺ (تحديث)»، أو نقر أيمن → «تحديث»	نشط فقط عند وجود تغييرات في التأثيرات
إفراغ إعداد	نقر أيمن → «إفراغ الإعداد»	يظهر مربع تأكيد. متاح فقط عند وجود تأثير أو أكثر.
تبديل المفضلة	النقر على زر النجمة	لا يوجد
نسخ	نقر أيمن → «نسخ»	يُدعم التحديد المتعدد
قص	نقر أيمن → «قص»	لا يوجد مربع تأكيد. يُدعم التحديد المتعدد.
لصق	نقر أيمن → «لصق»	يتطلب JSON صالحاً في الحافظة
تصدير	نقر أيمن → «تصدير»	تحديد متعدد. تنسيق .ceprstpkg.
استيراد	نقر أيمن في منطقة فارغة → «استيراد»	يمكن تحديد ملفات متعددة
إزالة التأثيرات غير المحددة	نقر أيمن في منطقة فارغة → «مسح» → «إزالة التأثيرات غير المحددة»	يظهر مربع تأكيد
فتح السجل	نقر أيمن → «إدارة السجل»	نافذة واحدة لكل إعداد

عمليات السجل

العملية	الطريقة	الوصف
حفظ لقطة	إدخال رسالة → زر «حفظ لقطة جديدة»	معطّل إذا كانت الرسالة فارغة
الرجوع إلى لقطة	تحديد لقطة → زر «العودة إلى هذا»	يُطبَّق على الإعداد والجدول الزمني معاً
إنشاء فرع	إدخال اسم الفرع → زر «إنشاء فرع جديد»	معطّل إذا كان اسم الفرع فارغاً
دمج	نقر أيمن على لقطة → «دمج في الحالي»	يُلحق التأثيرات في النهاية الحالية
الاحتفاظ بالتغييرات (Soft Reset)	نقر أيمن على لقطة → «الاحتفاظ بالتغييرات (Soft)»	ينقل الرأس فقط، بدون تغيير التأثيرات
تجاهل التغييرات (Hard Reset)	نقر أيمن على لقطة → «تجاهل التغييرات (Hard)»	Soft Reset + الرجوع في آنٍ واحد
إدارة العلامات	نقر أيمن على لقطة → «إدارة العلامات»	يفتح نافذة إدارة العلامات

---

25. ملاحظات وتحذيرات

• مخرجات تنسيق AviUtl ‏(.exo) غير مدعومة.
• لا يُنصح بتداخل «التأثير المشترك» داخل «تأثير مشترك» آخر.
• المجموعات الافتراضية «الكل» و«المفضلة» و«الأخيرة» لا يمكن حذفها أو إعادة تسميتها أو إعادة ترتيبها.
• مجموعة «الافتراضي» لا يمكن حذفها.
• إضافة إعداد أو لصقه أثناء تحديد مجموعة افتراضية يحفظه في أول مجموعة حقيقية.
• استيراد ملف حزمة يُعيّن معرّفات جديدة مختلفة عن GUIDات الأصلية. لذا لا تَرِث الإعدادات المستوردة سجل اللقطات.
• عملية القص تحذف الإعدادات بدون مربع تأكيد. لا يمكن التراجع عن هذا الإجراء فوراً لذا استخدمه بحذر.
• تطبيق إعداد واحد يعيد بنية التبويبات المحفوظة (بما في ذلك التبويب المحدد). عند تطبيق عدة إعدادات معاً، أو إعادة تطبيق الإعداد نفسه بوضع التكديس، تُدمج تأثيرات التبويب المحدد فقط وتُعاد بناء التبويبات إلى تبويب واحد «جديد».
• تُحفظ بيانات الإعدادات في التخزين الرئيسي والاحتياطي. حذف مجلد واحد قد يسمح بالاستعادة، لكن حذف كليهما يؤدي إلى فقدان دائم للبيانات.
• بيانات السجل محفوظة في مجلد History/. حذف هذا المجلد سيمحو جميع السجلات.
• سجل اللقطات ينمو بلا حدود. إذا كان هناك لقطات غير ضرورية كثيرة، يمكنك حذف ملفات .json غير المرغوبة يدوياً في مجلد History/{GUID الإعداد}/ (لا تحذف branches.json).
• فقط التأثيرات المدعومة من نظام مكوّنات YMM4 الإضافية تُحفظ ضمن تكوين تأثيرات الإعداد. قد تُتجاوز التأثيرات غير المدعومة عند التحميل.
• بسبب الكتابة مع التأخير، هناك تأخير يصل إلى 300ms بين عملية التغيير والكتابة الفعلية في الملف. إذا أُغلق YMM4 قسراً فوراً، قد لا تُحفظ آخر عملية.

---

26. إخلاء المسؤولية والترخيص

يُصدر هذا المكوّن الإضافي تحت رخصة MIT.

يُقدَّم هذا البرنامج «كما هو»، دون أي ضمان من أي نوع، صريح أو ضمني، بما في ذلك على سبيل المثال لا الحصر ضمانات القابلية للتسويق والملاءمة لغرض معين وعدم الانتهاك.

لا يتحمل المؤلف أي مسؤولية عن أي أضرار ناشئة عن استخدام هذا المكوّن أو عدم القدرة على استخدامه. استخدمه على مسؤوليتك الخاصة.

المؤلف: routersys  /  الترخيص: MIT License  /  المستودع: https://github.com/routersys/YMM4-CombinedEffect

---

نهاية الوثيقة.