# 메시 회전

Euler XYZ 각도(도 단위) 또는 쿼터니언을 사용하여 월드 축을 기준으로 3D 메시를 회전합니다. Euler XYZ 모드에서는 X, Y, Z 순서로 회전이 적용됩니다. 쿼터니언 모드에서는 (w, x, y, z) 쿼터니언이 자동으로 정규화됩니다. 회전은 메시의 정점에 적용되며, 법선과 탄젠트도 함께 회전되어 조명과 셰이딩이 올바르게 유지됩니다.

## 입력

### 공통 입력

| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 |
|-----------|-------------|-----------|----------|-------|
| `모드` | 사용할 회전 모드입니다. `"euler_xyz"`는 월드 축을 기준으로 X, Y, Z 순서의 각도(도 단위)로 회전을 적용합니다. `"quaternion"`은 자동으로 정규화되는 (w, x, y, z) 쿼터니언을 사용합니다. | DYNAMIC_COMBO | 예 | `"euler_xyz"`<br>`"quaternion"` |
| `메시` | 회전할 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(handedness) 성분은 변경되지 않습니다. | MESH |

> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/RotateMesh/ko.md)

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