> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/arabic/alblwkat-alwzyfyh/blocks-reference/image-transformations/analysis/image-color-match.md).

# Image Color Match

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

## 📥 المدخلات

`Image RGB`

* الصورة المصدر التي سيتم تعديل ألوانها.

`Reference Image`

* اختياري. الصورة المستخدمة كمرجع لدرجة الألوان. إذا لم تُقدّم، سيتم استخدام الصورة المصدر كمرجع.

## 📤 المخرجات

`Image Any`

* الصورة الناتجة بعد مطابقة الألوان.

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

* هذا الـ function block لا يحتوي على عناصر تحكم تفاعلية.

## 🎨 الميزات

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

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

1. وصل الصورة المصدر إلى مدخل `Image RGB`.
2. اختياريًا، وصل صورة مرجعية إلى `Reference Image`. إذا تركت هذا المدخل فارغًا، سيُستخدم المصدر كمرجع.
3. شغّل الـ block للحصول على النتيجة من مخرج `Image Any`.

## 📊 التقييم

عند التشغيل، يقارن الـ block إحصائيات الألوان بين المصدر والمرجع وينتج صورة تكون توزيع ألوانها متوافقًا مع المرجع.

## 💡 نصائح وحيل

* استخدم `Image Resize` أو `Image Resizer` لضمان أن للصورتين نفس الأبعاد قبل الإدخال (اختلاف الأحجام سيسبب خطأ).
* استخدم `Color Space` أو `Split Image` و `Merge Channels` إن أردت مطابقة قنوات محددة أو تحويل تمثيلات الألوان قبل/بعد المطابقة.
* استخدم `Adjust Colors` أو `Normalize Image` لضبط التباين أو توازن الأبيض قبل المطابقة (لتثبيت الإدخال) أو بعدها (للتنقيح النهائي).
* عاين النتائج باستخدام `Show Image` واحفظ النواتج باستخدام `Image Write` أو `Image Logger` للتوثيق أو لمعالجة لاحقة.

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

* إذا ظهر خطأ بخصوص أحجام الصور، تأكد أن العرض والارتفاع متطابقان في كلتا الصورتين واستخدم `Image Resize` لتصحيح الاختلاف.
* إذا ظهرت الألوان بشكل غير طبيعي بعد المطابقة، جرب معالجة مسبقة باستخدام `Normalize Image` أو ضبط القنوات باستخدام `Adjust Colors` قبل تشغيل الـ block.
* عند معالجة دفعات كبيرة من الصور، فكر في تغيير حجمها وتطبيعها أولًا للحصول على نتائج متسقة عبر المجموعة.