# Shape

![Icon](/files/-Ld4dlxnRSZTc2QbmykY)

![Sequencer Grid](/files/-LZS6SWN9A-N0NNQBPg_)

![](/files/-Lp_06Re1VaX2v_59zvm)

The shape effect displays different geometric shapes. They are predefined sharps or System Font can be used.

| Option/Settings                | Description                                                                                                                                 |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **Object to Draw**             | Defines what shape to draw. Options: Circle, Square, Triangle, Star, Polygon, Heart, Tree, Candy Cane, Snow Flake, Crucifix, Present, Emoji |
| **Character**                  | Select Emoji/System Font to use.                                                                                                            |
| **Thickness**                  | Shape wall thickness.                                                                                                                       |
| **Count**                      | Number of shapes drawn at a time.                                                                                                           |
| **Start Size**                 | Shape start size.                                                                                                                           |
| **Random initial shape sizes** | Randomize starting shape size.                                                                                                              |
| **Velocity**                   | Speed the shape moves across the buffer.                                                                                                    |
| **Direction**                  | Direction the shape moves across the buffer. 0 is right movement, 90 is up movement, 180 is left movement, 270 is down movement.            |
| **Lifetime**                   | Length of time the shape last for.                                                                                                          |
| **Growth**                     | Increase/Decrease of the shapes size over time.                                                                                             |
| **X Center**                   | Starting X location of the shapes center.                                                                                                   |
| **Y Center**                   | Starting Y location of the shapes center.                                                                                                   |
| **Points**                     | Rotation/sides of the shape, If supported.                                                                                                  |
| **Rotation**                   | Rotation of the shape, If supported.                                                                                                        |
| **Random Location**            | Use random start location for the shape.                                                                                                    |
| **Random movement**            | Use random movement for for the shape.                                                                                                      |
| **Fade Away**                  | Fade shape over its lifetime.                                                                                                               |
| **Hold Color**                 | Hold shape color over its lifetime.                                                                                                         |
| **Fire with music**            | Display shapes based on the music intensity.                                                                                                |
| **Trigger level**              | Music intensity level to trigger from.                                                                                                      |
| **Fire with timing track**     | Display shapes based on a timing track.                                                                                                     |
| **Timing Track**               | Timing track to trigger shapes from.                                                                                                        |


---

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