# 旋轉網格

使用歐拉 XYZ 角度（以度為單位）或四元數，讓 3D 網格繞世界軸旋轉。在歐拉 XYZ 模式下，旋轉會依 X、Y、Z 的順序套用；在四元數模式下，(w, x, y, z) 四元數會自動正規化。旋轉會套用至網格的頂點，而且法線與切線也會一併旋轉，因此光照與著色仍保持正確。

## 輸入

### 通用輸入

| 參數 | 描述 | 資料類型 | 必填 | 範圍 |
|-----------|-------------|-----------|----------|-------|
| `mode` | 要使用的旋轉模式。`"euler_xyz"` 會依 X、Y、Z 的順序，以繞世界軸的角度套用旋轉（以度為單位）。`"quaternion"` 會使用會自動正規化的 (w, x, y, z) 四元數。 | DYNAMIC_COMBO | 是 | `"euler_xyz"`<br>`"quaternion"` |
| `mesh` | 要旋轉的 3D 網格。 | 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, x, y, z) 的 W 分量。（預設值：1.0） | FLOAT | 否 | -1.0 至 1.0 （步進值：0.001） |
| `qx` | 四元數 (w, x, y, z) 的 X 分量。（預設值：0.0） | FLOAT | 否 | -1.0 至 1.0 （步進值：0.001） |
| `qy` | 四元數 (w, x, y, z) 的 Y 分量。（預設值：0.0） | FLOAT | 否 | -1.0 至 1.0 （步進值：0.001） |
| `qz` | 四元數 (w, x, y, z) 的 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 |

> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議，歡迎貢獻！ [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/RotateMesh/zh-TW.md)

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