Image Extend
Extends an image canvas by adding padding on all sides with a solid background color.
Command
npx agent-media@latest image extend --in <path> --padding <pixels> --color <hex> [options]
Inputs
| Option | Required | Description |
|--------|----------|-------------|
| --in | Yes | Input file path or URL |
| --padding | Yes | Padding size in pixels to add on all sides |
| --color | Yes | Background color for extended area (hex, e.g., "#FFFFFF"). Also flattens transparency. |
| --dpi | No | DPI/density for output image (default: 300) |
| --out | No | Output path, filename or directory (default: ./) |
Output
Returns a JSON object with the extended image path:
{
"ok": true,
"media_type": "image",
"action": "extend",
"provider": "local",
"output_path": "extended_123_abc.png",
"mime": "image/png",
"bytes": 234567
}
Examples
Add white padding around an image:
npx agent-media@latest image extend --in photo.jpg --padding 50 --color "#FFFFFF"
Add colored border:
npx agent-media@latest image extend --in artwork.png --padding 100 --color "#E4ECF8"
Extend with custom DPI:
npx agent-media@latest image extend --in print-ready.jpg --padding 75 --color "#000000" --dpi 600
Providers
This action uses local processing only:
- local - No API key required (uses Sharp)