> 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/polar-transform.md).

# Polar Transform

تقوم هذه الدالة بتحويل منطقة صورة مستطيلة (نظام إحداثيات Cartesian) إلى تمثيل قطبي خطي. استخدمها لفكّ التغليف عن الميزات الدائرية أو المحورية (مثل الحلقات، العجلات، أو اللحامات الدائرية) بحيث تصبح أسهل للتحليل باستخدام الأدوات الخطية.

## 📥 المدخلات

* `Image Any`: صورة الإدخال التي سيتم تحويلها. (مقبس: input)
* `Center_X`: الإحداثي الأفقي لمركز التحويل. إذا تُرك فارغًا، سيستخدم البلوك مركز الصورة. (مقبس: input)
* `Center_Y`: الإحداثي الرأسي لمركز التحويل. إذا تُرك فارغًا، سيستخدم البلوك مركز الصورة. (مقبس: input)
* `Max Radius`: أقصى نصف قطر مستخدم للتحويل. إذا تُرك فارغًا، سيختار البلوك نصف قطر يتناسب مع مساحة الصورة. (مقبس: input)

## 📤 المخرجات

* `Image Any`: الصورة الناتجة بعد التحويل الخطّي إلى قطبي. (مقبس: output)

## 🕹️ الضوابط

لا يحتوي البلوك على عناصر واجهة منفصلة؛ المدخلات الرقمية الثلاثة تعمل كمعاملات يمكنك تغذيتها من بلوكات أخرى أو إدخالها يدويًا:

* `Center_X`: المركز الأفقي المستخدم لإعادة التعيين القطبي. عدله لتحريك مركز التحويل يمينًا/يسارًا.
* `Center_Y`: المركز الرأسي المستخدم لإعادة التعيين القطبي. عدله لتحريك مركز التحويل أعلى/أسفل.
* `Max Radius`: يحدد إلى أي مدى يمتد التحويل من المركز. القيم الأصغر تقصّ الامتداد الشعاعي؛ القيم الأكبر تشمل جزءًا أكبر من الصورة.

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

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

## 🎯 الميزات

* يفكّ التغليف عن البنى الدائرية أو المحورية إلى عرض مستطيل لتسهيل الفحص.
* يقبل معلمات رقمية اختيارية حتى تتمكن من قفل المركز ونصف القطر بدقة.
* يعمل مع أي بلوك ينتج بيانات صورة.

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

1. وصل صورة إلى مدخل `Image Any`.
2. اختياريًا، ادخل أرقامًا إلى `Center_X` و`Center_Y` لتعيين مركز التحويل (أو اتركها فارغة لاستخدام مركز الصورة).
3. اختياريًا، ادخل رقمًا إلى `Max Radius` لتحديد الامتداد الشعاعي.
4. استخدم المخرج `Image Any` الناتج لمزيد من التحليل أو العرض.

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

* للتركيز على منطقة معينة، قم أولًا بقص الصورة باستخدام `Image ROI` أو `Image ROI Select` ثم أدخل الصورة المقطوعة في هذا البلوك.
* إذا كانت الصورة كبيرة وتحتاج معالجة أسرع، استخدم `Image Resize` قبل هذا البلوك لتقليل الحجم مع الحفاظ على منطقة الاهتمام.
* إذا كانت الميزة الدائرية مائلة، قم بمحاذاتها أولًا باستخدام `Rotate Image Angle` أو `Image AutoRotator` حتى يصبح الناتج المفكوك أسهل للقراءة.
* بعد فك التغليف، استخدم بلوكات التحليل مثل `Histogram On Line` لفحص ملفات الشدة على الاتجاه الشعاعي أو الزاوي.
* للمعاينة البصرية، وصل المخرج إلى `Show Image` لمعاينة تفاعلية أثناء التطوير.
* للبحث عن كائنات حول حلقة، قدّم الصورة المحوّلة لبلوكات الكشف مثل `Find Object` لتبسيط تحديد الأنماط المتكررة.

(تلميح: اجمع بين البلوكات أعلاه لبناء مسارات فحص قوية للأجزاء الدائرية أو الحلقات أو قوام الحلزوني)

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

* إذا بدا الناتج المفكوك غير مركّز أو مشوّهًا، تحقّق من قيم `Center_X` و`Center_Y` وعدّلهما لمواءمة المركز الحقيقي للمؤثرة الدائرية.
* إذا كانت أجزاء من الدائرة مفقودة، زد قيمة `Max Radius` أو قم بقص الإدخال بشكل مختلف باستخدام `Image ROI` حتى تكون الميزة كاملة داخل نصف القطر.
* إذا ظهر الناتج ممتدًا أو منخفض التفاصيل، جرّب تقليل حجم الإدخال باستخدام `Image Resize` أو حسّن دقة الالتقاط قبل التحويل.
* إذا لم يظهر أي مخرج، تأكد من أن المقبس الموسوم بـ `Image Any` يتلقى بيانات صورة صالحة (استخدم `Show Image` للتحقق).