> 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/logic/mux.md).

# Mux

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

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

`Input 1` — مقبس إدخال عام\
`Input 2` — مقبس إدخال عام\
(يمكن إضافة مداخل إضافية حتى 20 باستخدام التحكم أدناه)

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

`Generic` — مخرج واحد يحتوي على قائمة بالقيم من جميع مقابس الإدخال (مع الحفاظ على الترتيب)

## 🕹️ عناصر التحكم <a href="#controls" id="controls"></a>

`Input size` — اختر عدد مقابس الإدخال التي يوفّرها البلوك (2–20). تغيير هذا التحكم سيضيف أو يزيل مقابس إدخال لتطابق عدد العناصر التي تريد تجميعها.

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

* عدد مدخلات مرن: اختر من 2 إلى 20 مدخلاً لتناسب سير عملك.
* تجميع مرتب: تُجمَع المداخل من اليسار إلى اليمين في قائمة واحدة في المخرج.
* دعم عام: يعمل مع الصور، الأرقام، النصوص، القوائم أو أي نوع بيانات عام.

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

1. حدّد عدد المدخلات المرغوب به بواسطة التحكم `Input size`.
2. وصل القيم التي تريد تجميعها بكل مقبس `Input X`.
3. يقوم البلوك بإخراج قائمة واحدة `Generic` تحتوي على جميع قيم الإدخال بالترتيب. وصل هذا المخرج إلى البلوكات التالية التي تقبل القوائم أو البيانات العامة.

## 📊 التقييم <a href="#evaluation" id="evaluation"></a>

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

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

* لفصل القائمة المجمّعة إلى عناصر فردية مجددًا، اربط هذا البلوك مع `Demux` أو `Get Element`.
* استخدمه مع `Batch Processing` أو `Batch Concatenation` عند تجهيز بيانات مجمعة لسير عمل الدُفعات.
* إذا كنت تجمع صورًا، وصل المخرج إلى `Collage Images`, `Image Concatenate` أو `Multi Image Write` لإنشاء عروض مجمعة أو حفظ صور متعددة دفعة واحدة.
* لتحويل البيانات المجمعة إلى صيغة مناسبة للسجلات، مرّر المخرج إلى `Data to JSON` أو `CSV Export`.
* قم بتصفية أو تطهير القائمة قبل استخدامها لاحقًا باستخدام `Exclude Nones` أو `Replace None` لإزالة أو استبدال الإدخالات الفارغة.
* للتصحيح السريع أو المعاينة، أرسل عناصر القائمة الفردية إلى `Show Image` (للاحقة الصور) أو إلى بلوك تسجيل.

## 🛠️ استكشاف الأعطال <a href="#troubleshooting" id="troubleshooting"></a>

* إذا خفّضت قيمة `Input size` بالخطأ وفقدت اتصالًا، أعد المسح أو أعد ربط المصدر بالمقابس الجديدة.
* إذا كانت البلوكات التالية لا تقبل المخرج المجمّع، تحقّق مما إذا كانت تتوقع عنصرًا واحدًا لكل مدخل بدلًا من قائمة؛ استخدم `Demux` أو `Get Element` لتكييف شكل البيانات.
* إذا كانت بعض إدخالات القائمة فارغة، ففكّر باستخدام `Exclude Nones` أو `Replace None` لتنظيف القائمة قبل المعالجة اللاحقة.