ويكي

Input

يستورد ملفات مشروع Spine ومدخلات JSON فقط وموارد العرض التجريبي وحزم ZIP إلى المخطط.

الغرض: هذه هي نقطة الإدخال الرئيسية لمعظم سير العمل. يقرأ JSON وatlas وtextures ويحوّلها إلى بيانات داخلية موحّدة يمكن للعقد اللاحقة معالجتها.

الأوضاع المدعومة:
1. مشروع كامل: JSON + atlas + textures
2. JSON فقط: معالجة بيانات skeleton/animation من دون atlas
3. حزمة ZIP: ملف zip معبأ يحتوي على مشروع كامل
4. موارد تجريبية: بيانات نموذجية مدمجة للاختبار السريع

المخرجات الرئيسية:
- **payload_out**: بيانات موحّدة لعقد التحسين
- **original_json_out**: ملف JSON الأصلي للمقارنة أو إعادة البناء
- **atlas_project_out**: مشروع atlas محلل عند توفير textures

Video To Png Sequence

حوّل مقطع فيديو إلى تسلسل إطارات PNG جاهز لسير عمل Spine.

هذه أداة إدخال مجانية ضمن قائمة Input ومناسبة لسير العمل الإنتاجي. تدعم مفتاح اللون للشاشات الخضراء وتنظيف الحواف بأسلوب إزالة الضرب المسبق للخلفيات السوداء. ترسل البيانات عبر payload_out وحزمة الأطلس عبر atlas_out.

Picture Input

يضيف صور PNG/JPEG مستقلة إلى مساحة العرض حتى تتمكن من إنشاء معاينات ولقطات عرض أكثر نظافة.

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

سير العمل: حمّل صورة واحدة، ثم استخدم أدوات مساحة العرض لتكبيرها أو تصغيرها وتحريكها وضبط قيمة z-index الخاصة بها حتى تستقر بشكل صحيح داخل التكوين. يجعل ذلك بناء لقطات عرض جذابة أمرا مريحا من دون لمس بيانات مشروع Spine الأساسية.

هذه العقدة مستقلة ولا تعرض مقابس للرسم البياني.

Version: تنسيق إصدار Spine JSON للهيكل العظمي المولّد.
Blending: وضع المزج للمرفق المولّد (عادي، إضافي، ضرب، شاشة).

Psd To Skeletons

يحمّل ملفات PSD/PSB متعددة الطبقات ويولّد هياكل Spine مترابطة تحافظ على تخطيط المشهد من Photoshop من أجل معاينات دقيقة.

الغرض: استخدم هذه العقدة عندما تكون اللقطة مرتبة مسبقًا في Photoshop وتريد تحويل تكديس الطبقات إلى مجموعة من هياكل Spine المترابطة داخل العارض. تتحول كل طبقة PSD مرئية إلى هيكل شبيه بالصورة يتم وضعه وفق إحداثيات PSD، مما يجعل بناء المعاينة ووضع العناصر بدقة أسهل بكثير.

سير العمل في العارض: بعد التوليد يمكنك الاستمرار في تغيير draw order داخل العارض ووضع هياكل أخرى بين طبقات PSD المستوردة، بحيث يمكن إدراج شخصيات Spine أو العناصر الإضافية داخل تركيب Photoshop.

التوفر: عقدة مجانية. هذه العقدة مستقلة ولا تعرض أي مقابس للرسم البياني.

Version: صيغة إصدار Spine JSON المستخدمة للهياكل المولدة من الطبقات.
Blending: وضع المزج المستخدم للملحقات المولدة.
Load PSD: افتح محدد PSD/PSB وأنشئ هياكل طبقات مترابطة من الملف المحدد.
File Info: ملخص للقراءة فقط لملف PSD/PSB المحمّل حاليًا.
Layer Count: عدد للقراءة فقط للطبقات المرئية التي سيتم تحويلها إلى هياكل مترابطة.
Preflight: تقرير للقراءة فقط عن مشكلات أسماء الطبقات المكتشفة قبل التوليد.

