H3 Motion Editor (timeline, masks, automation) [alpha]:
The H3MotionEditor is a dynamic and versatile node designed to provide a digital audio workstation (DAW)-style timeline and mask editing capabilities for motion editing. This node allows you to interactively edit motion sequences by dragging time blocks on a timeline, painting problem areas frame by frame, and adjusting parameters such as feathering, growth, and fade for each block. It also supports drawing automation envelopes for hold, feather, and strength, making it a powerful tool for fine-tuning motion sequences. The H3MotionEditor is particularly beneficial for AI artists looking to refine motion sequences with precision, as it outputs hold maps and masks that can be seamlessly integrated with other nodes like H3 Time Smear and H3 Motion Composite. The node is designed to keep upstream data cached between edits, ensuring that only the regeneration side is re-run after modifications, thus optimizing workflow efficiency.
H3 Motion Editor (timeline, masks, automation) [alpha] Input Parameters:
images
This parameter represents the input images or frames that you want to edit using the H3MotionEditor. It serves as the baseline for the motion editing process, allowing you to apply various transformations and adjustments to enhance the motion sequence.
editor_state
The editor_state parameter is a serialized string that maintains the current state of the editor. It is crucial for preserving your edits and configurations across sessions, ensuring that you can continue working from where you left off without losing any progress. This parameter is automatically managed by the GUI widget.
samples
This optional parameter refers to the baseline latent samples used for the jerk profile. It provides additional context for the motion editing process, allowing for more precise adjustments and refinements based on the underlying latent data.
oracle_hold_map
The oracle_hold_map is an optional input that provides a precomputed hold map for adaptive dilation. It is used to guide the motion editing process, ensuring that the adjustments align with the intended pacing and attention of the motion sequence.
H3 Motion Editor (timeline, masks, automation) [alpha] Output Parameters:
hold_map
The hold_map output is a crucial component that feeds into the H3 Time Smear node. It represents the adaptive dilation map, indicating where and how the motion sequence should be adjusted to achieve the desired effect. This output is essential for maintaining the intended pacing and attention of the motion sequence.
mask
The mask output is designed to be used with the H3 Motion Composite node. It provides a feathered and envelope-scaled mask that defines the areas of the motion sequence that require regeneration or adjustment. This output is vital for achieving seamless integration with other nodes and ensuring that the final output meets your artistic vision.
H3 Motion Editor (timeline, masks, automation) [alpha] Usage Tips:
- To optimize the performance of the H3MotionEditor, ensure that you queue the baseline frames and latent data once to load the filmstrip before making any edits. This will streamline the editing process and reduce the need for repeated data loading.
- Utilize the automation envelopes for hold, feather, and strength to achieve precise control over the motion sequence. These envelopes allow you to fine-tune the adjustments and ensure that the final output aligns with your artistic goals.
- Take advantage of the caching mechanism to minimize reprocessing time. By keeping upstream data cached, you can focus on refining the regeneration side without having to re-run the entire process after each edit.
H3 Motion Editor (timeline, masks, automation) [alpha] Common Errors and Solutions:
[MAINodes] H3 Motion Editor (timeline, masks, automation) [alpha]: <parameter_name>=<value> is not usable (widget values shifted?); using <default>
- Explanation: This error occurs when the widget values are shifted or incorrect, causing the parameter to be unusable. It typically happens due to interactive edits that misalign the expected input values.
- Solution: Ensure that the input values are correctly aligned and match the expected format. If the error persists, consider resetting the widget values to their default state and re-entering the desired configurations.