> 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/operations/rotate-image-angle.md).

# Rotate Image Angle

يقوم هذا البلوك الوظيفي بتدوير الصورة الواردة بزاوية يحددها المستخدم. يمكنك التحكم بالزاوية عبر شريط التمرير الموجود على البلوك أو تزويد مدخل الزاوية بقيمة رقمية خارجية. كما يمكنك اختيار طريقة الاستيفاء (interpolation) واختيار اقتطاع المناطق الخلفية الناتجة عن التدوير.

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

* `Image Any` زوّد الصورة المصدرية المراد تدويرها.
* (اختياري) يمكنك تزويد قيمة زاوية رقمية عبر مدخل `Angle` إذا كان متاحًا على اللوحة للتحكم برمجياً بدلاً من شريط التمرير على البلوك.

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

* `Image Any` الصورة المدوّرة (ومقتطعة اختياريًا) الناتجة.
* `Angle` قيمة الزاوية المستخدمة في التدوير (بالدرجات).

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

* `Angle` استخدم شريط التمرير لتعيين زاوية التدوير بالدرجات. يمكن أيضًا قبول إدخال رقمي خارجي عبر مدخل الزاوية.
* `Interpolation Method` اختر طريقة الاستيفاء المستخدمة عند تدوير البكسلات. الخيارات الشائعة تشمل nearest و linear؛ اختر ما يوازن الجودة والسرعة لحالتك.
* `Crop Background` فعّل هذا الخيار لإزالة المناطق السوداء/الفارغة الناتجة عن التدوير. عند التفعيل، يقتطع البلوك الصورة المدوّرة إلى أكبر منطقة مركزية خالية من آثار الخلفية.

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

* تحكم مباشر بالزاوية عبر شريط تمرير قابل للتعديل أو عبر إدخال رقمي خارجي.
* إمكانية اختيار طريقة الاستيفاء لتحقيق توازن بين جودة الصورة وسرعة المعالجة.
* اقتطاع تلقائي اختياري لإزالة مناطق الخلفية الناتجة عن التدوير.
* يُخرج كل من الصورة المعالجة وقيمة الزاوية المطبقة للاستخدام لاحقًا في سلسلة المعالجة.

## 📝 كيفية التشغيل <a href="#usage" id="usage"></a>

1. زوّد مدخل `Image Any` بصورة أو وصل بلوك مصدر صورة مثل `Camera USB` أو `Load Image From Path`.
2. اضبط الزاوية عبر شريط `Angle` أو وصل مصدر رقمي بمدخل الزاوية.
3. اختر `Interpolation Method` المناسبة.
4. فعّل `Crop Background` إذا رغبت في اقتطاع أركان الصورة السوداء الناتجة عن التدوير.
5. شغّل التدفق — سيخرج البلوك الصورة المدوّرة وقيمة الزاوية النهائية.

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

* لصور الكاميرا الحية، اجمع مع `Camera USB` أو `Camera IP` أو `Stream Reader` كمصدر للصورة وعرض النتائج باستخدام `Show Image`.
* إذا أردت تدوير منطقة محددة فقط، اقتطعها أولاً بـ `Image ROI Select` ثم دوّر الجزء المقتطع.
* لتقليل الآثار المرئية على الصور المزعجة، جرّب `Denoising` قبل التدوير.
* احفظ الصور المعالجة باستخدام `Image Logger` أو `Image Write` لأغراض السجلات.

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

* إذا ظهرت أركان سوداء بعد التدوير، فعّل `Crop Background` لإزالتها.
* إذا بدت الصور المدوّرة متكسرة أو بها آثار استيفاء، غيّر `Interpolation Method` إلى خيار أعلى جودة (مثلاً من nearest إلى linear).
* إذا كانت المعالجة بطيئة أو تستهلك ذاكرة كبيرة، قلل حجم الصورة باستخدام `Image Resizer` قبل التدوير.
* عند تزويد الزاوية من مصدر خارجي، تأكد أن القيمة رقمية وصالحة بالدرجات؛ وإلا قد تكون النتيجة غير متوقعة.