Project Input

يحمّل مجلد مشروع Spine أو أرشيفه إلى الرسم البياني ويعرض ProjectPayload عبر مقبس project_out للعقد اللاحقة المتعاملة مع المشاريع.

الغرض: نقطة الدخول لسير العمل القائم على المشاريع. يفحص مجلد مشروع Spine أو أرشيفه، ويبني ProjectPayload، ويُبقي البيانات الوصفية المخبأة جاهزة للعقد اللاحقة مثل Project Viewer وعُقد التصفية وStatic Bake وDeduplicator.

عناصر التحكم:
- **Load Folder**: يفتح منتقي مجلدات النظام عبر File System Access API، ويفحص الدليل المحدد، ويحدّث الملخص، ويخزّن البيانات الوصفية، ويبدأ مراقب ملفات بحيث يمكن إعادة الفحص بعد أي تغييرات لاحقة.
- **Browse (Fallback)**: يستخدم إدخال **webkitdirectory** مخفياً للمتصفحات التي لا تدعم **showDirectoryPicker()**. يحمّل المشروع، لكن من دون مقبض دليل دائم، لذلك لا تتوفر المراقبة الحية ولا إعادة الفحص الموثوقة.
- **Load Archive**: يحمّل أرشيف **.zip** أو **.spine** كشجرة مشروع افتراضية. المشاريع المحمّلة من الأرشيف لا تحتفظ بمقبض دليل، لذلك يكون **Rescan** غير متاح بحكم التصميم.
- **Rescan**: يعيد فحص المجلد الذي جرى تحميله سابقاً عند توفر مقبض دليل. ويعيد التحقق من إذن القراءة قبل الفحص. المشاريع المحمّلة عبر وضع التصفح الاحتياطي أو الأرشيف تعرض عادةً أنه لا يوجد دليل محمّل.
- **Clear Project**: يوقف مراقبة الملفات ويمسح الحمولة الحالية والملخص وذاكرة التنفيذ المؤقتة والبيانات الوصفية المخبأة للحمولة.
- **Reset to Defaults**: يعيد ضبط عناصر التحكم العامة للعقدة فقط. وهو **لا** يفرغ المشروع الحالي وليس بديلاً عن **Clear Project**.
- **Drop folder or .zip here**: نقطة إدخال بالسحب والإفلات تقبل المجلدات والأرشيفات وتمريرها عبر خط التحميل نفسه.

المخرجات:
- **project_out**: كائن ProjectPayload يحتوي على الشجرة المفحوصة وقائمة الملفات المسطحة وإجماليات الأحجام وتقسيم الأنواع للعقد اللاحقة المتعاملة مع المشاريع.
- **stats**: مخرجات تشخيصية خاصة بوضع DEV.

Output

يجمع النتائج النهائية ويتيح لك تنزيل البيانات المحسنة كملفات منفصلة أو مجموعات ملفات مجمعة أو أرشيفات.

الغرض: يعمل كمحور تصدير لملفات JSON المحسنة وبيانات atlas وtextures وsprites. يمكنه تجميع النتائج من مجموعة JSON/atlas/textures واحدة، أو من مجموعات ملفات متعددة، أو من sprites فقط عندما تريد إخراجا للصور من دون إعادة بناء مشروع Spine كامل.

خيارات التصدير:
- تنزيل الملفات بشكل فردي أو كأرشيف واحد
- تنزيل النتائج المعبأة أو أرشيف يحتوي على ملفات غير معبأة
- تصدير JSON بصيغة مضغوطة أو بصيغة مقروءة ومنسقة
- تصدير بيانات مشروع Spine كاملة أو نتائج sprite/image فقط

سير العمل المتسلسل: لا يجب أن تكون OutputNode النهاية المطلقة للمخطط. يمكنك تمرير مخرجاتها إلى مرحلة أخرى من خط المعالجة وتشغيل الملفات نفسها عبر جولات إضافية من التحسين. عمليا، تم اختبار تحسين key وcurve حتى 3 تكرارات متتالية.

