ComfyUI Node: Gravity Well | RyanOnTheInside

Gravity Well | RyanOnTheInside:

The GravityWell node is designed to simulate gravitational forces within a particle system, allowing you to create dynamic and visually compelling effects by attracting or repelling particles. This node is particularly useful for AI artists looking to add realistic physical interactions to their particle-based artworks. By configuring various parameters, you can control the position, strength, radius, and type of gravitational forces, as well as their visual representation. The GravityWell node enhances the realism and complexity of particle systems, making it an essential tool for creating intricate and engaging visual effects.

Gravity Well | RyanOnTheInside Input Parameters:

x

This parameter sets the horizontal position of the gravity well within the particle system, expressed as a float between 0.0 and 1.0. The default value is 0.5. Adjusting this value will move the gravity well left or right within the canvas, influencing where the gravitational force is applied.

y

This parameter sets the vertical position of the gravity well within the particle system, expressed as a float between 0.0 and 1.0. The default value is 0.5. Adjusting this value will move the gravity well up or down within the canvas, determining the vertical point of force application.

strength

This parameter controls the intensity of the gravitational force exerted by the well, with a float value ranging from 0.0 to 5000.0. The default value is 500.0. Higher values will result in stronger attraction or repulsion forces, significantly affecting particle movement within the well's radius.

radius

This parameter defines the effective range of the gravity well, within which particles will be influenced by its force. It is expressed as a float between 10.0 and 500.0, with a default value of 100.0. Increasing the radius will expand the area affected by the gravitational force.

type

This parameter specifies the nature of the gravitational force, with options "attract" or "repel". Choosing "attract" will pull particles towards the well, while "repel" will push them away. This setting is crucial for determining the overall behavior of particles in relation to the gravity well.

color

This parameter sets the color of the gravity well's visual representation, defined as a string in the format "(R,G,B)". The default value is "(255,127,0)". This color will be used when drawing the well on the canvas, helping to visually distinguish different wells.

draw

This parameter controls the visibility of the gravity well's representation on the canvas, expressed as a float between 0.0 and 1.0. The default value is 0.0. Setting this value higher will make the well more visible, aiding in the visualization of its position and radius.

previous_well

This optional parameter allows you to chain multiple gravity wells together. It accepts a list of previously defined gravity wells, enabling the creation of complex gravitational fields with multiple points of influence.

Gravity Well | RyanOnTheInside Output Parameters:

GRAVITY_WELL

The output is a list of gravity wells, each defined by their position, strength, radius, type, color, and draw settings. This list can be used to apply multiple gravitational forces within a particle system, allowing for intricate and dynamic interactions between particles and wells.

Gravity Well | RyanOnTheInside Usage Tips:

• Experiment with different strength and radius values to achieve the desired effect on particle movement. Stronger forces and larger radii can create more dramatic interactions.
• Use the type parameter to combine both attractive and repulsive wells in your particle system, adding complexity and visual interest to your artwork.
• Adjust the draw parameter to visualize the gravity wells during the design process, making it easier to fine-tune their positions and effects.

Gravity Well | RyanOnTheInside Common Errors and Solutions:

"Invalid value for parameter 'x'"

• Explanation: The value provided for the x parameter is outside the allowed range (0.0 to 1.0).
• Solution: Ensure that the x value is a float between 0.0 and 1.0.

"Invalid value for parameter 'y'"

• Explanation: The value provided for the y parameter is outside the allowed range (0.0 to 1.0).
• Solution: Ensure that the y value is a float between 0.0 and 1.0.

"Invalid value for parameter 'strength'"

• Explanation: The value provided for the strength parameter is outside the allowed range (0.0 to 5000.0).
• Solution: Ensure that the strength value is a float between 0.0 and 5000.0.

"Invalid value for parameter 'radius'"

• Explanation: The value provided for the radius parameter is outside the allowed range (10.0 to 500.0).
• Solution: Ensure that the radius value is a float between 10.0 and 500.0.

"Invalid value for parameter 'type'"

• Explanation: The value provided for the type parameter is not one of the allowed options ("attract" or "repel").
• Solution: Ensure that the type value is either "attract" or "repel".

"Invalid value for parameter 'color'"

• Explanation: The value provided for the color parameter is not in the correct format.
• Solution: Ensure that the color value is a string in the format "(R,G,B)".