ComfyUI Node: PixelFloat | GlitchNodes

PixelFloat | GlitchNodes:

The PixelFloat node is designed to apply visually striking gravity effects to pixel blocks within an image, leveraging optical flow motion estimation. This node is particularly useful for creating dynamic and glitch-like visual effects in digital art and animations. By manipulating pixel blocks based on their motion, it introduces a unique distortion that simulates gravitational pull, adding depth and movement to static images. The node's primary function is to process frames of an image, transforming them into a new form that reflects the specified gravity and motion parameters. This transformation can enhance the visual storytelling of your artwork by introducing an element of controlled chaos, making it an invaluable tool for artists looking to experiment with motion-based effects.

PixelFloat | GlitchNodes Input Parameters:

frames

This parameter represents the image frames that the node will process. It is the primary input and serves as the canvas upon which the gravity effects will be applied.

gravity_strength

This parameter controls the intensity of the gravity effect applied to the pixel blocks. A lower value results in a stronger gravitational pull, while a higher value reduces the effect. The default value is -10.0, with a range from -50.0 to 0.0, and it can be adjusted in steps of 0.5.

block_size

This parameter determines the size of the pixel blocks that will be affected by the gravity effect. Larger block sizes result in more pronounced and less detailed effects, while smaller block sizes offer finer detail. The default value is 4, with a range from 4 to 64, adjustable in steps of 4.

auto_block_size

This boolean parameter, when enabled, allows the node to automatically determine the optimal block size based on the input image characteristics. The default setting is False.

min_blocks

This parameter sets the minimum number of blocks that can be used in the effect. It ensures that the image maintains a certain level of detail. The default value is 32, with a range from 16 to 64, adjustable in steps of 4.

max_blocks

This parameter sets the maximum number of blocks that can be used, allowing for control over the complexity and processing load of the effect. The default value is 128, with a range from 64 to 256, adjustable in steps of 4.

flow_scale

This parameter adjusts the scale of the optical flow used in the motion estimation process. A higher flow scale results in more exaggerated motion effects. The default value is 0.25, with a range from 0.1 to 0.9, adjustable in steps of 0.05.

flow_levels

This parameter specifies the number of levels used in the optical flow pyramid. More levels can capture finer motion details but may increase processing time. The default value is 5, with a range from 1 to 8, adjustable in steps of 1.

flow_iterations

This parameter defines the number of iterations used in the optical flow calculation. More iterations can improve the accuracy of motion estimation. The default value is 3, with a range from 1 to 10, adjustable in steps of 1.

motion_threshold

This parameter sets the threshold for motion detection, determining which pixel blocks are affected by the gravity effect. A lower threshold means more blocks will be influenced. The default value is 0.5, with a range from 0.1 to 5.0, adjustable in steps of 0.1.

interpolation_factor

This parameter controls the interpolation between frames, affecting the smoothness of the transition between the original and processed frames. The default value is 0.5, with a range from 0.0 to 1.0, adjustable in steps of 0.1.

PixelFloat | GlitchNodes Output Parameters:

image

The output parameter is the processed image, which has undergone the gravity effect transformation. This image reflects the applied motion and gravity settings, resulting in a visually altered version of the input frames. The output is crucial for visualizing the impact of the node's processing and serves as the final product of the node's operation.

PixelFloat | GlitchNodes Usage Tips:

• Experiment with different gravity_strength values to achieve varying levels of distortion and motion effects in your images.
• Use auto_block_size to let the node automatically adjust block sizes for optimal results, especially when working with images of varying resolutions.
• Adjust flow_scale and flow_levels to fine-tune the motion detection and enhance the dynamic quality of the effect.

PixelFloat | GlitchNodes Common Errors and Solutions:

"Invalid block size"

• Explanation: The block size specified is outside the allowable range.
• Solution: Ensure that the block_size parameter is set within the range of 4 to 64.

"Flow scale out of range"

• Explanation: The flow scale value is not within the acceptable limits.
• Solution: Adjust the flow_scale parameter to be between 0.1 and 0.9.

"Motion threshold too high"

• Explanation: The motion threshold is set too high, resulting in minimal or no effect.
• Solution: Lower the motion_threshold to ensure more pixel blocks are affected by the gravity effect.