المخرجات الرئيسية:
- **reconstructed_json_out**: JSON Spine المعاد بناؤه
- **original_json_passthrough_out**: تمرير مباشر لملف JSON الأصلي
- **payload_out**: payload لمزيد من التسلسل
- **changes**: تغييرات التحسين المجمعة
- **atlas_assets**: موارد atlas الجاهزة للتصدير

RDP

تبسيط منحنيات الرسوم المتحركة باستخدام خوارزمية Ramer-Douglas-Peucker (RDP).

الغرض: تقليل عدد الإطارات الرئيسية في مقاطع الرسوم المتحركة الخطية أو شبه الخطية عن طريق إزالة النقاط التي تقع على خط مستقيم بين نقطتين أخريين.

القاعدة الذهبية: معطل افتراضيًا. إنه يحمي المنحنيات ذات الشكل الكبير (المساحة/الانحناء) من أن تكون مسطحة إلى خطية. قم بتعطيله فقط للضغط الأكثر قوة بعد المراجعة المرئية.

مفاتيح المقبس: payload_in، payload_out، التغييرات

Epsilon: الانحراف الأقصى عن المنحنى الأصلي. القيم الأعلى تزيل المزيد من الإطارات المفتاحية لكن قد تفقد تفاصيل المنحنى.
Steep: عتبة حساسية الانحناء. يحمي المنحنيات المعقدة من التسطيح إلى خطية.
Round Mode: وضع التقريب للقيم المُحسّنة: بدون (الاحتفاظ بالأصل)، أعشار (منزلة عشرية واحدة)، أعداد صحيحة.
Golden Rule: عند التفعيل، يحمي المنحنيات ذات الشكل/المساحة الكبيرة من التبسيط بواسطة RDP.
S Run Length: الحد الأدنى لعدد منحنيات Spine القياسية على شكل S المتتالية قبل تفعيل التسطيح المعتمد على القالب. اضبط القيمة على 0 لتعطيل هذه الميزة.
S Deviation: الانحراف المعياري المسموح به عن قالب منحنى Spine القياسي على شكل S بوحدة الألف (0-300). القيم الأقل تتطلب تطابقًا أدق؛ القيم الأعلى تسطح المزيد من السلاسل القريبة من القالب.

Spline

يناسب منحنيات الخطوط الملساء مع الإطارات الرئيسية للرسوم المتحركة، مما يقلل من النقاط المتوسطة غير الضرورية.

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

مفاتيح المقبس: payload_in، payload_out، التغييرات

Max Error: الحد الأقصى لخطأ التقريب المسموح لملاءمة الشريحة. أقل = ملاءمة أدق للأصل.
Min Group Size: الحد الأدنى لعدد الإطارات المفتاحية الخطية المتتالية المطلوبة لتشكيل مجموعة قابلة للإزالة.

Refit

يقارب تسلسلات الإطارات الرئيسية الكثيفة مع عدد أقل من منحنيات Bezier لتقليل الحجم.

الغرض: يناسب عددًا أقل من المنحنيات مع البقاء ضمن حدود التسامح.

مفاتيح المقبس: payload_in، payload_out، التغييرات

Error Tolerance: الانحراف الأقصى المسموح بين المنحنى الأصلي ومنحنى بيزيه المعدّل. أقل = تطابق أدق.
Max Iterations: عدد تكرارات التحسين لملاءمة المنحنى. تكرارات أكثر = ملاءمة أفضل لكن أبطأ.

Quantizer

يقلل من دقة القيم الرقمية في الإطارات الرئيسية والمنحنيات.

الغرض: طريقة بسيطة ولكنها فعالة لتقليل حجم الملف عن طريق تقريب الأرقام إلى عدد محدد من المنازل العشرية.

الاستخدام: يمكن تطبيقه على أي بيانات رسوم متحركة تقريبًا. يصبح أكثر فعالية مع ارتفاع عدد الإطارات الرئيسية.

