Color Density Percentage

يحسب هذا البلوك مقدار مساهمة كل قناة لونية (Red, Green, Blue) في الشدة الإجمالية للصورة الملونة. يكون مفيدًا لتحليل سريع للألوان، فحوصات الجودة، واتخاذ قرارات ما قبل المعالجة في سلاسل معالجة الرؤية.

📥 المدخلات

Image Any

• صورة ملونة بثلاث قنوات (RGB أو BGR). يتوقع البلوك صورة ملونة عادية ليحسب مجموع القيم والنسب لكل قناة.

📤 المخرجات

Red Percentage

• نسبة شدة اللون الأحمر مقارنةً بإجمالي شدة الصورة (0–100، مقربة للأقرب).

Red Total

• مجموع قيم شدة قناة الأحمر (المجموع المطلق).

Green Percentage

• نسبة شدة اللون الأخضر مقارنةً بإجمالي شدة الصورة (0–100، مقربة للأقرب).

Green Total

• مجموع قيم شدة قناة الأخضر (المجموع المطلق).

Blue Percentage

• نسبة شدة اللون الأزرق مقارنةً بإجمالي شدة الصورة (0–100، مقربة للأقرب).

Blue Total

• مجموع قيم شدة قناة الأزرق (المجموع المطلق).

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

لا يحتوي هذا البلوك على عناصر تحكم تفاعلية. قم بتقديم الصورة عبر مقبس الإدخال لتشغيل الحساب.

⚙️ طريقة العمل

• عند استقبال صورة ثلاثية القنوات، يجمع البلوك قيم الشدة لكل قناة على حدة وكذلك المجموع الكلي عبر البكسل.

• تُحسب نسب القنوات كـ channel_sum / total_sum ثم تُضرب لتحويلها إلى نسبة مئوية.

• تُخرج المجاميع والنسب كقيم رقمية (النسب تقرب لسهولة القراءة).

• إذا لم تكن الصورة المدخلة صورة ثلاثية القنوات صالحة، سيُشير البلوك إلى إدخال غير صالح — تحقق من البلوكات السابقة في السلسلة.

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

• ملخص سريع لتكوين الألوان في الصورة (نسب + مجاميع خام).

• يعمل مع صور RGB/BGR القياسية دون إعداد إضافي.

• المخرجات رقمية وسهلة التسجيل أو التصوير أو استخدامها في منطق اتخاذ القرار.

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

1. وصل مصدر صورة ملونة إلى مدخل Image Any.

2. اقرأ المخرجات الرقمية لتقرير الخطوات التالية (مثال: التحقق إن تجاوزت قناة حدًا معيّنًا).

3. استخدم المخرجات مع بلوكات التسجيل أو التصور لتتبع التغيّر عبر الزمن.

💡 نصائح وحيل

• للتركيز على منطقة معينة قم بقص الصورة أولًا باستخدام Image ROI, Image ROI Select, أو Image ROI Center قبل توصيلها إلى هذا البلوك.

• لتحسين الاستقرار على الصور المشوشة، قم بعمل معالجة مسبقة مثل Blur أو Denoising.

• إذا كانت الصور كبيرة وتبطئ المعالجة، استخدم Image Resizer لتقليل الأبعاد مع الحفاظ على نسب الألوان العامة.

• لتحليل بكسلات تقع ضمن نطاق لوني محدد، استعمل HSV Filter أو RGB Mask ثم أدخل الصورة المموهة إلى هذا البلوك. لاستخدام قناع انتقائي، استعمل Apply Mask بعد إنشاء القناع.

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

• استخدم Show Image لمعاينة الصورة التي تحللها، وImage Logger أو CSV Export لحفظ المخرجات الرقمية للتقارير أو تتبع الاتجاهات.

• يمكنك دمج هذا البلوك مع بلوكات الكشف (مثل Object Detection أو Mask Detection) لحساب إحصائيات الألوان فقط للأجسام أو المناطق المكتشفة.

(ملاحظة: جميع البلوكات الموصى بها أعلاه متوفرة في مجموعة البلوكات ويمكن دمجها مباشرة في المحرر المرئي.)

🛠️ استكشاف الأخطاء وإصلاحها

• إذا بدت المخرجات غير صحيحة، تأكد أن الصورة الواردة من البلوكات السابقة هي صورة ثلاثية القنوات ملونة.

• إذا كانت النسب لا تجمع للقيمة المتوقعة، تحقق أن الصورة ليست محولة أو مُحوّلة إلى قناة واحدة قبل هذا البلوك.

• إذا كانت المعالجة بطيئة، ضع Image Resizer لتقليل حجم الصور قبل التحليل.