ComfyUI Node: ◎ Radiance Read (Video)

◎ Radiance Read (Video):

RadianceReadVideo is a versatile node designed for AI artists and video professionals who need to process video files efficiently. This node serves as a universal VFX video reader, capable of reading video files, applying input transforms such as converting logarithmic color spaces to linear, and extracting audio. It outputs an image batch along with metadata, making it suitable for downstream processing in creative workflows. The node is particularly beneficial for those working with complex video projects, as it simplifies the process of handling video data by providing a streamlined method to read and transform video content while maintaining high-quality output. Its ability to handle various video formats and extract essential metadata ensures that users can seamlessly integrate video content into their AI-driven projects.

◎ Radiance Read (Video) Input Parameters:

video_path

The video_path parameter specifies the file path to the video you wish to process. It is a string input, with a default value of "C:/Projects/footage.mp4". This parameter is crucial as it directs the node to the correct video file for reading and processing.

start_frame

The start_frame parameter determines the initial frame from which the video reading will commence. It is an integer input with a default value of 0, and it can range from 0 to 999,999. This parameter allows you to skip to a specific point in the video, which is useful for processing only a portion of the video.

frame_count

The frame_count parameter specifies the number of frames to read from the video. It is an integer input with a default value of 0, which indicates that all frames should be loaded. The range is from 0 to 999,999. This parameter helps control the amount of video data processed, which can be useful for managing performance and resource usage.

input_colorspace

The input_colorspace parameter defines the color space of the input video. This parameter is essential for ensuring that the video is processed with the correct color transformations, maintaining color accuracy in the output.

frame_stride

The frame_stride parameter determines the interval at which frames are read from the video. By setting this parameter, you can skip frames, which can be useful for creating time-lapse effects or reducing the amount of data processed.

extract_audio

The extract_audio parameter is a boolean that indicates whether audio should be extracted from the video. By default, it is set to True. This parameter is useful for projects that require both video and audio data.

vhs_video

The vhs_video parameter allows you to specify an alternative video source, either as a string path, a dictionary with a "source" key, or a list. This flexibility is useful for dynamically selecting video sources in complex workflows.

◎ Radiance Read (Video) Output Parameters:

IMAGE

The IMAGE output is a batch of frames extracted from the video, processed and transformed according to the specified input parameters. This output is crucial for further image processing tasks in your workflow.

MASK

The MASK output provides a mask for the video frames, typically used for compositing or other image processing tasks that require masking.

frame_count

The frame_count output indicates the number of frames that were successfully read and processed from the video. This information is useful for verifying that the correct amount of video data was handled.

width

The width output specifies the width of the video frames in pixels. This output is important for understanding the resolution of the processed video content.

height

The height output specifies the height of the video frames in pixels, providing insight into the resolution of the video content.

fps

The fps output indicates the frames per second of the video, which is essential for maintaining the correct playback speed and timing in video projects.

audio

The audio output contains the extracted audio data from the video, if available. This output is important for projects that require synchronized audio and video content.

video

The video output provides metadata about the processed video, which can be used for further processing or documentation purposes.

◎ Radiance Read (Video) Usage Tips:

• Ensure that the video_path is correctly set to avoid file not found errors. Double-check the path for typos or incorrect directories.
• Use the frame_stride parameter to efficiently process large videos by skipping frames, which can save time and computational resources.
• If you only need a specific section of the video, adjust the start_frame and frame_count parameters to limit the processing to the desired segment.
• When working with videos that have different color spaces, make sure to set the input_colorspace parameter correctly to maintain color accuracy.

◎ Radiance Read (Video) Common Errors and Solutions:

Video file not found: <video_path>

• Explanation: This error occurs when the specified video file path does not exist or is incorrect.
• Solution: Verify that the video_path is correct and that the file exists at the specified location. Check for typos or incorrect directory paths.

Could not open video: <video_path>

• Explanation: This error indicates that the video file could not be opened, possibly due to file corruption or unsupported format.
• Solution: Ensure that the video file is not corrupted and is in a supported format. Try opening the video with a standard media player to verify its integrity.

No frames were read from video

• Explanation: This error occurs when the node fails to read any frames from the video, possibly due to an incorrect start_frame or frame_count.
• Solution: Check the start_frame and frame_count parameters to ensure they are within the valid range for the video. Adjust these parameters if necessary.