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

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

The effect panel groups its settings into Shape, Size, Motion, and Triggers tabs to make the large number of options easier to navigate.

| 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.                                                                                                        |
