HY-Motion 2D Motion Preview

Visualize motion data in 2D for animation preview and refinement, aiding artists and developers in assessing flow and timing efficiently.

HY-Motion 2D Motion Preview:

The HYMotionPreview2D node is designed to provide a visual representation of motion data in a 2D format, allowing you to preview animations and movements effectively. This node is particularly beneficial for artists and developers working with motion data, as it enables them to visualize and refine animations before finalizing them. By rendering a 2D preview, you can quickly assess the motion's flow, timing, and overall aesthetic without needing to engage in more resource-intensive 3D rendering processes. The node's primary function is to generate an image or sequence of images that depict the motion data, making it easier to identify any necessary adjustments or improvements. This capability is crucial for ensuring that the final animation meets the desired artistic and technical standards.

HY-Motion 2D Motion Preview Input Parameters:

width

This parameter specifies the width of the rendered preview image in pixels. It allows you to control the horizontal resolution of the output, which can impact the clarity and detail of the preview. The width can be set between 128 and 2048 pixels, with a default value of 512 pixels. Adjusting this parameter can help balance between image quality and processing time.

height

Similar to the width parameter, this defines the height of the rendered preview image in pixels. It determines the vertical resolution of the output, affecting the image's aspect ratio and detail. The height can also be set between 128 and 2048 pixels, with a default value of 512 pixels. Choosing the appropriate height is essential for maintaining the desired aspect ratio and visual quality.

up_axis

This parameter allows you to select the vertical axis of the motion data, which is crucial for correctly orienting the preview. The options are "y" and "z", with "y" being the default setting used by HY-Motion. Selecting the correct up axis ensures that the motion data is displayed accurately in the preview.

batch_index

This parameter specifies the index of the sample to preview when multiple motions are generated in a batch. It allows you to select a specific motion from a batch for visualization. The batch index ranges from 0 to 64, with a default value of 0. This is useful when working with multiple animations, as it enables you to focus on a particular sample.

frame_index

This parameter determines the specific frame to display when frame_skip is set to 0, which is the single frame mode. It allows you to select a particular moment in the animation for detailed examination. The frame index ranges from 0 to 1000, with a default value of 0. This is particularly useful for analyzing specific frames in detail.

frame_skip

This parameter controls the frame skipping behavior during animation rendering. A value of 0 enables single frame preview, while values of 1 or more render an animation sequence, skipping the specified number of frames between renders. The frame skip ranges from 0 to 100, with a default value of 1. Adjusting this parameter can help manage the animation's playback speed and smoothness.

keep_duration

This boolean parameter, when enabled, duplicates rendered frames to maintain the original animation length and speed when skipping frames. It ensures that the animation's timing remains consistent, even when frames are skipped. The default value is False. This is useful for preserving the intended pacing of the animation.

max_frames

This parameter sets the maximum number of frames to render in animation mode, preventing memory issues during processing. It allows you to limit the number of frames generated, which can be crucial for managing system resources. The max frames range from 1 to 500, with a default value of 100. This helps ensure that the rendering process remains efficient and manageable.

draw_skeleton

This parameter determines whether to overlay a skeleton representation on the motion preview. It provides a visual guide to the underlying structure of the motion data, aiding in the analysis of movement and posture. This can be particularly helpful for identifying issues with joint positioning or movement flow.

elevation

This parameter adjusts the elevation angle of the camera view in the preview, allowing you to change the perspective from which the motion is viewed. This can help in visualizing the motion from different angles, providing a more comprehensive understanding of the animation.

azimuth

This parameter controls the azimuth angle of the camera view, affecting the horizontal rotation around the motion data. Adjusting the azimuth can help you view the motion from various sides, offering additional insights into the animation's dynamics.

scale

This parameter sets the scale of the motion data in the preview, allowing you to zoom in or out on the animation. Scaling can be useful for focusing on specific details or for getting an overview of the entire motion sequence.

force_root

This boolean parameter, when enabled, forces the root of the motion data to be at a fixed position in the preview. This can help in maintaining a consistent reference point for the animation, making it easier to analyze relative movements.

motion_data

This optional parameter allows you to input direct motion data from a sampler node. It provides a way to feed specific motion sequences into the preview, enabling targeted visualization and analysis.

npz_path

This optional parameter specifies the path to an .npz file containing motion data to preview. It allows you to load pre-existing motion data files for visualization, facilitating the review of previously generated animations.