> 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/butterfly.md).

# Butterfly

![Icon](https://1941201815-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ2Jwp7mRP9HqIZtQ_h%2Fuploads%2Fgit-blob-a839dbbd391d88236a714d0bd50b8d9a87c10ca4%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-92b022e86b4f1b81552a7f7163b0deae437f018a%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-d63153880dbd3ae6ea92f1224feb02e774b54481%2Fimage.png?alt=media)

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 %}