ComfyUI Node: HY-Motion MHR Loader

HY-Motion MHR Loader:

The HYMotionMHRLoader node is designed to facilitate the loading of MHR (Motion Human Representation) data, specifically vertices and camera translation, from NPZ files. This node is essential for users who need to work with 3D motion data in a structured and efficient manner. By leveraging this node, you can seamlessly import complex motion data into your workflow, enabling further processing or conversion tasks. The primary goal of the HYMotionMHRLoader is to provide a straightforward method for accessing and utilizing MHR data, ensuring that you can focus on creative tasks without getting bogged down by technical complexities. This node is particularly beneficial for AI artists and developers working with 3D motion capture data, as it abstracts the intricacies of data loading and validation, allowing you to concentrate on the artistic and functional aspects of your projects.

HY-Motion MHR Loader Input Parameters:

mhr_name

The mhr_name parameter is a required input that specifies the name of the MHR NPZ file you wish to load. This parameter is crucial as it determines which file from the output/hymotion_npz or input/hymotion_npz directories will be accessed. The NPZ file should contain the necessary motion data, including vertices and camera translation, which are essential for further processing. The selection of the correct file is vital for ensuring that the data loaded is accurate and relevant to your project. There are no specific minimum, maximum, or default values for this parameter, but it must correspond to a valid file name within the designated directories.

HY-Motion MHR Loader Output Parameters:

mhr_params

The mhr_params output parameter provides a dictionary containing the loaded MHR data, specifically the vertices and cam_t (camera translation). This output is crucial as it forms the basis for any subsequent processing or conversion tasks you may wish to perform. The vertices represent the 3D points of the motion capture data, while cam_t provides the necessary camera translation information to accurately position the data in a 3D space. Understanding and utilizing this output effectively allows you to integrate complex motion data into your projects, enabling more dynamic and realistic animations or simulations.

HY-Motion MHR Loader Usage Tips:

• Ensure that the NPZ file you select contains both vertices and cam_t data to avoid errors during loading.
• Organize your NPZ files in the output/hymotion_npz or input/hymotion_npz directories for easy access and selection within the node.

HY-Motion MHR Loader Common Errors and Solutions:

MHR file not found: <mhr_name>

• Explanation: This error occurs when the specified NPZ file cannot be located in the designated directories.
• Solution: Verify that the file name is correct and that the file exists in either the output/hymotion_npz or input/hymotion_npz directory.

Selected file <mhr_name> is not a valid MHR export (missing 'vertices' or 'cam_t')

• Explanation: This error indicates that the chosen NPZ file does not contain the required vertices or cam_t data.
• Solution: Ensure that the NPZ file is correctly formatted and includes both vertices and cam_t data. If necessary, regenerate the file with the correct data.