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

# Curtain

![Icon](/files/-M06aBGBUAvb2adWvNIJ)

![Sequencer Grid](/files/-LaLzTj_-scb-qluHlmN)

![](/files/-Lac2KdJjHAL4DOk9rej)

The Curtain effect creates a color transition of one or more colors across the face of a model depicting a curtain opening or closing based on the options selected.

Used most effectively on models such as a mega tree, a matrix, whole house or grouped arches. Can also be used on singular items such as each arch.

| **Option/Settings** | Description                                                                                                                                                                                                                                                                                                                                                                                  |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Curtain edge**    | <p>Denotes how the curtain edge will come together (i.e. close) or open – depending on the ‘Effect’ setting value.</p><p>Examples:</p><p>Center – Two curtains will move from the outside to the inside (center) of the model or from the inside (center) to the outside of the model.</p><p>Bottom – The curtain sweep will be from the top, closing or opening out towards the bottom.</p> |
| **Effect**          | Denotes whether the curtain should open, close, open then close or close then open. Used in conjunction with the curtain edge direction.                                                                                                                                                                                                                                                     |
| **Swag Width**      | <p>Defines the curve of the curtain effect. A value of zero will depict a straight curtain edge. A value of 10 will depict a curved curtain edge with a sweeping drop.</p><p>Can be adjusted via the Value Curves options.</p>                                                                                                                                                               |
| **Swag Speed**      | <p>Defines the speed at which the curtains will close or open.</p><p>Can be adjusted via the Value Curves options.</p>                                                                                                                                                                                                                                                                       |
| **Repeat**          | If true, the the action will repeat multiple times. If false, it only happens once.                                                                                                                                                                                                                                                                                                          |

{% hint style="success" %}
You can use the curtain effect layered with any other effect as a mask to reveal the other effect.
{% endhint %}
