H3 Continuum Video Adapter:
H3ContinuumVideoAdapter prepares a video for use with the H3 Continuum workflow by converting the video into a sequence of image frames while keeping its audio available separately. It uses frame-rate resampling so the video can be adapted to the frame rate expected by H3 Video Guide, with a recommended rate of 24 frames per second. This process changes how frames are sampled without intentionally changing the video's nominal duration or the audio track. The node is designed as a simple adapter for Core Load Video content, with no file-selection controls or enable switch of its own. To disconnect the optional sampler inputs connected to this adapter, disable the complete video-input group or bypass the adapter in your workflow.
H3 Continuum Video Adapter Input Parameters:
video
The video to adapt. This should be a video value supplied by a compatible video-loading or video-processing node, such as Core Load Video. The node reads the video's image frames, source frame rate, and audio track, then prepares those components for the H3 Continuum workflow. The image portion is resampled according to force_rate; the audio is passed through unchanged when audio is available. The video must provide the expected video components, including a valid frame rate. This input has no selectable default, minimum, maximum, or option list defined by the node.
force_rate
Controls the frame rate used when creating the output image sequence. The default is 24.0 frames per second, which is the recommended setting for H3 Video Guide and usually provides the expected timing for H3 Continuum video guidance. The allowed range is from 0.0 to 120.0, with a step size of 0.01. A value of 24.0 resamples the source frames to 24 frames per second while preserving the video's nominal duration and leaving audio unchanged. A value of 0.0 keeps the source frames rather than applying the usual H3 frame-rate conversion, so it is generally not recommended when preparing video specifically for H3 Video Guide. Higher or lower positive values change the number and timing of generated image frames to match the requested rate; they do not change the audio track.
H3 Continuum Video Adapter Output Parameters:
images
The video converted into an image-frame sequence. Each image represents a video frame after resampling to the requested force_rate. This output is intended to connect to H3 Continuum or other image-sequence inputs that need individual frames rather than a combined video object. With the default rate of 24.0, the sequence is prepared at 24 frames per second while maintaining the source video's nominal duration. Changing force_rate can change how many frames are produced and how closely motion is represented, especially when the source frame rate differs from the requested rate.
audio
The audio component associated with the input video. When the input contains audio, this output passes that audio through without resampling or other changes from this adapter. When the input has no audio, the node produces an execution blocker for this output so downstream audio-dependent processing can recognize that audio is unavailable instead of receiving a valid audio track. The audio output therefore preserves the original sound when present, but it does not create missing audio.
H3 Continuum Video Adapter Usage Tips:
- Keep
force_rateat its default value of24.0when preparing footage for H3 Video Guide, since the node description identifies 24 frames per second as H3's expected rate. - Use
force_ratevalues from0.01through120.0when you intentionally need a different output frame rate. Select a rate that matches the requirements of the downstream video or image-sequence workflow. - Use
force_rateof0.0only when you need to keep the source frames rather than resample them. This is described as not normally appropriate for H3 processing. - Remember that resampling affects the image-frame sequence, not the audio. The adapter is useful when you need H3-compatible frames while retaining the original sound timing.
- Ensure that the video comes from a node that provides a valid video object and frame rate. A regular image, an unsupported data type, or an incomplete video value cannot be adapted by this node.
- When audio is optional, check whether the source video actually contains an audio track. A missing track produces an execution blocker on
audioand should be handled by bypassing audio-dependent downstream nodes or supplying audio through another supported workflow. - To disconnect optional sampler inputs, disable the entire video-input group or bypass this adapter. The node itself does not provide a separate file selector or enable control.
H3 Continuum Video Adapter Common Errors and Solutions:
TypeError or video.get_components is unavailable
- Explanation: The value connected to
videois not a compatible video object. The adapter expects a video value with video components, including frames and a source frame rate. - Solution: Connect the output of a compatible video-loading or video-processing node, such as Core Load Video, and make sure an image, mask, or other non-video value has not been connected accidentally.
Fraction(components.frame_rate) conversion error
- Explanation: The input video does not contain a valid frame rate, or its frame-rate value is missing or stored in an unsupported form. The adapter needs this value to calculate the new frame timing.
- Solution: Check the source video metadata and reload or re-encode the video with a valid frame rate. If the problem affects only one file, test another video to determine whether the source metadata is damaged or incomplete.
force_rate is outside the allowed range
- Explanation: The requested rate is below
0.0or above120.0. The node defines a minimum of0.0and a maximum of120.0. - Solution: Set
force_rateto a value from0.0through120.0. For H3 Video Guide, use the default24.0.
force_rate has an invalid numeric value
- Explanation: The frame-rate control received text, an empty value, or another value that cannot be interpreted as a floating-point number. The node requires a numeric rate.
- Solution: Enter a number such as
24.0and remove any non-numeric characters. If the value comes from another node, verify that its output is a numeric value.
_resample_video_frames processing error
- Explanation: The frame-resampling operation could not process the source image sequence. This can occur when the source contains invalid, inaccessible, or unsupported frame data, or when the video metadata does not match its actual frames.
- Solution: Confirm that the source video plays correctly, reload it, and try converting it to a commonly supported video format with consistent frame timing. Also test a short clip to determine whether the issue is specific to the file.
audio is blocked or unavailable downstream
- Explanation: The source video has no audio track. In this situation, the adapter intentionally returns an execution blocker for
audiorather than creating silent or artificial audio. - Solution: Use a source video that contains audio, connect a separate supported audio source where the downstream workflow permits it, or bypass nodes that require audio.
H3 workflow receives an unexpected number of frames
- Explanation: The selected
force_ratedetermines how the image sequence is resampled. A value other than the source rate can increase or decrease the number of frames while preserving the nominal duration. - Solution: Set
force_rateto24.0for the normal H3 Video Guide workflow, or choose a deliberate rate required by the downstream node. Check that the source duration and frame rate are correct before processing.
