Creates an effect that animates Ball looking shapes.


Creates an effect that animates Ball looking shapes.

String Setup

  • Positioning - Determines how the target elements are treated. Either as individual strings or by their actual location in the display preview. Locations is often referred to as whole house, but it can be any form of multiple props. Generally you want Strings when applying to one prop and locations if the target is multiple props.

  • Orientation - Controls the orientation of the display area (matrix).


  • Type - Configures how balls behave when reaching the edge of the display element between Bounce or Wrap.

  • Fill - Selects the type of fill for the balls between Fade, Empty, Solid, Gradient, and Inverse.

  • Speed - Configures the speed of the moving balls.

  • Speed Variation - Randomly adjusts the speed of the moving balls around the Speed level by the amount of variation.

  • Size - Size of the balls.

  • Ball Count - Controls the number of balls displayed.

  • Random Time - Configures the maximum time used to detrmine when the ball direction changes. This setting only applies when Random Movement is selected.

  • Random Movement - Randomly changes the ball direction at random times.

  • Random Radius - Creates random size balls up to the Size value.

  • Collide - Change the ball direction when balls collide.

  • Collide Color - Change the ball color when balls collide.


  • Gradients - Controls the colors of the balls.


  • Intensity - This is an overall brightness intensity curve over the duration of the effect. This is a legacy parameter, consider using intensity overlay layers instead.


Last modified February 16, 2023: Update effect aliases (5d8efc0)