# إضافة دليل LTXV

تقوم عقدة LTXVAddGuide بترميز الصور أو مقاطع الفيديو المدخلة عبر مرمّز VAE وتضيفها كإطارات مفتاحية مرشدة إلى تسلسل فيديو كامن. تحدّث كلًا من التكييف الإيجابي والسلبي وتعيد الكامن المعدّل، مع خيارات لتعيين إطار البداية، وقوة التكييف، وقناع انتباه اختياري، ومعاملات IC-LoRA اختيارية.

## المدخلات

| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
|-----------|-------------|-----------|----------|-------|
| `إيجابي` | مدخل التكييف الإيجابي المراد تعديله بإرشاد الإطار المفتاحي. | CONDITIONING | نعم | - |
| `سلبي` | مدخل التكييف السلبي المراد تعديله بإرشاد الإطار المفتاحي. | CONDITIONING | نعم | - |
| `VAE` | نموذج VAE المستخدم لترميز إطارات الصورة/الفيديو المدخلة. | VAE | نعم | - |
| `كامن` | تسلسل كامن مدخل سيستقبل إطارات التكييف. | LATENT | نعم | - |
| `صورة` | صورة أو فيديو لتكييف الفيديو الكامن عليه. يجب أن يكون عدد الإطارات 8*n + 1. إذا لم يكن الفيديو بعدد إطارات 8*n + 1، فسيتم قصه إلى أقرب عدد إطارات 8*n + 1. | IMAGE | نعم | - |
| `مؤشر الإطار` | فهرس الإطار لبدء التكييف عنده. بالنسبة للصور أحادية الإطار أو الفيديوهات ذات 1-8 إطارات، فإن أي قيمة frame_idx مقبولة. بالنسبة للفيديوهات التي تحتوي على 9 إطارات أو أكثر، يجب أن يكون frame_idx قابلاً للقسمة على 8، وإلا فسيتم تقريبه لأسفل إلى أقرب مضاعف للعدد 8. القيم السالبة تُحسب من نهاية الفيديو. القيمة الافتراضية: 0. | INT | نعم | -9999 إلى 9999 |
| `القوة` | قوة تأثير التكييف، حيث 1.0 يطبق التكييف الكامل و 0.0 لا يطبق أي تكييف. القيمة الافتراضية: 1.0. | FLOAT | نعم | 0.0 إلى 10.0 |
| `attention_mask` | قناع مكاني اختياري في فضاء البكسل. يتحكم في تأثير التكييف لكل منطقة عبر الانتباه الذاتي، مضروبًا في strength. | MASK | لا | - |
| `iclora_parameters` | معاملات IC-LoRA اختيارية من عقدة Get IC-LoRA Parameters. تُستخدم لضبط معالجة الدليل حسب ما تتطلبه بعض شبكات IC-LoRA (مثل تلك التي تحتوي على reference_downscale_factor > 1). عند التسلسل، تستخدم كل عقدة LTXVAddGuide فقط المعاملات المتصلة بها. | IC_LORA_PARAMETERS | لا | - |

**ملاحظة:** يجب أن يكون عدد إطارات الصورة/الفيديو المدخلة متوافقًا مع النمط 8*n + 1 (على سبيل المثال، 1، 9، 17، 25 إطارًا). إذا تجاوز الإدخال هذا النمط، فسيتم قصه تلقائيًا إلى أقرب عدد إطارات صالح.

**ملاحظة حول `iclora_parameters`:** عند استخدام معاملات IC-LoRA مع `reference_downscale_factor` أكبر من 1، يجب أن تكون الأبعاد المكانية الكامنة (العرض والارتفاع) قابلة للقسمة على هذا العامل. ستُصدر العقدة خطأً إذا لم يتحقق هذا الشرط.

**ملاحظة:** يجب أن تتلاءم إطارات الدليل المرمزة مع التسلسل الكامن عند موضع الإطار المحدد. إذا تجاوزت الإطارات المكيفة طول التسلسل الكامن، فستُصدر العقدة خطأً.

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

## المخرجات

| اسم المخرج | الوصف | نوع البيانات |
|-------------|-------------|-----------|
| `positive` | التكييف الإيجابي المحدَّث بمعلومات إرشاد الإطار المفتاحي. | CONDITIONING |
| `negative` | التكييف السلبي المحدَّث بمعلومات إرشاد الإطار المفتاحي. | CONDITIONING |
| `latent` | تسلسل كامن مع إطارات التكييف المدمجة وقناع الضوضاء المحدَّث. | LATENT |

> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAddGuide/ar.md)

---
**Source fingerprint (SHA-256):** `031bc9030dafed85b5ff1cbceae36234e9d5f77f7f4b040267067ecd16a27929`