تنبيه: يمكن أن يؤدي التكميم الشديد جدًا (دقة منخفضة) إلى حدوث تشويش أو تشويش بصري في الرسوم المتحركة.

مفاتيح المقبس: payload_in، payload_out، التغييرات

Precision: عدد المنازل العشرية لقيم الإطارات المفتاحية. أقل = ملف أصغر لكن دقة أقل.

Cleanup

ينفذ مهام تنظيف متنوعة لإزالة بيانات الرسوم المتحركة الزائدة أو غير الضرورية.

الغرض: أداة متخصصة لإزالة أنواع معينة من البيانات الزائدة عن الحاجة والتي قد يفتقدها أدوات تحسين الأداء الأخرى.

الاستخدام: قم بتوصيل حمولتك بـ "payload_in" واحصل على النتيجة من "payload_out". إذا كنت تريد تقريرًا لكل تغيير، فاستخدم أيضًا "التغييرات".

مفاتيح المقبس:
- المدخلات: payload_in
- النواتج: payload_out، التغييرات

عمليات التنظيف المدعومة حاليًا:
1. **إزالة مسارات الألوان/ألفا غير المستخدمة**: إزالة الخطوط الزمنية للألوان/ألفا للفتحات التي لا تكون مرئية أبدًا أثناء الرسوم المتحركة.
2. **إزالة دورات IK المتكررة**: إزالة الإطارات الرئيسية للتدوير من العظام التي يتم التحكم فيها بالكامل بواسطة قيد IK بمزيج 100%.
3. **إزالة مفاتيح قيد المسار**: إزالة الإطارات الرئيسية للتدوير/الترجمة من العظام التي يتم التحكم فيها بالكامل بواسطة قيد المسار (مزيج القيم بنسبة 100%).
4. **تطهير الأحرف غير الإنجليزية**: يستبدل الأحرف غير الإنجليزية في الأسماء/المعرفات لتجنب المشكلات في أدوات المصب.

Remove Unused Color Tracks: إزالة مكونات اللون/ألفا التي لا تتغير أبداً عن القيمة الافتراضية.
Remove Redundant IKRotation: إزالة إطارات دوران العظام المفتاحية المتحكم بها بالكامل بواسطة قيود IK.
Remove Redundant Path Constraint Keys: إزالة إطارات قيود المسار المفتاحية التي تكرر قيم الإعداد.
Sanitize Non English Characters: استبدال الأحرف غير ASCII في أسماء العظام/الفتحات ببدائل آمنة.

Scale

يقيس كل القيم الرقمية في الإطارات الرئيسية للرسوم المتحركة بعامل محدد.

الغرض: قياس بيانات الرسوم المتحركة بشكل موحد، وهو مفيد لتغيير حجم الهيكل العظمي بشكل متناسب أو ضبط كثافة الرسوم المتحركة.

الاستخدام: قم بتوصيل **payload_in** وأخذ النتيجة من **payload_out**.

مفاتيح المقبس: payload_in، payload_out

Scale Factor: مضاعف المقياس للهيكل العظمي (مثلاً 0.5 = نصف الحجم).
Scale Bones: تغيير مقياس مواضع وأحجام العظام.
Scale Attachments: تغيير مقياس مواضع وأحجام المرفقات.
Scale Animations: تغيير مقياس إطارات الرسوم المتحركة المفتاحية.
Scale Constraints: تغيير مقياس معلمات القيود.
Scale Path: تغيير مقياس بيانات المسار.

Schneider

يناسب منحنيات Bezier الناعمة مع الإطارات الرئيسية للرسوم المتحركة باستخدام خوارزمية تركيب منحنى Schneider.

الغرض: تركيب منحنى متقدم ينتج منحنيات Bezier ذات مظهر طبيعي من تسلسلات الإطارات الرئيسية الكثيفة.

التوفر: **عقدة Plus-only**.

كيف يعمل: تقوم خوارزمية شنايدر بتحليل مواضع الإطار الرئيسي والظلال لإنشاء نقاط تحكم بيزيير مثالية تتطابق بشكل وثيق مع الحركة الأصلية.

