> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-comfy-docs-comfyapi-search.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# RotateMesh - ComfyUI Built-in Node Documentation

> Euler XYZ 각도(도 단위) 또는 쿼터니언을 사용하여 월드 축을 기준으로 3D 메시를 회전합니다.

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`
