ComfyUI Node: HY-Motion Preview

HY-Motion Preview:

The HYMotionPreview node is designed to provide an interactive 3D motion preview using Three.js, a popular JavaScript library for 3D graphics. This node allows you to visualize motion data in a dynamic and engaging way, offering playback controls and the ability to export animations in the GLB format, which includes skeleton animation. The primary goal of this node is to facilitate the examination and refinement of motion data by providing a real-time preview environment. This capability is particularly beneficial for AI artists and developers who need to assess the quality and accuracy of motion sequences before finalizing their projects. By leveraging the power of Three.js, the HYMotionPreview node ensures that you can interact with and manipulate motion data efficiently, enhancing your workflow and creative process.

HY-Motion Preview Input Parameters:

motion_data

The motion_data parameter is a required input that represents the motion data you wish to preview. This data is expected to be in the HYMOTION_DATA format, which typically includes information such as quaternions, translations, number of frames, number of joints, frames per second (fps), and additional descriptive text. This parameter is crucial as it forms the basis of the 3D motion preview, allowing the node to render the motion sequence accurately.

sample_index

The sample_index parameter is an optional integer input that allows you to specify which sample of the motion data to preview. It has a default value of 0, with a minimum value of 0 and a maximum value of 3. This parameter is useful when you have multiple samples of motion data and want to preview a specific one. By adjusting the sample_index, you can quickly switch between different motion samples to compare and analyze them within the preview environment.

HY-Motion Preview Output Parameters:

motion_data

The motion_data output parameter returns a string representation of the motion data that has been processed and prepared for preview. This output is essential as it encapsulates the motion sequence in a format that can be rendered by the 3D preview environment. The output data includes all necessary components, such as quaternions, translations, and metadata, ensuring that the preview accurately reflects the intended motion sequence.

HY-Motion Preview Usage Tips:

• To optimize the performance of the HYMotionPreview node, ensure that your motion data is well-structured and free of errors. This will help the node render the preview smoothly and accurately.
• Experiment with different sample_index values to quickly compare various motion samples. This can be particularly useful when working with multiple iterations of motion data, allowing you to identify the best version for your project.

HY-Motion Preview Common Errors and Solutions:

Invalid motion_data format

• Explanation: This error occurs when the input motion_data does not conform to the expected HYMOTION_DATA format, which may result from missing or incorrectly structured data.
• Solution: Verify that your motion data includes all necessary components, such as quaternions, translations, and metadata, and ensure it is correctly formatted before inputting it into the node.

Sample index out of range

• Explanation: This error arises when the sample_index value exceeds the available range of motion samples, which can happen if you input a value greater than the maximum allowed index.
• Solution: Check the number of available motion samples and adjust the sample_index to fall within the valid range, ensuring it does not exceed the maximum index of 3.