المعلمات:
- **التسامح مع الأخطاء**: الحد الأقصى المسموح به للانحراف عن الإطارات الرئيسية الأصلية. أقل = أكثر دقة، أعلى = منحنيات أكثر سلاسة.
- **زاوية الزاوية**: زاوية العتبة (بالدرجات) التي يمكن عندها تقسيم المنحنى إلى أجزاء.

الأفضل لـ:
- رسوم متحركة مرسومة باليد أو مستوردة تحتوي على العديد من الإطارات الرئيسية
- تحويل الاستيفاء الخطي إلى منحنيات بيزييه ناعمة
- تقليل عدد الإطارات الرئيسية مع الحفاظ على جودة المنحنى

ملاحظة: أكثر كثافة من الناحية الحسابية من الخوارزميات الأبسط مثل RDP، ولكنها تنتج جودة منحنى فائقة.

مفاتيح المقبس: payload_in، payload_out، التغييرات

Error Tolerance: الانحراف الأقصى المسموح بين المنحنى الأصلي والمعدّل.
Min Segment Size: الحد الأدنى لعدد الإطارات المفتاحية في مقطع للمعالجة.

Physics Constraint Bake

يخبز Spine الفيزياء تقييد الحركة في تدوير/ترجمة الإطارات الرئيسية وإزالة الجداول الزمنية الفيزيائية.

الغرض: تحويل محاكاة الفيزياء في وقت التشغيل إلى إطارات رئيسية واضحة بحيث تكون الرسوم المتحركة حتمية وقابلة للتحرير دون قيود فيزيائية. بعد الخبز، تتم إزالة القيود الفيزيائية والجداول الزمنية الفيزيائية من الحمولة.

التوفر: **عقدة Plus-only**.

المدخلات / المخرجات:
- **payload_in** → **payload_out** (مخبوز)
- **التغييرات** (قائمة التغييرات الاختيارية)

الضوابط:
- **نموذج FPS**: محاكاة معدل أخذ العينات للمخبوزات.
- **دوران الخبز**: اكتب مفاتيح الدوران المخبوزة.
- **الترجمة المخبوزة**: اكتب مفاتيح الترجمة المخبوزة.
- **ترجمة الخبز (الأطفال)**: تطبيق ترجمة الخبز على عظام الأطفال التي تعتمد على الحركة الفيزيائية.

ملاحظات:
- يتطلب Spine JSON الأصلي لإعادة بناء بيانات المحاكاة.
- استخدمه عندما تريد إزالة القيود الفيزيائية مع الحفاظ على الحركة.

Sample fps: معدل أخذ العينات لخبز الفيزياء (إطارات في الثانية).
Bake rotation: خبز الدوران من قيود الفيزياء.
Bake translation: خبز الإزاحة من قيود الفيزياء.
Bake translation descendants: خبز الإزاحة للعظام التابعة.

Attachment Visibility

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

الغرض: منع محرك اللعبة من الاضطرار إلى معالجة المرفقات غير المرئية أو عرضها.

الاستخدام: العمليات **payload_in**، والمخرجات المحسنة **payload_out**، والتقارير الاختيارية **التغييرات**.

مفاتيح المقبس: payload_in، payload_out، التغييرات

Alpha Threshold: عتبة ألفا لاكتشاف رؤية المرفق.
Auto Restore: استعادة الرؤية تلقائياً بعد المعالجة.

Payload Merger

يدمج حمولات الرسوم المتحركة المتعددة المعالجة مرة أخرى في حمولة موحدة واحدة.

الغرض: ضروري لخطوط المعالجة المتوازية حيث يتم تحسين الرسوم المتحركة المختلفة أو مجموعات العظام بشكل منفصل وتحتاج إلى إعادة دمجها.

المدخلات:
- **القاعدة**: الحمولة الرئيسية (الهيكل العظمي)
- **التجاوزات**: حمولة واحدة أو أكثر تحل مساراتها محل المسارات الأساسية

الإخراج:
- **merged_out**: الحمولة المدمجة

