# قص الصورة إلى القناع

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

## المدخلات

| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
|-----------|-------------|-----------|----------|-------|
| `الصور` | الصورة المدخلة أو دفعة الصور المراد قصها. | IMAGE | نعم | — |
| `الأقنعة` | القناع أو دفعة الأقنعة التي تحدد منطقة العنصر. يُطبّق قناع واحد على جميع الصور؛ وإلا يجب أن يتطابق حجم دفعة الأقنعة مع حجم دفعة الصور. إذا اختلفت أبعاد القناع عن أبعاد الصورة، يُعاد تحجيم القناع تلقائيًا ليتطابق. | MASK | نعم | — |
| `العرض` | عرض الإخراج بالبكسل. (الافتراضي: 1024) | INT | نعم | 64 إلى 4096 (خطوة 8) |
| `الارتفاع` | ارتفاع الإخراج بالبكسل. (الافتراضي: 1024) | INT | نعم | 64 إلى 4096 (خطوة 8) |
| `عامل الحشو` | هامش إضافي حول الصندوق المحيط بالقناع كمعامل ضرب. (الافتراضي: 1.0) | FLOAT | نعم | 1.0 إلى 2.0 (خطوة 0.01) |
| `توسيع القناع` | توسيع القناع أو تقليصه بهذا العدد من البكسلات قبل القص. القيم الموجبة توسّع القناع، والقيم السالبة تقلّصه. (الافتراضي: 0) | INT | نعم | -32 إلى 32 (خطوة 1) |
| `الخلفية` | لون الخلفية خلف العنصر المقنّع. (الافتراضي: #000000) | COLOR | نعم | — |

ملاحظة: تُوسَّط منطقة القص على الصندوق المحيط بالقناع وتتطابق نسبة أبعادها مع `width` / `height`. تكتشف العقدة تلقائيًا القناع المقلوب وتصححه (بكسلات المقدمة على طول الحدود، والخلفية في المركز). إذا لم يحتوي القناع على أي بكسلات مقدمة، تحاول العقدة استخدام القناع المقلوب؛ وإذا كان ذلك فارغًا أيضًا، فتُسجّل تحذيرًا وتقص الصورة بأكملها. يُرفع خطأ عندما لا يتطابق حجم دفعة الأقنعة مع حجم دفعة الصور ولا يكون القناع قناعًا واحدًا.

## المخرجات

| اسم المخرج | الوصف | نوع البيانات |
|-------------|-------------|-----------|
| `images` | الصور المركّبة المقصوصة (العنصر المقنّع فوق لون الخلفية المختار)، معاد تحجيمها إلى `width` x `height`. يتطابق حجم الدفعة مع دفعة الصور المدخلة. | IMAGE |

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

---
**Source fingerprint (SHA-256):** `fcc14b5db7318699526dd544d404f78f9d1ab362b73769276f113f2b1062b214`
