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

# RotateMesh - ComfyUI Built-in Node Documentation

> Rotate a 3D mesh around the world axes using either Euler XYZ angles (in degrees) or a quaternion.

Rotate a 3D mesh around the world axes using either Euler XYZ angles (in degrees) or a quaternion. The rotation is applied to the mesh's vertices, and the normals and tangents are rotated as well so lighting and shading remain correct.

## Inputs

### Common Inputs

| Parameter | Description                                                                                                                                                                                           | Data Type      | Required | Range                             |
| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | -------- | --------------------------------- |
| `mode`    | The rotation mode to use. `"euler_xyz"` applies rotation as X then Y then Z angles about the world axes (in degrees). `"quaternion"` uses a (w, x, y, z) quaternion that is automatically normalized. | DYNAMIC\_COMBO | Yes      | `"euler_xyz"`<br />`"quaternion"` |
| `mesh`    | The 3D mesh to rotate.                                                                                                                                                                                | MESH           | Yes      | —                                 |

### euler\_xyz Inputs

These inputs appear when `mode` is set to `"euler_xyz"`.

| Parameter | Description                                           | Data Type | Required | Range                       |
| --------- | ----------------------------------------------------- | --------- | -------- | --------------------------- |
| `angle_x` | Rotation around the X axis in degrees. (default: 0.0) | FLOAT     | No       | -360.0 to 360.0 (step: 0.1) |
| `angle_y` | Rotation around the Y axis in degrees. (default: 0.0) | FLOAT     | No       | -360.0 to 360.0 (step: 0.1) |
| `angle_z` | Rotation around the Z axis in degrees. (default: 0.0) | FLOAT     | No       | -360.0 to 360.0 (step: 0.1) |

### quaternion Inputs

These inputs appear when `mode` is set to `"quaternion"`.

| Parameter | Description                                                | Data Type | Required | Range                     |
| --------- | ---------------------------------------------------------- | --------- | -------- | ------------------------- |
| `qw`      | W component of the quaternion (w, x, y, z). (default: 1.0) | FLOAT     | No       | -1.0 to 1.0 (step: 0.001) |
| `qx`      | X component of the quaternion (w, x, y, z). (default: 0.0) | FLOAT     | No       | -1.0 to 1.0 (step: 0.001) |
| `qy`      | Y component of the quaternion (w, x, y, z). (default: 0.0) | FLOAT     | No       | -1.0 to 1.0 (step: 0.001) |
| `qz`      | Z component of the quaternion (w, x, y, z). (default: 0.0) | FLOAT     | No       | -1.0 to 1.0 (step: 0.001) |

**Note:** When `mode` is `"euler_xyz"` and all three angles are 0.0, or when `mode` is `"quaternion"` and the quaternion is the identity (1, 0, 0, 0), the mesh is returned unchanged. The quaternion is automatically normalized before use; if its magnitude is too close to zero, the node raises an error.

## Outputs

| Output Name | Description                                                                                                                                                                         | Data Type |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- |
| `mesh`      | The rotated mesh. Vertices are rotated, and normals are rotated as directions. Tangents have their X, Y, Z components rotated while the W (handedness) component is kept unchanged. | MESH      |

> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/RotateMesh/en.md)

***

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