ComfyUI Node: Scheduled Image Displacement

Scheduled Image Displacement:

SaltScheduledImageDisplacement is a powerful node designed to apply scheduled displacement effects to a batch of images. This node allows you to manipulate images by displacing their pixels based on a displacement map, with the displacement intensity and direction controlled by scheduled amplitude and angle values. This functionality is particularly useful for creating dynamic visual effects that evolve over time, such as simulating waves, distortions, or other complex transformations. By leveraging this node, you can achieve intricate and visually appealing results that enhance the artistic quality of your projects.

Scheduled Image Displacement Input Parameters:

images

This parameter represents the batch of images to which the displacement effect will be applied. The images should be in a tensor format with dimensions corresponding to batch size, height, width, and channels. The quality and resolution of the input images directly impact the final output.

displacement_images

This parameter is the batch of displacement maps used to determine how the pixels in the input images will be displaced. Each displacement map should match the dimensions of the corresponding input image. The displacement maps guide the direction and magnitude of pixel shifts, creating the desired visual effect.

amplitude_schedule

This optional parameter is a list or tensor of amplitude values that control the intensity of the displacement effect for each image in the batch. If not provided or if the list is shorter than the batch size, a default amplitude of 0 will be used for the remaining images. The amplitude values determine how far the pixels are displaced, with higher values resulting in more pronounced effects.

angle_schedule

This optional parameter is a list or tensor of angle values that specify the direction of the displacement effect for each image in the batch. If not provided or if the list is shorter than the batch size, a default angle of 0 will be used for the remaining images. The angle values are measured in degrees and dictate the direction in which the pixels are shifted.

Scheduled Image Displacement Output Parameters:

displaced_images

This output parameter is the batch of images that have been processed with the displacement effect. Each image in the batch is displaced according to the corresponding displacement map, amplitude, and angle values. The resulting images exhibit the visual transformations specified by the input parameters, providing a dynamic and artistic effect.

Scheduled Image Displacement Usage Tips:

• To achieve smooth and continuous displacement effects, ensure that the amplitude and angle schedules are carefully crafted and gradually change over time.
• Experiment with different displacement maps to create unique and varied visual effects. Combining multiple displacement maps can lead to more complex and interesting results.
• Use higher amplitude values for more dramatic effects, but be cautious as excessively high values may distort the image beyond recognition.

Scheduled Image Displacement Common Errors and Solutions:

"Input images and displacement images must have the same dimensions"

• Explanation: This error occurs when the dimensions of the input images and the displacement images do not match.
• Solution: Ensure that each displacement image has the same height and width as the corresponding input image. Resize the displacement images if necessary.

"Amplitude schedule length is shorter than batch size"

• Explanation: This error occurs when the amplitude schedule provided is shorter than the number of images in the batch.
• Solution: Provide an amplitude schedule with a length equal to or greater than the batch size, or ensure that the default amplitude value is acceptable for the remaining images.

"Angle schedule length is shorter than batch size"

• Explanation: This error occurs when the angle schedule provided is shorter than the number of images in the batch.
• Solution: Provide an angle schedule with a length equal to or greater than the batch size, or ensure that the default angle value is acceptable for the remaining images.