Image Translate

تقوم هذه الدالة بتحريك صورة أفقيًا و/أو عموديًا بعدد بكسلات محدد. المنطقة الفارغة الناتجة تُملأ بلون خلفية تختاره. المدخلات X, Y وBackground Color اختيارية — القيم الفارغة تترك الصورة دون تغيير أو تستخدم القيم الافتراضية.

📥 المدخلات

• Input Image صورة رمادية أو ملونة ليتم تحريكها (مقبس image).

• X displacement إزاحة أفقية بالبكسل (مقبس number). القيم الموجبة تحرك الصورة إلى اليمين، والسالبة إلى اليسار. اختيارية — إن كانت فارغة تُعامل كـ 0.

• Y displacement إزاحة عمودية بالبكسل (مقبس number). القيم الموجبة تحرك الصورة إلى الأسفل، والسالبة إلى الأعلى. اختيارية — إن كانت فارغة تُعامل كـ 0.

• Background Color لون التعبئة للمناطق المكشوفة (مقبس pixel). اختيارية — افتراضيًا أسود إذا لم تُقدّم.

📤 المخرجات

• Translated Image الصورة الناتجة بعد التحريك (مقبس image). أبعاد الصورة الناتجة تطابق أبعاد الإدخال؛ المحتوى يُزحزح والحواف تُملأ باللون المختار.

🕹️ الضوابط

• X displacement أدخل مقدار الإزاحة الأفقية بالبكسل. استخدم قيم سالبة لتحريك إلى اليسار.

• Y displacement أدخل مقدار الإزاحة العمودية بالبكسل. استخدم قيم سالبة لتحريك إلى الأعلى.

• Background Color اختر لون الخلفية لملء المناطق الفارغة (استخدم مدخل من نوع Pixel أو بلوك يُنتج لونًا).

✨ الميزات

• المدخلات اختيارية: اترك X displacement أو Y displacement فارغة للحفاظ على ذلك المحور دون تغيير.

• تحافظ على حجم صورة الإدخال؛ المحتوى المحوَّل يُقص ليتناسب مع اللوحة الأصلية.

• تعمل مع الصور الرمادية وRGB على حد سواء.

• تعبئة الخلفية تقبل قيمة قناة واحدة أو قيم RGB اعتمادًا على نوع صورة الإدخال.

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

1. اربط بلوك يُنتج صورة إلى Input Image.

2. قدم قيم بكسل إلى X displacement و/أو Y displacement لتحريك الصورة.

3. اختياريًا قدم Background Color للتحكم في لون المناطق المكشوفة.

4. استخدم خرج Translated Image كمدخل للبلوكات التالية (عرض، تحليل، حفظ).

أمثلة:

• لنقل صورة 50 بكسل لليمين و20 بكسل للأسفل ضع X displacement = 50 وY displacement = 20.

• للتحريك عموديًا فقط ضع قيمة في Y displacement واترك X displacement فارغًا.

📊 سلوك التشغيل

عند تشغيل البلوك، يقرأ صورة الإدخال وقيم الإزاحة، يحرك البكسلات بالمقدار المطلوب، يملأ المناطق المكشوفة باللون المختار، ويعيد الصورة المحوَّلة على مقبس Translated Image. القيم الفارغة للإزاحة تُعامل كصفر.

💡 نصائح وحيل

• لتجنب قطع أجزاء مهمة من الصورة بعد التحريك، أضف هامشًا حول الصورة أولًا باستخدام Image Padding أو زيّن اللوحة بزر Image Resize وMake Image لإنشاء خلفية أكبر، ثم حرّك داخل اللوحة الأكبر.

• استخدم Pixel أو بلوك صغير Make Image لإنشاء لون خلفية دقيق وأدخله في Background Color.

• ادمج مع Image ROI أو Image ROI Select لتحريك منطقة مقصوصة فقط، ثم استخدم Image Concatenate أو Collage Images لإعادة تجميع/عرض النتائج.

• إذا احتجت قلبًا أو تدويرًا بعد التحريك، قم بسلسلة Flip Image أو Rotate Image Angle بعد هذا البلوك.

• لتخطيطات مبطّنة أو تركيب، حرك شرائح متعددة ثم ادمجها مجددًا باستخدام Image Concatenate أو Merge Channels حسب الحاجة.

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

• مشكلة: أجزاء مهمة من الصورة تقطع بعد التحريك. حل: أضف هامشًا قبل التحريك باستخدام Image Padding أو زِد حجم اللوحة باستخدام Image Resize / Make Image ثم حرّك.

• مشكلة: لون الخلفية لا يتطابق مع المتوقع. حل: تأكد أن مدخل Background Color يقدم صيغة القنوات الصحيحة (قيمة واحدة للرمادي، ثلاثي RGB للملون). استخدم Pixel لتزويد اللون الدقيق.

• مشكلة: لا يحدث تغيير بعد تقديم قيم الإزاحة. حل: تحقق أن مدخلات الإزاحة متصلة وليست فارغة؛ القيم الفارغة تُعامل كصفر.

• مشكلة: الحاجة للحفاظ على جودة الصورة عند تحريك عدد كبير من البكسلات. حل: فكّر في التحريك على لوحة أكبر أولًا وتجنب القص المتكرر؛ استخدم بلوكات مثل Show Image للتحقق من النتائج.