ComfyUI Node: H3 Load Hold Map (sidecar)

H3 Load Hold Map (sidecar):

The H3LoadHoldMap node is designed to facilitate the seamless integration of hold maps across different graph sessions, allowing you to reuse timing decisions made in one graph for another. This node reads a hold-map sidecar file, which is typically generated by the H3SaveHoldMap node, enabling you to apply a pre-determined timing structure to a new video rendering session without needing to have both models in the same graph. This is particularly useful when working with complex video editing tasks that require precise timing adjustments, as it allows for the consistent application of timing decisions across different projects or models. By using this node, you can ensure that the temporal dynamics of your video clips are maintained, even when switching between different rendering environments or models.

H3 Load Hold Map (sidecar) Input Parameters:

path

The path parameter specifies the location of the hold-map file you wish to load. This can be a relative path using the SaveVideo prefix of the arm whose clock you want to retrieve, or an absolute path ending in .json. The default value is "video/derope". This parameter is crucial as it determines which hold-map file is used to drive the timing of your current project. If the path is incorrect or the file does not exist, the node will not be able to load the necessary timing data.

start

The start parameter allows you to specify the starting frame of a window of source frames to crop the clock. This is useful when the entire clip exceeds the model's per-pass capacity. The default value is 0, with a minimum of 0 and a maximum of 100000. This parameter helps in managing large clips by focusing on a specific segment, ensuring that the timing adjustments are applied only to the desired portion of the video.

length

The length parameter defines the duration of the window in source frames. A value of 0 indicates that the window extends to the end of the clip. Like the start parameter, it has a minimum of 0 and a maximum of 100000. This parameter works in conjunction with start to define the exact segment of the video that will be affected by the hold-map, providing flexibility in handling clips of varying lengths.

H3 Load Hold Map (sidecar) Output Parameters:

hold_map

The hold_map output provides the loaded hold-map data, which can be wired into nodes like H3 Clock Remap or H3 Time Smear. This output is essential for applying the timing structure defined in the hold-map to your current project, ensuring that the temporal dynamics are consistent with the original design.

world_len

The world_len output indicates the total length of the video in frames as defined by the hold-map. This information is useful for understanding the scope of the timing adjustments and ensuring that they align with the overall length of your video project.

path

The path output returns the path to the hold-map file that was loaded. This is useful for verification purposes, allowing you to confirm that the correct file was used in the process.

H3 Load Hold Map (sidecar) Usage Tips:

• Ensure that the path parameter is correctly set to the location of your hold-map file to avoid loading errors.
• Use the start and length parameters to focus on specific segments of your video, especially when dealing with large clips that exceed model capacity.
• Always verify the world_len output to ensure that the loaded hold-map aligns with the intended length of your video project.

H3 Load Hold Map (sidecar) Common Errors and Solutions:

FileNotFoundError

• Explanation: This error occurs when the specified hold-map file cannot be found at the given path.
• Solution: Double-check the path parameter to ensure it points to the correct location of the hold-map file. Verify that the file exists and that the path is correctly formatted.

ValueError: unknown model profile

• Explanation: This error indicates that the specified model profile is not recognized.
• Solution: Ensure that the model profile specified in your project is valid and recognized by the system. Check the available profiles and select one that matches your project's requirements.