ComfyUI Node: UniRig: Orientation Check

UniRig: Orientation Check:

The UniRigOrientationCheck node is designed to facilitate the visual verification of mesh orientation within the MIA pipeline, ensuring that your 3D models are correctly aligned before proceeding with rigging. This node renders your input mesh alongside a reference mesh, allowing you to visually compare and confirm that the orientation is correct. Specifically, for the MIA pipeline, it is crucial that the character is oriented with the Y-axis pointing upwards and facing the camera. This node helps prevent common orientation issues that can arise during the rigging process, saving time and reducing errors by providing a clear visual comparison. By using this node, you can ensure that your character models are properly aligned, which is essential for achieving accurate and efficient rigging results.

UniRig: Orientation Check Input Parameters:

mesh

The mesh parameter is the primary input for the UniRigOrientationCheck node, representing the 3D model you wish to verify. This parameter accepts a mesh in the TRIMESH format, which is a common representation for 3D models. The function of this parameter is to provide the node with the specific model that needs orientation verification. The impact of this parameter on the node's execution is significant, as it determines the model that will be rendered and compared against the reference mesh. There are no minimum, maximum, or default values for this parameter, as it is a required input that must be provided by the user.

max_height

The max_height parameter is an optional input that specifies the maximum height of each mesh render in pixels. This parameter allows you to control the resolution of the rendered images, which can affect the clarity and detail of the visual comparison. The default value for max_height is 512 pixels, with a minimum value of 256 pixels and a maximum value of 1024 pixels. The step value for adjusting this parameter is 64 pixels. By adjusting the max_height, you can balance between rendering performance and image quality, depending on your specific needs and the capabilities of your system.

UniRig: Orientation Check Output Parameters:

comparison

The comparison output parameter provides an image that visually compares the input mesh with the reference mesh. This output is crucial for determining whether the orientation of your model is correct. The image will display both meshes side-by-side, allowing you to easily identify any discrepancies in orientation. If the orientation is correct, the image will include a status text indicating that the orientation looks correct, with the character being Y-up and facing the viewer. If there are issues, a warning message will be displayed, suggesting that the tallest axis is not as expected. This output is essential for ensuring that your models are properly aligned before proceeding with further processing in the MIA pipeline.

UniRig: Orientation Check Usage Tips:

• Ensure that your input mesh is in the correct TRIMESH format to avoid compatibility issues and ensure accurate orientation checks.
• Adjust the max_height parameter based on your system's capabilities and the level of detail you require in the rendered comparison image.
• Use the visual comparison image to quickly identify and correct any orientation issues before proceeding with rigging, saving time and reducing potential errors.

UniRig: Orientation Check Common Errors and Solutions:

folder_paths not available

• Explanation: This error occurs when the folder_paths module is not available or cannot be imported, which may affect the node's ability to locate necessary files.
• Solution: Ensure that the folder_paths module is correctly installed and accessible in your environment. Check your installation and import paths to resolve this issue.

[WARNING] Check orientation: <axis> is tallest (expected Y)

• Explanation: This warning indicates that the tallest axis of your mesh is not the Y-axis, which is the expected orientation for the MIA pipeline.
• Solution: Rotate your mesh 90 degrees around the Y-axis in a 3D modeling software like Blender before exporting it again. This will align the mesh correctly with the Y-axis as the tallest.