# Ripple

![Icon](/files/-LaXs4cDuvLaXcqJfOqe)

![Sequencer Grid](/files/-LpQpNEy8iADP1ASzZQD)

![](/files/-M06aBEkoKI_pwr1cbUD)

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.                                                                                                                                                                         |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://manual.xlights.org/xlights/effects/off/ripple.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
