Back to Details

image-extend

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Image Extend

图像扩展

Extends an image canvas by adding padding on all sides with a solid background color.
通过在所有侧边添加纯色背景的内边距来扩展图像画布。

Command

命令

bash
agent-media image extend --in <path> --padding <pixels> --color <hex> [options]
bash
agent-media image extend --in <path> --padding <pixels> --color <hex> [options]

Inputs

输入参数

OptionRequiredDescription
--in
YesInput file path or URL
--padding
YesPadding size in pixels to add on all sides
--color
YesBackground color for extended area (hex, e.g., "#FFFFFF"). Also flattens transparency.
--dpi
NoDPI/density for output image (default: 300)
--out
NoOutput path, filename or directory (default: ./)
选项是否必填描述
--in
是输入文件路径或URL
--padding
是要在所有侧边添加的内边距大小（单位：像素）
--color
是扩展区域的背景颜色（十六进制格式，例如"#FFFFFF"），同时会消除透明度。
--dpi
否输出图像的DPI/密度（默认值：300）
--out
否输出路径、文件名或目录（默认值：./）

Output

输出

Returns a JSON object with the extended image path:
json
{
  "ok": true,
  "media_type": "image",
  "action": "extend",
  "provider": "local",
  "output_path": "extended_123_abc.png",
  "mime": "image/png",
  "bytes": 234567
}
返回包含扩展后图像路径的JSON对象：
json
{
  "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:
bash
agent-media image extend --in photo.jpg --padding 50 --color "#FFFFFF"
Add colored border:
bash
agent-media image extend --in artwork.png --padding 100 --color "#E4ECF8"
Extend with custom DPI:
bash
agent-media image extend --in print-ready.jpg --padding 75 --color "#000000" --dpi 600
为图像添加白色内边距：
bash
agent-media image extend --in photo.jpg --padding 50 --color "#FFFFFF"
添加彩色边框：
bash
agent-media image extend --in artwork.png --padding 100 --color "#E4ECF8"
使用自定义DPI扩展图像：
bash
agent-media 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)
该操作仅使用本地处理：
  • local - 无需API密钥（使用Sharp库）