> 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/color-filters/normalize-image.md).

# Normalize Image

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

## 📥 المدخلات

`Reference` الصورة الأساسية التي سيتم تطبيعها. (مأخذ إدخال)

`Second Image` صورة اختيارية تُستخدم لحساب الإحصائيات الخاصة بالتطبيع. إذا تم توصيلها، تُستخدم إحصائياتها بدلاً من إحصائيات `Reference`. (مأخذ إدخال)

## 📤 المخرجات

`Image Any` الصورة بعد التطبيع جاهزة للمعالجة اللاحقة أو العرض. (مأخذ إخراج)

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

`Morph Type` اختر طريقة التطبيع. الخيارات الشائعة تتضمن:

* `NORM_MINMAX` تعيد مقياس قيم البكسل إلى نطاق محدد للعرض.
* `NORM_INF` تقيد القيم بالنسبة إلى القيمة العظمى، مفيد لتعديل النطاق الديناميكي.

`Pixel Range` حدد نطاق القيم المستهدف لبيكسلات الخرج باستخدام شريط نطاق أفقي. يتحكم هذا بالحد الأدنى والحد الأقصى بعد التطبيع.

`Clip Intensity` ضبط مقدار القص حول المتوسط (يعبر عنه بنسبة). القيم الأعلى تقلل من القيم المتطرفة عن طريق قص القيم خارج المتوسط ± (clip × الانحراف المعياري).

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

* عند التشغيل، يقرأ البلوك إعدادات `Morph Type` و`Pixel Range` و`Clip Intensity` ويطبق التطبيع على صورة `Reference`.
* إذا كانت `Second Image` متصلة، تُستخدم المتوسط والانحراف المعياري لتلك الصورة لتحديد نطاق القص؛ وإلا تُستخدم إحصائيات صورة `Reference`.
* يقوم البلوك أولاً بقص القيم الشديدة حول المتوسط وفقًا لقيمة `Clip Intensity`، ثم يقوم بترجمة قيم البكسل إلى `Pixel Range` المختار باستخدام طريقة التطبيع المحددة لإنتاج صورة الإخراج.

## 🎨 الميزات

* اختيار سريع بين مقياس مناسب للعرض (`NORM_MINMAX`) ومقياس مقيد بالقيمة العظمى (`NORM_INF`).
* قص قابل للتعديل لتقليل تأثير القيم المتطرفة أو البكسلات المشوشة.
* خيار استخدام صورة منفصلة لإحصاءات التطبيع، مما يتيح تطبيعًا متسقًا عبر صور متعددة أو تدفقات كاميرا.

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

1. وصل الصورة التي تريد تطبيعها إلى مدخل `Reference`.
2. اختياريًا، وصل صورة ثابتة أو عينة خلفية إلى مدخل `Second Image` لاستخدام إحصاءاتها.
3. اختر `Morph Type` المناسب لهدفك:
   * استخدم `NORM_MINMAX` لتعيين نطاق عرض صريح.
   * استخدم `NORM_INF` عند الرغبة في التقييد بالقيم العظمى.
4. اضبط `Pixel Range` لتحديد قيم min/max في الإخراج.
5. اضبط `Clip Intensity` للحد من تأثير القيم المتطرفة قبل التطبيع.
6. قم بتغذية الناتج `Image Any` إلى بلوكات العرض أو المعالجة اللاحقة.

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

* إذا كانت الصور المدخلة كبيرة جدًا، أضف `Image Resizer` قبل هذا البلوك لتسريع معاينات العمل.
* استخدم `Denoising` أو `Blur` قبل التطبيع لتقليل القص الناتج عن الضوضاء والحصول على إحصائيات أكثر استقرارًا.
* لتحسين التباين المدفوع بالهيستوجرام، جرب `Auto Contrast` أو `Contrast Optimization` بعد التطبيع لتحسين المظهر البصري.
* لمعاينة النتائج بصريًا، وصل الإخراج إلى `Show Image` أو احفظ أمثلة باستخدام `Image Logger` / `Image Write`.
* عند التحضير لمهام الكشف، طبّع الصور بشكل متسق عبر الإطارات عن طريق تزويد `Second Image` بصورة ممثلة (مثل عينة خلفية) ليصبح الكشف اللاحق (مثل `Find Object` أو `Object Detection`) أقل حساسية لتغيرات الإضاءة.

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

* إذا بدا الإخراج باهتًا أو مقصوصًا، قلل `Clip Intensity` أو وسع `Pixel Range`.
* إذا بدا التطبيع غير متسق عبر الإطارات، قدّم صورة ثابتة إلى `Second Image` ليتم استخدام نفس المرجع الإحصائي في كل مرة.
* إذا لم تظهر أي صورة، تأكد من توصيل صورة صالحة إلى `Reference` واعرض المعاينة باستخدام `Show Image`.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.augelab.com/arabic/alblwkat-alwzyfyh/blocks-reference/image-transformations/color-filters/normalize-image.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.