مفاتيح المقبس: القاعدة، التجاوزات، merged_out

Warn conflicts: عرض التحذيرات عند تعارضات دمج الحمولة.

Animation Viewer

أداة مرئية لفحص ومقارنة منحنيات الرسوم المتحركة قبل وبعد التحسين.

الغرض: توفير تمثيل رسومي للإطارات الرئيسية والمنحنيات للمسار المحدد.

الاستخدام: قم بتوصيل **before_in** و**after_in** لتراكب النسخة الأصلية مع النسخة المحسنة. قم بتوصيل **التغييرات** بشكل اختياري لتسليط الضوء على المسارات المتأثرة.

مفاتيح المقبس: before_in، after_in، التغييرات

Show changed: عرض الرسوم المتحركة المتغيرة فقط.
Animation: اختيار الرسوم المتحركة للعرض.
Target: العظم/الفتحة المستهدفة للعرض.
Property: الخاصية المراد عرضها (دوران، إزاحة، إلخ).

Project Viewer

Displays a Spine project from the project_in socket for inspection and preview without mutating the incoming data.

Deduplicator

Deduplicates atlas projects by consuming project_inputs and returning payloads, atlas_projects, original_jsons, and shared_atlas_out for canonicalized downstream workflows.

The Deduplicator node scans all atlas regions for visually identical or near-identical sprites. It merges duplicates by choosing a canonical representative and remapping references. Several thresholds control detection sensitivity for different sprite types (glow, solid, alpha). Optionally constrains the output canonical atlas dimensions. A verification pass ensures the deduplicated result is visually equivalent to the original within the specified RMSE tolerance.

Repack mode: وضع إعادة التعبئة بعد إزالة التكرار.
Glow threshold: عتبة اكتشاف صور تأثير التوهج.
Solid threshold: عتبة اكتشاف الصور الصلبة.
Min sprite area: الحد الأدنى لمساحة الصورة للتحليل (بكسل²).
Alpha hash threshold: عتبة تجزئة ألفا للمقارنة.
Verification threshold: عتبة التحقق من التكرار.
Color rmse threshold: عتبة RMSE للون لاكتشاف التكرار.
Constrain canonical atlas size: تقييد حجم الأطلس القياسي.
Max canonical atlas width: الحد الأقصى لعرض الأطلس القياسي.
Max canonical atlas height: الحد الأقصى لارتفاع الأطلس القياسي.

Animation Filter

يقوم بتصفية مسارات الرسوم المتحركة بناءً على اسم الرسوم المتحركة (على سبيل المثال، "تشغيل"، "خامل").

الغرض: مفيد لتطبيق استراتيجيات التحسين المختلفة على الرسوم المتحركة المختلفة.

الاستخدام: يقوم بتصفية **payload_in** إلى **payload_out** ويكشف **animation_list** لاختيار واجهة المستخدم.

مفاتيح المقبس: payload_in، payload_out، Animation_list

Asset Filter

تعمل عوامل التصفية atlas على الأصول حسب الاسم، في وضعين: قبل أداة فك الحزم (مرشحات atlas text) أو بعد أداة فك الحزم (عناصر التصفية).

الغرض: التحكم في الأصول التي يتم تضمينها في سير العمل - إما الأصول التي سيتم فك حزمتها من atlas، أو الكائنات التي تم فك حزمتها والتي سيتم تضمينها في إعادة التعبئة.

المدخلات / المخرجات:
- وضع Atlas: **atlas_in** → **atlas_out**
- وضع الصور المتحركة: **sprites_in** → **sprites_out**

مفاتيح المقبس: atlas_in، atlas_out، sprites_in، sprites_out

Bone Filter

يقوم بتصفية مسارات الرسوم المتحركة للعظام بناءً على اسم العظام.

الغرض: السماح باستهداف أو استبعاد عظام معينة من عملية التحسين.

الاستخدام: يقوم بتصفية **payload_in** إلى **payload_out**.

مفاتيح المقبس: payload_in، payload_out

Skin Filter

