> 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/data-logic/flow-control/hmi-background.md).

# HMI Background

توفّر هذه الدالة لوحة عرض بصرية كبيرة وقابلة لتغيير الحجم مخصّصة لبناء تخطيطات واجهة الإنسان-الآلة (HMI) داخل السيناريو الخاص بك. تعمل كخلفية رسومية يمكنك وضع وتنظيم البلوكات التفاعلية والعناصر البصرية عليها لإنشاء واجهة شبيهة بلوحة القيادة.

## 📥 المدخلات <a href="#inputs" id="inputs"></a>

هذا البلوك لا يحتوي على أي مدخلات.

## 📤 المخرجات <a href="#outputs" id="outputs"></a>

هذا البلوك لا يحتوي على أي مخرجات.

## 🕹️ الضوابط <a href="#controls" id="controls"></a>

`Resize` قم بتعديل حجم البلوك داخل المحرر ليناسب مساحة تخطيط HMI المرغوبة.

`Background Canvas` المنطقة البصرية حيث تقوم بترتيب ومعاينة العناصر البصرية وبلوكات HMI الأخرى.

## 🎨 الميزات <a href="#features" id="features"></a>

* خلفية مرئية فقط لتصميم شاشات HMI ولوحات المعلومات.
* لوحة عمل قابلة لتغيير الحجم لتصميم واجهات مدمجة أو واسعة النطاق.
* مصممة لاستضافة وتنظيم البلوكات والعناصر العرضية الأخرى (صور، نصوص، مؤشرات) للوحيات المشغلين والعروض التوضيحية.
* خفيفة الوزن: لا تقوم بمعالجة بيانات الصور أو الحساسات بنفسها؛ وظيفتها تنظيمية وعرضية لهيكلة البلوكات الأخرى.

## ⚙️ آلية التشغيل <a href="#running-mechanism" id="running-mechanism"></a>

* هذا البلوك لا يولد بيانات ولا يجري حسابات أثناء تشغيل السيناريو.
* هدفه رسومي وتنظيمي بحت: استخدمه لتجميع موضعياً ووضع البلوكات التفاعلية والمخرجات التي تقوم بمعالجة البيانات عند تشغيل السيناريو.
* بما أنه مخصص للعرض فقط، فإن وضع عناصر معالجة ثقيلة داخل نفس المنطقة البصرية لا يغير سلوك الخلفية — تظل المعالجة تحدث في البلوكات الوظيفية المتصلة.

## 📝 كيفية الاستخدام <a href="#usage" id="usage"></a>

1. أضف بلوك `HMI Background` كلوحة عمل لواجهة المستخدم الخاصة بك.
2. غيّر حجم البلوك ليتطابق مع مساحة الشاشة التي تريد تصميمها.
3. ضع بلوكات العرض والتحكم فوق الخلفية لبناء تخطيط HMI (مثال: عرض الصور، تراكبات النص، الأزرار، والمؤشرات).
4. استخدم بلوكات هيكلية للحفاظ على منطق العمل خلف الواجهة منظماً وقابلًا لإعادة الاستخدام.

## 💡 نصائح وحيل <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* تجميع المنطق والعرض: استخدم `Subsystem`, `Subsystem In`, و`Subsystem Out` لفصل منطق المعالجة عن التخطيط البصري الموضوع على الخلفية.
* عرض تدفقات الكاميرا: اجمع مع `Show Image` لعرض إطارات الكاميرا الحية على لوحة HMI.
* إضافة مؤشرات الحالة والملصقات: استخدم `Write Text On Image` و`Led Output` لعرض نص ديناميكي ومؤشرات الحالة البوليانية فوق الصور المعروضة.
* توفير عناصر تحكم للمستخدم: ضع بلوكات مثل `Logic Input`, `Number Input`, أو `String Input` بالقرب من العروض ذات الصلة حتى يتمكن المشغلون من التفاعل مع السيناريو.
* حفظ الأدلة والسجلات: استخدم `Image Logger` أو `Record Video` (عند التوفر) مع الصور المعروضة لأرشفة الإطارات المهمة التي يتم تفعيلها من واجهة HMI.
* الحفاظ على استجابة واجهة المستخدم: ضع على الخلفية فقط بلوكات العرض والإدخال. يجب أن تظل المعالجات الثقيلة (اكتشاف، تجزئة، تتبع) في بلوكات وظيفية منفصلة.

## 🛠️ استكشاف الأخطاء وإصلاحها <a href="#troubleshooting" id="troubleshooting"></a>

* الخلفية غير مرئية أو صغيرة جدًا: جرّب زيادة حجم البلوك باستخدام تحكم `Resize`.
* التخطيط مزدحم: استخدم بلوكات `Subsystem` لطي وإخفاء المنطق المعقّد مع الحفاظ على نظافة لوحة HMI.
* بطء في التفاعل مع المحرر: أزل أو أعد وضع البلوكات المعالجة الثقيلة خارج المنطقة البصرية الفورية؛ اجعل الخلفية مركزة على العرض وعناصر التحكم فقط.