​

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