يقوم بتصفية الرسوم المتحركة وبيانات الأصول بناءً على أسماء الأسطح.

الغرض: معالجة أسطح محددة فقط من مشروع Spine متعدد الأسطح.

الاستخدام: يقوم بتصفية **payload_in** إلى **payload_out**.

مفاتيح المقبس: payload_in، payload_out

Slot Filter

يقوم بتصفية مسارات الرسوم المتحركة للفتحة بناءً على اسم الفتحة.

الغرض: مفيد لاستهداف أو استبعاد فترات معينة قد يكون لها توقيت خاص أو متطلبات رؤية.

الاستخدام: يقوم بتصفية **payload_in** إلى **payload_out**.

مفاتيح المقبس: payload_in، payload_out

Parameter Filter

يقوم بتصفية مسارات الرسوم المتحركة بناءً على نوع الخاصية الخاصة بها (على سبيل المثال، التدوير، القياس، اللون).

الغرض: يسمح بتطبيق التحسينات اللاحقة فقط على أنواع محددة من بيانات الرسوم المتحركة.

الاستخدام: يقوم بتصفية **payload_in** إلى **payload_out**.

مفاتيح المقبس: payload_in، payload_out

Rotation: تضمين/استبعاد مسارات الدوران من المعالجة.
Translation: تضمين/استبعاد مسارات الإزاحة من المعالجة.
Scale: تضمين/استبعاد مسارات المقياس من المعالجة.
Shear: تضمين/استبعاد مسارات القص من المعالجة.
Color: تضمين/استبعاد مسارات اللون من المعالجة.
Attachment: تضمين/استبعاد مسارات المرفقات من المعالجة.
Deform: تضمين/استبعاد مسارات التشوه (الشبكة) من المعالجة.

Atlas Unpacker

يستخرج النقوش المتحركة الفردية من نسيج Spine atlas.

الغرض: تقسيم ملف atlas إلى كائنات مكونة له، مما يسمح بالتحليل الفردي أو إعادة التعبئة.

الاستخدام: قم بتوصيل **atlas_project** من InputNode إلى **atlas_project** (أو **atlas_project_in** القديم) على هذه العقدة. قم بتوصيل **skeleton_json_in** بشكل اختياري (من **original_json** الخاص بـ InputNode) لتمكين الاقتصاص المدرك للشبكة (قص الكائنات المتحركة إلى حدود الهيكل الشبكي بدلاً من الحدود المستطيلة، مما قد يقلل بشكل كبير من ذاكرة النسيج لمرفقات الشبكة).

النواتج:
- **sprites_out**: مصفوفة موحدة من النقوش المتحركة (للعارض/أداة إعادة التعبئة)
- **sprites_data_out**: صور/بيانات التعريف المستخرجة (حزمة منظمة)
- **atlas_out**: Atlas عبور المشروع

مفاتيح المقبس: atlas_project، atlas_project_in، Skeleton_json_in، sprites_out، sprites_data_out، atlas_out

Atlas Repacker

يعيد تجميع النقوش المتحركة الفردية في واحد أو أكثر من أطالس النسيج المحسنة الجديدة.

الغرض: تحسين ذاكرة النسيج ومن المحتمل أن يقلل من استدعاءات السحب عن طريق إنشاء أوراق رموز متحركة فعالة.

الاستخدام: يقبل النقوش المتحركة إما عبر **sprites_data_in** (حزمة النقوش المتحركة المهيكلة) أو عبر **sprites_out** (مصفوفة النقوش المتحركة القياسية). إذا لزم الأمر لمعالجة ألفا/التعبئة المضلعة، فقدم الهيكل الأصلي عبر **original_json**. يتم إخراج atlas المعبأ كـ **atlas_out**.

مفاتيح المقبس: sprites_data_in، sprites_out، original_json، atlas_out

