RotateMesh - ComfyUI Built-in Node Documentation - ComfyUI

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"` `"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

Source fingerprint (SHA-256): 38b120a3f719264d1269275ecfefa145b507c688735e4a461bb89517c697674f