ComfyUI Node: H3 Clock Remap (any model, presets)

H3 Clock Remap (any model, presets):

The H3ClockRemap node is designed to retime a hold map onto the clock of a target model, allowing for seamless integration of different model profiles with your creative projects. This node is particularly useful for AI artists who work with various models and need to ensure that their hold maps are compatible with the specific timing and grid requirements of each model. By remapping the hold map, the node ensures that the output aligns with the target model's legal frame grid, facilitating smooth transitions and accurate reproductions of the intended visual effects. The node supports various model profiles, including custom configurations, providing flexibility and adaptability to different creative needs. It also carries the target grid inside the map, enabling precise padding and recovery processes, which are crucial for maintaining the integrity of the visual output.

H3 Clock Remap (any model, presets) Input Parameters:

hold_map

The hold_map parameter represents the input hold map that you want to retime onto a target model's clock. This map can originate from various sources such as the H3 Jerk Oracle, H3 Manual Hold Map, or H3 Drawn Plan. It is a JSON object that contains information about the holds and the world length. The hold map is crucial as it dictates the timing and duration of each hold, which will be adjusted according to the target model's profile.

model_profile

The model_profile parameter specifies the target model's profile onto which the hold map will be retimed. This can be a predefined model profile like ltx-2.5 or minimax-h3, or a custom profile if the model does not have a preset. The choice of model profile affects how the holds are scaled and quantized, ensuring that the output map aligns with the target model's legal frame grid. This parameter is essential for achieving the desired timing and visual effects in your project.

custom_block

When using a custom model profile, the custom_block parameter defines the size of the time block for the custom configuration. This parameter is only applicable if the model_profile is set to custom. It allows you to specify the granularity of the time blocks, which can impact the precision and smoothness of the retimed hold map.

custom_hold_scale

The custom_hold_scale parameter is used in conjunction with a custom model profile to scale the holds in the input map. This scaling factor adjusts the duration of holds, ensuring they fit within the custom time blocks defined by the custom_block parameter. It is crucial for maintaining the proportionality and timing of the original hold map in the custom configuration.

custom_legal_step

The custom_legal_step parameter defines the step size for legal frame grid alignment in a custom model profile. It determines how the retimed hold map aligns with the target model's frame grid, ensuring that the output is legally compliant with the model's timing requirements. This parameter is important for achieving accurate and consistent visual results.

custom_legal_offset

The custom_legal_offset parameter specifies the offset for aligning the retimed hold map with the target model's legal frame grid in a custom configuration. It provides additional control over the positioning of the hold map within the frame grid, allowing for fine-tuning of the visual output.

custom_fps

The custom_fps parameter sets the frames per second for the custom model profile. This parameter is crucial for ensuring that the retimed hold map matches the playback speed and timing of the target model, providing a smooth and coherent visual experience.

H3 Clock Remap (any model, presets) Output Parameters:

remapped_hold_map

The remapped_hold_map is the primary output of the H3ClockRemap node. It is a JSON object that contains the retimed hold map, adjusted to fit the target model's clock and legal frame grid. This output is essential for ensuring that the visual effects align with the timing and grid requirements of the chosen model profile.

total_length

The total_length output represents the total length of the retimed hold map in terms of frames. It provides a measure of the duration of the output map, which is important for understanding how the retimed map fits within the overall timeline of your project.

report

The report output provides a textual summary of the retiming process, including any warnings or notes about the profile being unmeasured or requiring multiple passes. This output is valuable for understanding the implications of the retiming process and for troubleshooting any issues that may arise.

profile

The profile output indicates the model profile used for the retiming process. It confirms the profile applied to the hold map, ensuring that the output aligns with the intended model configuration.

H3 Clock Remap (any model, presets) Usage Tips:

• When working with custom model profiles, ensure that all custom parameters (custom_block, custom_hold_scale, custom_legal_step, custom_legal_offset, custom_fps) are set appropriately to achieve the desired timing and visual effects.
• Use the report output to identify any potential issues with the retiming process, such as unmeasured profiles or the need for multiple passes, and adjust your parameters accordingly.
• Save successful custom configurations as presets in ``/mainodes_models.json for easy reuse in future projects.

H3 Clock Remap (any model, presets) Common Errors and Solutions:

ValueError: "no-such-model"

• Explanation: This error occurs when an unknown or unsupported model profile is specified in the model_profile parameter.
• Solution: Ensure that the model_profile parameter is set to a valid and supported model profile. If using a custom profile, verify that all necessary custom parameters are correctly configured.

"UNMEASURED" in report

• Explanation: The report indicates that the selected model profile is unmeasured, meaning that its timing and grid alignment have not been fully validated.
• Solution: Consider using a different model profile that has been measured and validated, or proceed with caution and verify the output manually to ensure it meets your requirements.