Apply Mask

هذا بلوك دالة يقوم بتصفية صورة باستخدام صورة قناع (أسود/أبيض أو تدرج رمادي) للاحتفاظ بأجزاء محددة من الصورة أو إزالتها. مخصّص لسير عمل التقسيم والتمويه البسيط في AugeLab Studio.

📥 المدخلات

• Image — الصورة الرئيسية التي سيتم تصفيتها (منفذ إدخال).

• Mask — صورة القناع المستخدمة لتحديد المناطق المحفوظة (منفذ إدخال). يقبل صورة ثنائية، تدرج رمادي أو ملونة. يعامل البكسلات الفاتحة/البيضاء في القناع كمناطق محفوظة والبكسلات الداكنة كمناطق مُزالة.

📤 المخرجات

• Filtered — الصورة الناتجة بعد تطبيق القناع (منفذ الإخراج).

🕹️ عناصر التحكم

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

🎨 الميزات

• يعمل مع الصور الملونة (RGB) والصور بتدرج الرمادي.

• يقبل الأقنعة بتدرج رمادي أو ملونة؛ يُفسر القناع كخريطة احتفاظ/إزالة.

• يحتفظ ببكسلات الصورة حيث يكون القناع فاتحًا/أبيضًا ويخفي البكسلات حيث يكون القناع داكنًا/أسودًا.

• مصمم لتصفية سريعة ومرئية في سلاسل المعالجة.

⚙️ آلية التشغيل

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

📝 تعليمات الاستخدام

1. زوّد Image بالصورة التي تريد تصفيتها.

2. زوّد Mask بصورة القناع. المناطق الفاتحة/البيضاء في القناع ستُحفظ في الناتج؛ والمناطق الداكنة/السوداء ستُزال.

3. اربط خرج Filtered بالبلوكات التالية (لعرضها، حفظها، أو لمزيد من المعالجة).

نصائح:

• إذا اختلفت أحجام القناع والصورة، غيّر الحجم أو اقطعهما بحيث يتطابقا قبل الربط.

• إذا كان القناع تقريبياً، يمكنك دمج هذا البلوك مع خطوات شكلية أو تمويج لتحسين النتائج.

💡 نصائح وحيل

• أنشئ الأقنعة من قيم الشدة باستخدام بلوكات مثل Image Threshold أو Image Adaptive Threshold قبل إدخالها في هذا البلوك.

• قلل الضوضاء في مصدر القناع باستخدام Blur أو Denoising لتجنّب ثقوب صغيرة غير مرغوب فيها في النتيجة.

• حسّن فصل المقدمة/الخلفية باستخدام HSV Filter عندما يكون اللون دليلاً قويًا، ثم حوّل النتيجة إلى قناع لهذا البلوك.

• لاستخراج موضوع بجودة أعلى، جرّب Background Removal (RMBG-1.4) أو Background Removal (BiRefNet) وأدخل القناع الناتج أو الصورة المقتطعة في هذا البلوك.

• استخدم Morphological Transformations لتنظيف شوائب القناع الصغيرة (erode/dilate) قبل تطبيق القناع.

• اقتطع أو ركّز المعالجة باستخدام Image ROI Select أو Image ROI بحيث يتطابق القناع والصورة على منطقة الاهتمام.

• عاين النتائج باستخدام Show Image واحفظ النواتج الناجحة باستخدام Image Logger أو Image Write.

🛠️ حل المشكلات

• القناع يبدو وكأنه لا يفعل شيئًا: تحقق من محاذاة Mask مع Image وأن المناطق الفاتحة تتوافق مع المناطق التي تريد الاحتفاظ بها. إذا اختلفت الأحجام، استخدم Image Resize أو اقتطع باستخدام Image ROI Select.

• الناتج يحتوي على بقع أو ثقوب: طبّق Blur أو Morphological Transformations على القناع لإزالة العيوب الصغيرة.

• لا تغيير مرئي بعد التطبيق: تحقق من أن القناع يحتوي بالفعل على مناطق غير سوداء. استخدم Image Threshold لثنوية القناع غير الواضح.

• تحتاج لفحص النتائج الوسيطة: أدخل Show Image بعد خطوات إنشاء القناع للتحقق من صحة القناع قبل تطبيقه.

📊 التقييم

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