# چرخش مش

یک مش سه‌بعدی را حول محورهای جهانی، با استفاده از زاویه‌های اویلر XYZ (بر حسب درجه) یا یک کواترنیون، بچرخانید. در حالت اویلر XYZ، چرخش‌ها به‌ترتیب X و سپس Y و سپس Z اعمال می‌شوند؛ در حالت کواترنیون، کواترنیون (w, x, y, z) به‌صورت خودکار نرمال‌سازی می‌شود. چرخش روی رأس‌های مش اعمال می‌شود و نرمال‌ها و مماس‌ها نیز چرخانده می‌شوند تا نورپردازی و سایه‌زنی درست باقی بماند.

## ورودی‌ها

### ورودی‌های مشترک

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `حالت` | حالت چرخشی که باید استفاده شود. `"euler_xyz"` چرخش را به‌صورت زاویه‌های X سپس Y سپس Z حول محورهای جهانی اعمال می‌کند (بر حسب درجه). `"quaternion"` از یک کواترنیون (w, x, y, z) استفاده می‌کند که به‌صورت خودکار نرمال‌سازی می‌شود. | DYNAMIC_COMBO | بله | `"euler_xyz"`<br>`"quaternion"` |
| `مش` | مش سه‌بعدی برای چرخاندن. | 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` | مش چرخانده‌شده. رأس‌ها چرخانده می‌شوند و نرمال‌ها به‌عنوان جهت چرخانده می‌شوند. مؤلفه‌های X، Y، Z مماس‌ها چرخانده می‌شوند در حالی که مؤلفه W (دست‌سانی) بدون تغییر باقی می‌ماند. | MESH |

> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/RotateMesh/fa.md)

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