# Warp

![Icon](/files/-LaX4X3OBdiuJzLj3t9s)

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

![](/files/-LebjI7sGgMYmTHYN6RV)

The Warp Effect is a canvas mode effect. By itself it does nothing. The warp effect distorts the pixels in the layers below it. The Canvas option in Layer Blending must be enabled for it to work.

| Option/Settings | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Warp Type**   | <p>Defines the type of Warp to use.</p><p>"water drops" Adds ripples simulation a stone falling in a lake.</p><p>"dissolve" pieces of the underlying effect disappear and reappear over time.</p><p>"circle reveal" underlying effect fades in/out with a circular pattern.</p><p>"banded swirl" mix the underlying effect, like mixing colors in water.</p><p>"ripple" bounce the underlying effect up and down like it was laying on a trampoline.</p><p>"single water drop" Adds ripple simulation a single water drop.</p><p>"circular swirl" mix the underlying effect, with a circular pattern.</p><p>"drop" underlying effect 'melts' downward.</p><p>"wavy" Move the underlying effect to simulate a flag waving in the wind.</p><p>"sample on" Sample one pixel from the underlying effect. The X,Y slider control the X,Y location of the pixel to sample.</p> |
| **Treatment**   | <p>"Constant" repeat the effect over and over.</p><p>"In" Preform the effect once with the "In" direction.</p><p>"Out" Preform the effect once with the "Out" direction.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| **X**           | X screen location of the effect.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| **Y**           | Y screen location of the effect.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| **Cycle Count** | If "Constant" treatment is enabled, this specified the number of times the effect repeats.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **Speed**       | Adjust the speed of the effect                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| **Frequency**   | Adjusts the rate the "ripple" and "banded swirl" manipulate the effect.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |

{% hint style="danger" %}
This Effect using a lot of CPU resources. If it is placed on large model groups, like whole house model groups, it **WILL** increase render times significantly.
{% 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/warp.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.