# Fill

![Icon](/files/-LaVk2gxfrv9JiBYewxn)

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

![](/files/-LZSCn4Xw5qB6etXrexR)

The Fill effect starts from the left, right, bottom or top edge (position) and does a complete fill to the position value.

The position has a Value Curve so you can make it do precise dynamic positioning during the duration of the effect. Select multiple colors to fade (equally) between those colors for the duration of the effect.

| Option/Settings                | Description                                                                                                                 |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
| **Position value**             | <p>Fill Height, 0 - 100%.</p><p>Can be adjusted via the Value Curves options.</p>                                           |
| **Band Size**                  | Controls the proportion ( % wise) of the total length of the effect that the pixels will light up.                          |
| **Skip Size**                  | Controls the proportion (% wise) of the total length of the effect that will be skipped by the pixel color ie will be dark. |
| **Offset**                     | Adjusts as a %, the center point of the offset for the fill effect.                                                         |
| **Offset in Pixels**           | Used to specify exact number of pixels rather than % for offset.                                                            |
| **Change Color based on Time** | Fade Color Pallet selections over time.                                                                                     |
| **Direction**                  | Determines the direction that the effect starts and ends.                                                                   |
| **Up**                         | Starts at bottom and moves up.                                                                                              |
| **Down**                       | Starts at top and moves down.                                                                                               |
| **Left**                       | Starts at right and moves left.                                                                                             |
| **Right**                      | Starts at left and moves right.                                                                                             |


---

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