# Butterfly

![Icon](/files/-LbqAd3F6uaOwTFujE0B)

![Sequencer Grid](/files/-LZS5yLMm9d_DYh-Rumv)

![](/files/-LZSLMWSFaFk9DfrMvaG)

The Butterfly effect creates seemingly random patterns of color swirling around, based on an initial set of parameters. This is very effective on a number of different types of models.

| **Options/Settings** | **Description**                                                                                                                   |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| **Colors**           | Rainbow or Palette can be selected.  If Palette is selected, then the colors from the Color selection window are used**.**   |
| **Style**            | Up to 10 different styles can be selected for the effect.                                                                         |
| **Bkgrd Chunks**     | Controls whether and how sections of black color are to be used between the colors.  Can be adjusted via the Value Curves options |
| **Bkgrd Skip**       | Used in conjunction with the background chunks to skip the black background.  Can be adjusted via the Value Curves options.       |
| **Speed**            | Controls the speed with which the effects change.  Can be adjusted via the Value Curves options                                   |
| **Direction**        | Controls whether the effect moves outwards or reverses direction.                                                                 |

{% hint style="success" %}
Butterfly style #2 generates radial patterns that look great on round models such as snowflakes, stars, globes, etc.
{% endhint %}

{% hint style="success" %}
The effect can be repeated on the same model with different colors, directions or timings, using layers and offsetting the position on the model.
{% endhint %}


---

# 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/butterfly.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.