> For the complete documentation index, see [llms.txt](https://animoia.gitbook.io/animoia-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://animoia.gitbook.io/animoia-docs/effects-reference/lighting.md).

# Lighting

Adds light, glow, and shading. Every effect below is listed in the sidebar, so you can jump straight to one. Return to [Effects reference](/animoia-docs/effects-reference.md) for stack behavior shared by all effects.

## Drop Shadow

Adds dimensional light or shadow with drop shadow. Add it from **Effects > Lighting** by double-clicking it or dragging it onto a compatible layer.

**Properties**

| Name         | Control | Visual or audible result                                                          |
| ------------ | ------- | --------------------------------------------------------------------------------- |
| Shadow Color | Color   | Sets the color used for the shadow portion of the result.                         |
| Opacity      | Number  | Changes how strongly the effect is visible without changing its shape.            |
| Direction    | Number  | Chooses the direction in which the effect travels, stretches, or faces.           |
| Distance     | Number  | Sets how far drop shadow extends away from its source.                            |
| Softness     | Number  | Softens hard boundaries and creates a more gradual transition.                    |
| Blend Mode   | Menu    | Changes how the effect’s colors and brightness combine with the image beneath it. |
| Shadow Only  | Toggle  | Changes the shadow only contribution in the darker areas of the image.            |

## Inner Shadow

Adds dimensional light or shadow with inner shadow. Add it from **Effects > Lighting** by double-clicking it or dragging it onto a compatible layer.

**Properties**

| Name         | Control | Visual or audible result                                                          |
| ------------ | ------- | --------------------------------------------------------------------------------- |
| Shadow Color | Color   | Sets the color used for the shadow portion of the result.                         |
| Opacity      | Number  | Changes how strongly the effect is visible without changing its shape.            |
| Direction    | Number  | Chooses the direction in which the effect travels, stretches, or faces.           |
| Distance     | Number  | Sets how far inner shadow extends away from its source.                           |
| Softness     | Number  | Softens hard boundaries and creates a more gradual transition.                    |
| Blend Mode   | Menu    | Changes how the effect’s colors and brightness combine with the image beneath it. |
| Shadow Only  | Toggle  | Changes the shadow only contribution in the darker areas of the image.            |

## Long Shadow

Adds dimensional light or shadow with long shadow. Add it from **Effects > Lighting** by double-clicking it or dragging it onto a compatible layer.

**Properties**

| Name         | Control | Visual or audible result                                                          |
| ------------ | ------- | --------------------------------------------------------------------------------- |
| Shadow Color | Color   | Sets the color used for the shadow portion of the result.                         |
| Opacity      | Number  | Changes how strongly the effect is visible without changing its shape.            |
| Direction    | Number  | Chooses the direction in which the effect travels, stretches, or faces.           |
| Length       | Number  | Sets how far long shadow extends away from its source.                            |
| Fade Out     | Toggle  | Sets how gradually the result weakens as it moves away from its strongest point.  |
| Blend Mode   | Menu    | Changes how the effect’s colors and brightness combine with the image beneath it. |
| Shadow Only  | Toggle  | Changes the shadow only contribution in the darker areas of the image.            |

## Ray Burst

Adds dimensional light or shadow with ray burst. Add it from **Effects > Lighting** by double-clicking it or dragging it onto a compatible layer.

**Properties**

| Name              | Control    | Visual or audible result                                                                           |
| ----------------- | ---------- | -------------------------------------------------------------------------------------------------- |
| Intensity         | Number     | Changes how pronounced the light, color, texture, or distortion appears.                           |
| Center            | 2D control | Moves the visual center or origin of the effect across the layer.                                  |
| Radius            | Number     | Changes how far the effect spreads outward from each affected pixel or point.                      |
| Warp Softness     | Number     | Softens the rays as they bend away from the light, blurring their edges into the surrounding glow. |
| Shape             | Menu       | Chooses the visual form ray burst takes.                                                           |
| Direction         | Number     | Chooses the direction in which the effect travels, stretches, or faces.                            |
| Color from Source | Toggle     | Turns color from source on or off.                                                                 |
| Allow Brightening | Toggle     | Turns allow brightening on or off.                                                                 |
| Color             | Color      | Sets the principal color used by the effect.                                                       |
| Transfer Mode     | Menu       | Chooses how the horizontal and vertical blur passes are combined back with the original image.     |

## Shine

Adds dimensional light or shadow with shine. Add it from **Effects > Lighting** by double-clicking it or dragging it onto a compatible layer.

**Properties**

| Name            | Control    | Visual or audible result                                                                        |
| --------------- | ---------- | ----------------------------------------------------------------------------------------------- |
| Center          | 2D control | Moves the visual center or origin of the effect across the layer.                               |
| Direction       | Number     | Chooses the direction in which the effect travels, stretches, or faces.                         |
| Shape           | Menu       | Chooses the visual form shine takes.                                                            |
| Width           | Number     | Changes the horizontal size or thickness of the result.                                         |
| Sweep Intensity | Number     | Sets how bright the moving band of light is.                                                    |
| Edge Intensity  | Number     | Sets how strongly the sweep flares where it crosses the edges of the artwork.                   |
| Edge Thickness  | Number     | Sets how wide that flare along the edges spreads.                                               |
| Light Color     | Color      | Sets the color used for the light portion of the result.                                        |
| Light Reception | Menu       | Chooses how the sweep interacts with the layer: added on top, cut into it, or used to light it. |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://animoia.gitbook.io/animoia-docs/effects-reference/lighting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