Min Page Width: الحد الأدنى لعرض صفحة الأطلس بالبكسل.
Min Page Height: الحد الأدنى لارتفاع صفحة الأطلس بالبكسل.
Max Page Width: الحد الأقصى لعرض صفحة الأطلس بالبكسل.
Max Page Height: الحد الأقصى لارتفاع صفحة الأطلس بالبكسل.
Padding X: المسافة الأفقية بين الصور المتحركة بالبكسل.
Padding Y: المسافة العمودية بين الصور المتحركة بالبكسل.
Edge Padding: المسافة من حواف صفحة الأطلس.
Duplicate Padding: تكرار بكسلات الحافة لمنع عيوب الترشيح.
Alpha Mode: وضع ألفا: PMA (ألفا مُضرَب مسبقاً) أو مباشر.
Alpha Threshold: عتبة ألفا لقص البكسلات غير المرئية.
Strip Whitespace X: قص البكسلات الفارغة أفقياً.
Strip Whitespace Y: قص البكسلات الفارغة عمودياً.
Color Bleed Radius: نصف قطر نزيف اللون لمنع اللحامات أثناء الترشيح.
Scale: عامل المقياس المطبق على جميع الصور المتحركة قبل التعبئة.
Power Of Two: تقريب أبعاد الصفحة إلى أس اثنين.
Divisible By4: تقريب أبعاد الصفحة إلى مضاعفات 4 (لضغط الملمس).
Square: إجبار الصفحات على أن تكون مربعة.
Allow Rotation: السماح بتدوير 90° للصور المتحركة لتعبئة أفضل.
Packer Type: خوارزمية التعبئة: MaxRects أو Shelf.

Atlas Viewer

أداة atlas خفيفة الوزن للتصور والتحليل لفحص بنية atlas قبل التفريغ.

الغرض: توفير طريقة سريعة لمعاينة صفحات ومناطق atlas دون إجراء عملية تفريغ كثيفة. يساعد في التحقق من صحة بنية atlas وتحديد المناطق غير المستخدمة.

الاستخدام: قم بتوصيل مشروع atlas واحد بـ **atlas_project** (أو **atlas_in** القديم / **atlas**)، أو افحص مجموعة من مشاريع atlas عبر **atlas_projects**. يمكنك اختياريًا توصيل الهيكل العظمي JSON بـ **json** لتحليل الاستخدام.

مفاتيح المقبس: atlas_project، atlas_projects، atlas_in، atlas، json

Page Info: أبعاد ومعلومات صفحة الأطلس.
Stats: إحصائيات استخدام المساحة وعدد الصور المتحركة.

Atlas Merger

يجمع مصادر atlas المتعددة في atlas واحد موحد.

الغرض: دمج مشاريع atlas المتعددة في مشروع واحد.

الإدخال:
- **atlas_inputs**: مصفوفة متعددة المدخلات لمشاريع atlas

النواتج:
- **atlas_out**: مشروع atlas مدمج
- **merged_out**: المخرجات المدمجة القديمة
- **merged_atlas_out**: المخرجات المدمجة القديمة

مفاتيح المقبس: atlas_inputs، atlas_out، merged_out، merged_atlas_out

خط أنابيب نموذجي:
```
InputA → Unpacker → Repacker ─┐
                               ├→ Atlas Merger → Unpacker → Repacker → Output
InputB → Unpacker → Repacker ─┘
```
قبل Repacker، كانت البيانات عبارة عن نقوش متحركة فردية؛ بعد Repacker يصبح مشروع atlas. Atlas يجمع برنامج الدمج بين مشاريع atlas، ثم يقوم Unpacker النهائي → يعيد ممر Repacker حزم كل شيء بإحكام في atlas موحد واحد.

Asset Viewer

يعرض كائنات فردية من atlas غير المعبأ.

الغرض: أداة تصحيح الأخطاء المرئية لمعالجة atlas.

الاستخدام: يقبل الكائنات عبر **sprites_out** (قياسي) أو **sprites_in** / **sprites_data** القديمة.

مفاتيح المقبس: sprites_out، sprites_in، sprites_data

Asset select: اختيار الأصل للعرض.
Pixel stats: عرض إحصائيات البكسل للأصل.