ComfyUI Node: HY-Motion 3D Model Loader

HY-Motion 3D Model Loader:

The HYMotion3DModelLoader is a specialized node designed to facilitate the loading and manipulation of 3D models within the HY-Motion framework. Its primary purpose is to enable users to import 3D models into their projects, allowing for detailed transformations and animations. This node is particularly beneficial for AI artists who wish to incorporate complex 3D elements into their creative workflows, as it provides a straightforward method to adjust model positioning, rotation, and scaling. By offering a range of transformation parameters, the HYMotion3DModelLoader ensures that models can be seamlessly integrated into various scenes, enhancing the visual storytelling capabilities of your projects. The node's ability to handle manual rig poses further adds to its versatility, making it an essential tool for those looking to create dynamic and engaging 3D animations.

HY-Motion 3D Model Loader Input Parameters:

model_path

The model_path parameter specifies the file path to the 3D model you wish to load. It is crucial for locating the model file within your project's directory structure. The path can be relative, starting with "input/" or "output/", or it can be an absolute path. If set to "none", the node will not load any model. This parameter does not have a default value as it is essential for the node's operation.

translate_x

The translate_x parameter controls the horizontal translation of the model along the X-axis. It allows you to move the model left or right within the scene. The default value is 0.0, with no specified minimum or maximum values, providing flexibility in positioning.

translate_y

The translate_y parameter adjusts the vertical translation of the model along the Y-axis, enabling you to move the model up or down. Like translate_x, it defaults to 0.0 and offers unrestricted movement.

translate_z

The translate_z parameter manages the depth translation of the model along the Z-axis, allowing you to move the model forward or backward. It also defaults to 0.0, with no set limits on movement.

rotate_x

The rotate_x parameter defines the rotation of the model around the X-axis, measured in degrees. This allows for tilting the model forward or backward. The default value is 0.0 degrees.

rotate_y

The rotate_y parameter specifies the rotation around the Y-axis, enabling you to spin the model left or right. It defaults to 0.0 degrees.

rotate_z

The rotate_z parameter controls the rotation around the Z-axis, allowing for twisting the model. The default value is 0.0 degrees.

scale_x

The scale_x parameter determines the scaling factor along the X-axis, affecting the model's width. The default value is 1.0, indicating no scaling, with no specified limits.

scale_y

The scale_y parameter sets the scaling factor along the Y-axis, impacting the model's height. It defaults to 1.0, with no constraints on scaling.

scale_z

The scale_z parameter adjusts the scaling factor along the Z-axis, influencing the model's depth. The default value is 1.0, allowing for flexible scaling.

start_frame

The start_frame parameter indicates the starting frame for animations, allowing you to define when the model's animation sequence begins. The default value is 0.

end_frame

The end_frame parameter specifies the ending frame for animations, marking the conclusion of the model's animation sequence. The default value is 0.

start_pose_json

The start_pose_json parameter allows you to define the initial pose of the model using a JSON string. This is useful for setting up specific starting positions for animations. The default value is an empty JSON object "{}".

end_pose_json

The end_pose_json parameter enables you to specify the final pose of the model using a JSON string, providing control over the model's ending position in animations. The default value is an empty JSON object "{}".

HY-Motion 3D Model Loader Output Parameters:

model_data

The model_data output provides the loaded 3D model data, including any transformations applied. This data is essential for further processing or rendering within your project, allowing you to visualize and manipulate the model as needed.

transformation_matrix

The transformation_matrix output delivers the matrix representing all the transformations applied to the model, such as translation, rotation, and scaling. This matrix is crucial for understanding how the model has been altered and can be used for additional calculations or adjustments.

animation_data

The animation_data output contains information about the model's animation sequence, including start and end frames and any pose data. This output is vital for integrating the model's animations into your project, ensuring smooth and coherent motion.

HY-Motion 3D Model Loader Usage Tips:

• Ensure that the model_path is correctly specified to avoid loading errors. Use relative paths for easier management within your project directory.
• Utilize the transformation parameters to position and orient your model accurately within the scene, enhancing the overall composition and visual impact.
• Experiment with different scaling factors to achieve the desired proportions for your model, ensuring it fits well within the context of your project.

HY-Motion 3D Model Loader Common Errors and Solutions:

Model path not found

• Explanation: This error occurs when the specified model_path does not point to a valid file.
• Solution: Verify that the path is correct and that the file exists in the specified location. Use relative paths for consistency.

Invalid transformation values

• Explanation: This error arises when non-numeric values are provided for transformation parameters.
• Solution: Ensure all transformation parameters are numeric and within a reasonable range to avoid unexpected behavior.

Animation frame mismatch

• Explanation: This error happens when the start_frame is greater than the end_frame.
• Solution: Check and adjust the frame values to ensure the start_frame is less than or equal to the end_frame.