# تدوير شبكة

تدوير شبكة ثلاثية الأبعاد حول محاور العالم باستخدام إما زوايا Euler XYZ (بالدرجات) أو كواتيرنيون. في وضع Euler XYZ، تُطبَّق الدورانات بترتيب X ثم Y ثم Z؛ وفي وضع الكواتيرنيون، يتم تسوية الكواتيرنيون (w, x, y, z) تلقائيًا. يُطبَّق الدوران على رؤوس الشبكة، وتُدوَّر أيضًا المتجهات العمودية (normals) والمماسات (tangents) بحيث يظل الإضاءة والتظليل صحيحين.

## المدخلات

### المدخلات العامة

| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
|-----------|-------------|-----------|----------|-------|
| `mode` | وضع الدوران المطلوب استخدامه. يطبّق `"euler_xyz"` الدوران بزوايا X ثم Y ثم Z حول محاور العالم (بالدرجات). يستخدم `"quaternion"` كواتيرنيون (w, x, y, z) يتم تسويته تلقائيًا. | DYNAMIC_COMBO | نعم | `"euler_xyz"`<br>`"quaternion"` |
| `mesh` | الشبكة ثلاثية الأبعاد المراد تدويرها. | MESH | نعم | — |

### مدخلات euler_xyz

تظهر هذه المدخلات عندما يتم ضبط `mode` على `"euler_xyz"`.

| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
|-----------|-------------|-----------|----------|-------|
| `angle_x` | الدوران حول المحور X بالدرجات. (الافتراضي: 0.0) | FLOAT | لا | من -360.0 إلى 360.0 (الخطوة: 0.1) |
| `angle_y` | الدوران حول المحور Y بالدرجات. (الافتراضي: 0.0) | FLOAT | لا | من -360.0 إلى 360.0 (الخطوة: 0.1) |
| `angle_z` | الدوران حول المحور Z بالدرجات. (الافتراضي: 0.0) | FLOAT | لا | من -360.0 إلى 360.0 (الخطوة: 0.1) |

### مدخلات quaternion

تظهر هذه المدخلات عندما يتم ضبط `mode` على `"quaternion"`.

| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
|-----------|-------------|-----------|----------|-------|
| `qw` | المكوّن W من الكواتيرنيون (w, x, y, z). (الافتراضي: 1.0) | FLOAT | لا | من -1.0 إلى 1.0 (الخطوة: 0.001) |
| `qx` | المكوّن X من الكواتيرنيون (w, x, y, z). (الافتراضي: 0.0) | FLOAT | لا | من -1.0 إلى 1.0 (الخطوة: 0.001) |
| `qy` | المكوّن Y من الكواتيرنيون (w, x, y, z). (الافتراضي: 0.0) | FLOAT | لا | من -1.0 إلى 1.0 (الخطوة: 0.001) |
| `qz` | المكوّن Z من الكواتيرنيون (w, x, y, z). (الافتراضي: 0.0) | FLOAT | لا | من -1.0 إلى 1.0 (الخطوة: 0.001) |

**ملاحظة:** عندما يكون `mode` هو `"euler_xyz"` وتكون الزوايا الثلاث كلها 0.0، أو عندما يكون `mode` هو `"quaternion"` ويكون الكواتيرنيون هو الهوية (1, 0, 0, 0)، تُعاد الشبكة دون تغيير. يتم تسوية الكواتيرنيون تلقائيًا قبل الاستخدام؛ وإذا كان مقداره أقل من 1e-8، تُصدر العقدة خطأً.

## المخرجات

| اسم المخرج | الوصف | نوع البيانات |
|-------------|-------------|-----------|
| `mesh` | الشبكة المُدوَّرة. يتم تدوير الرؤوس، وتُدوَّر المتجهات العمودية (normals) كاتجاهات. تُدوَّر مكوّنات X و Y و Z للمماسات (tangents) بينما يبقى المكوّن W (اتجاهية اليد) دون تغيير. | MESH |

> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/RotateMesh/ar.md)

---
**Source fingerprint (SHA-256):** `38b120a3f719264d1269275ecfefa145b507c688735e4a461bb89517c697674f`
