# Liquid

## Liquid

![Icon](/files/-M06_xlL8orweY5sC1md)

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

![](/files/-LpcWMC74gLAVwj4874v)

The Liquid effect is based on a liquid particle simulation algorithm. Up to four liquid particle sources can be enabled. Based on Google's LiquidFun fluid simulation. <http://google.github.io/liquidfun/>

| Option/Settings                                                                  | Description                                                                               |
| -------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| <p><strong>Top, Bottom,</strong></p><p><strong>Left, Right Barriers</strong></p> | Prevent Liquid particles from leaving the Checked Values side of the effect.              |
| **Hold Particle Colors**                                                         | Keep each particle color constant over time.                                              |
| **Mix Colors**                                                                   | Change particle color over time.                                                          |
| **Type**                                                                         | Select the liquid type.                                                                   |
| **Lifetime**                                                                     | Lifetime of a particle before it disappears.                                              |
| **Size**                                                                         | Size of particles.                                                                        |
| **Warm Up Frames**                                                               | Throw away start up frames that don't appear to adjust the effect desired starting state. |
| **Despeckle Threshold**                                                          | Spacing of the particles.                                                                 |
| **Gravity**                                                                      | Pull Factor away from the liquid source.                                                  |
| **X**                                                                            | X location of the liquid source.                                                          |
| **Y**                                                                            | Y location of the liquid source.                                                          |
| **Direction**                                                                    | Rotation of the liquid source.                                                            |
| **Velocity**                                                                     | Rate of movement of the particles.                                                        |
| **Flow**                                                                         | Number of particles dispensed at a time.                                                  |
| **Source Size**                                                                  | Size of the liquid source that particles will appear 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/liquid.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.