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

# Image Operations

> Image processing — resize, crop, convert, watermark

## image\_resize

Resize an image to specific dimensions.

```json theme={null}
{ "type": "image_resize", "params": { "width": 800, "height": 600, "fit": "cover" } }
```

| Param  | Type    | Description                                        |
| ------ | ------- | -------------------------------------------------- |
| width  | integer | Target width in pixels                             |
| height | integer | Target height in pixels                            |
| fit    | string  | Resize mode: cover, contain, fill, inside, outside |

## image\_crop

Crop an image to a specific region.

```json theme={null}
{ "type": "image_crop", "params": { "left": 100, "top": 50, "width": 500, "height": 400 } }
```

## image\_convert

Convert image to a different format.

```json theme={null}
{ "type": "image_convert", "params": { "format": "webp", "quality": 85 } }
```

Supported formats: jpeg, png, webp, avif, heic, tiff, gif

## image\_watermark\_text

Add text watermark to an image.

```json theme={null}
{ "type": "image_watermark-text", "params": { "text": "© 2026", "position": "bottom-right", "opacity": 0.5 } }
```

## image\_watermark\_image

Overlay a watermark image on another image.

```json theme={null}
{ "type": "image_watermark-image", "params": { "watermark_url": "https://example.com/logo.png", "position": "center", "opacity": 0.3 } }
```

## image\_blur

Apply blur effect to an image.

```json theme={null}
{ "type": "image_blur", "params": { "sigma": 5.0 } }
```

## image\_sharpen

Sharpen an image.

```json theme={null}
{ "type": "image_sharpen", "params": { "sigma": 1.5 } }
```

## image\_rotate

Rotate an image by degrees.

```json theme={null}
{ "type": "image_rotate", "params": { "angle": 45, "background": "#ffffff" } }
```

## image\_composite

Compose multiple images together.

```json theme={null}
{ "type": "image_composite", "params": { "overlay_url": "https://example.com/overlay.png", "x": 10, "y": 10 } }
```

## image\_animated

Create animated WebP or GIF from multiple images.

```json theme={null}
{
  "input": ["https://example.com/frame1.png", "https://example.com/frame2.png"],
  "operations": [{ "type": "image_animated", "params": { "format": "webp", "delay": 100 } }]
}
```

## image\_metadata

Read image metadata (dimensions, format, color space, EXIF).

```json theme={null}
{ "type": "image_metadata" }
```

## svg\_to\_raster

Convert SVG to a raster image (PNG, JPEG, WebP).

```json theme={null}
{ "type": "image_svg-to-raster", "params": { "format": "png", "width": 1024 } }
```

## pdf\_to\_image

Convert PDF pages to images.

```json theme={null}
{ "type": "image_pdf-to-image", "params": { "format": "png", "dpi": 300, "page": 1 } }
```

## deep\_zoom

Generate Deep Zoom (DZI) tiled image pyramid for zoomable viewers.

```json theme={null}
{ "type": "image_deep-zoom", "params": { "tile_size": 256 } }
```

## icc\_convert

Convert image color profile (e.g., CMYK to sRGB).

```json theme={null}
{ "type": "image_icc-convert", "params": { "profile": "srgb" } }
```
