ComfyUI Node: ◎ Radiance Rolling Shutter

◎ Radiance Rolling Shutter:

The RadianceRollingShutter node is designed to simulate the artifacts commonly associated with rolling shutter cameras, such as skew, wobble, and flash banding. These artifacts occur due to the way rolling shutter cameras capture images, scanning either vertically or horizontally across the frame. This node allows you to recreate these effects digitally, providing a realistic representation of how motion and lighting can affect images captured with rolling shutter technology. By using this node, you can add a layer of authenticity to your digital art, especially when aiming to mimic the imperfections seen in real-world photography and videography. The node's capabilities are particularly beneficial for artists looking to enhance their work with realistic motion effects or to simulate specific camera behaviors.

◎ Radiance Rolling Shutter Input Parameters:

image

The image parameter is a tensor representing the image data that will be processed by the node. This input is crucial as it serves as the base upon which the rolling shutter effects will be applied. The image should be in a format compatible with PyTorch tensors.

skew_amount

The skew_amount parameter determines the degree of skew applied to the image. A higher value results in more pronounced skewing, simulating the effect of rapid motion during image capture. This parameter allows you to control the intensity of the skew effect, with no explicit minimum or maximum values provided, but typically ranging from 0.0 for no skew to higher values for more distortion.

shutter_direction

The shutter_direction parameter specifies the direction of the rolling shutter effect, with options being "Vertical" or "Horizontal". This choice affects how the skew and wobble are applied across the image, simulating different types of rolling shutter cameras.

wobble_frequency

The wobble_frequency parameter controls the frequency of the wobble effect, which adds a sinusoidal distortion to the image. This parameter is useful for simulating the oscillations that can occur in rolling shutter cameras, with a default value of 0.0 indicating no wobble.

wobble_amplitude

The wobble_amplitude parameter sets the amplitude of the wobble effect. A higher amplitude results in more noticeable wobbling, enhancing the realism of the rolling shutter simulation. The default value is 0.0, meaning no wobble is applied unless specified.

flash_band_position

The flash_band_position parameter indicates the position of the flash band effect within the image. This effect simulates the appearance of a bright band caused by a flash during the rolling shutter capture. The default value is -1.0, which typically means the effect is not applied unless adjusted.

flash_band_width

The flash_band_width parameter defines the width of the flash band effect. A larger width results in a broader band, affecting more of the image. The default value is 0.1, providing a subtle flash band effect.

use_gpu

The use_gpu parameter is a boolean that determines whether the GPU should be used for processing. Enabling this option can significantly speed up the computation, especially for large images, by leveraging the parallel processing capabilities of modern GPUs.

◎ Radiance Rolling Shutter Output Parameters:

processed_image

The processed_image is the output tensor that contains the image data after the rolling shutter effects have been applied. This output reflects the combined effects of skew, wobble, and flash banding, providing a modified version of the input image that simulates the characteristics of a rolling shutter camera.

◎ Radiance Rolling Shutter Usage Tips:

• Experiment with different skew_amount values to achieve the desired level of distortion, keeping in mind that higher values can create more dramatic effects.
• Use the shutter_direction parameter to simulate different types of rolling shutter cameras, choosing "Vertical" for effects similar to those seen in many smartphones and "Horizontal" for other camera types.
• Adjust the wobble_frequency and wobble_amplitude parameters together to create realistic oscillations, which can add a dynamic feel to your images.
• Consider enabling use_gpu for faster processing, especially when working with high-resolution images or when applying multiple effects simultaneously.

◎ Radiance Rolling Shutter Common Errors and Solutions:

RuntimeError: CUDA out of memory

• Explanation: This error occurs when the GPU does not have enough memory to process the image with the current settings.
• Solution: Try reducing the image size or complexity, or disable the use_gpu option to process the image on the CPU instead.

ValueError: Invalid shutter direction

• Explanation: This error is raised when an unsupported value is provided for the shutter_direction parameter.
• Solution: Ensure that the shutter_direction is set to either "Vertical" or "Horizontal".

TypeError: Image must be a torch.Tensor

• Explanation: This error indicates that the input image is not in the expected tensor format.
• Solution: Convert your image to a PyTorch tensor before passing it to the node.