> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apexxcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overlays

# Image Overlay Transformations

Overlays allow you to add text or images on top of your base image. They're perfect for watermarks, branding, captions, and dynamic content composition.

## Types of Overlays

### Text Overlays

Add text to your images using the `l_text` parameter with various styling options:

```
tr-l_text:Hello World:l_font_Arial:l_size_24:l_color_ffffff
```

#### Text Parameters

* `l_font_{name}`: Font family (e.g., Arial, Helvetica)
* `l_size_{pixels}`: Font size in pixels
* `l_color_{hex}`: Text color in hex format
* `l_gravity_{position}`: Text placement (see Positioning section)
* `l_x_{pixels}`: X-axis offset from gravity position
* `l_y_{pixels}`: Y-axis offset from gravity position
* `l_o_{opacity}`: Text opacity (0-100)

### Image Overlays

Add images on top of your base image using the `l_image` parameter:

```
tr-l_image:logo@@brand@@watermark.png:l_gravity_southeast:l_o_50
```

> **Note**: Replace forward slashes (/) in image paths with `@@`
> Example: `assets/brand/logo.png` becomes `assets@@brand@@logo.png`

#### Image Overlay Parameters

* `l_gravity_{position}`: Overlay placement
* `l_x_{pixels}`: X-axis offset
* `l_y_{pixels}`: Y-axis offset
* `l_o_{opacity}`: Overlay opacity (0-100)
* `l_scale_{factor}`: Scale factor (e.g., 0.5 for half size)
* `l_width_{pixels}`: Specific width
* `l_height_{pixels}`: Specific height
* `l_ar_{ratio}`: Aspect ratio

## Positioning (Gravity)

Control overlay placement using the `l_gravity` parameter:

### Standard Positions

* `center` (default)
* `north`, `south`, `east`, `west`
* `north_east`, `north_west`, `south_east`, `south_west`

### Fine-tuning

Combine gravity with x/y offsets for precise positioning:

```
tr-l_text:Copyright:l_gravity_southeast:l_x_10:l_y_10
```