> For the complete documentation index, see [llms.txt](https://manual.xlights.org/xlights/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manual.xlights.org/xlights/effects/off/ripple.md).

# Ripple

![Icon](https://1941201815-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ2Jwp7mRP9HqIZtQ_h%2Fuploads%2Fgit-blob-43c36a63f438c520ba2675f6daf11836b0be1735%2Fimage.png?alt=media)

![Sequencer Grid](https://1941201815-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ2Jwp7mRP9HqIZtQ_h%2Fuploads%2Fgit-blob-932cf914ba1501d5cd438dfe90e3b69977d23899%2Fimage.png?alt=media)

![](https://1941201815-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ2Jwp7mRP9HqIZtQ_h%2Fuploads%2Fgit-blob-3649cd95d77d3e92c21d148147bbb375fac70b61%2Fimage%20\(772\).png?alt=media)

The Ripple effect generates a ripple like spreading movement of color similar to when an object is dropped into water. One or multiple colors can be used for the effect.

| Option/Settings    | Description                                                                                                                                                                                                                                        |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Object to Draw** | Defines the shape of the object that will ripple. The Circle is the default and the most commonly selected value. A Square, Triangle, Star, Polygon, Heart, Tree, Candy Cane, Snow Flake, Crucifix(Cross), and Present shape can also be selected. |
| **Movement**       | Defines the direction of the ripple i.e. Explode (Outwards) and Implode (Inwards).                                                                                                                                                                 |
| **Thickness**      | <p>Controls the thickness of each line of the ripple.</p><p>Can be adjusted via the Value Curves options.</p>                                                                                                                                      |
| **Cycle Count**    | Defines the number of cycles that the shape should explode/implode within the given time frame of the effect. Can be adjusted via the Value Curves options.                                                                                        |
| **Points**         | Number of Points/Sides of the Shape, Only available on Star, Snow Flake, and Polygon.                                                                                                                                                              |
| **Rotation**       | Rotation of the shape.                                                                                                                                                                                                                             |
| **3D**             | Indicates whether the ripple effect should render as is a 3D or 2D effect.                                                                                                                                                                         |