如何为图片添加自定义颜色和宽度的边框

先了解工具能做什么

这款工具用于给图片数据增加可自定义的彩色边框或相框。它适合需要统一画布边缘、突出图片主体，或为图片增加简单装饰的场景。输入不是普通文件名，而是图片数据的 Base64 编码字符串，因此使用前需要先准备好可编码的图片内容。

操作步骤：为图片添加边框

1. 准备一张图片，并将其转换为 Base64 编码的输入字符串。不要留空；虽然输入项在声明中可选，但空值会导致处理失败。
2. 设置边框宽度。未特别指定时，宽度为 10；也可以传入所需数值，工具会按提供的宽度执行边框操作。
3. 设置边框颜色。默认颜色是 #000000。颜色值会先去掉开头的 #，再将六位十六进制字符按红、绿、蓝三个分量解析，因此可使用类似 #3366CC 的六位颜色表示。
4. 提交图片数据、宽度和颜色，等待处理结果。若图片数据无法解码、颜色值无效，或处理过程发生其他异常，结果可能不成功。
5. 检查返回内容。成功时，保存返回的 Base64 图片文本，并同时查看原始尺寸和处理后尺寸。

如何查看和理解结果

成功结果的核心是处理后的图片 Base64 文本，以及原始图片和结果图片的尺寸信息。图片格式在有原始格式可用时会保持原格式；没有可用的原始格式时，结果会保存为 PNG。边框颜色并不是文字名称，而是按六位十六进制颜色值解析；宽度也应结合实际画布和视觉效果检查。若返回失败，不应把失败结果当作可下载图片，而应先检查输入是否为空、是否为可解码的图片数据，以及颜色和宽度设置是否符合要求。

使用示例

你想给一张照片增加黑色边框，因此使用照片的 Base64 编码内容，并采用默认宽度和默认颜色进行处理。

准备一张照片的 Base64 编码字符串，将边框宽度设为 10、颜色设为 #000000，提交处理并检查返回的图片文本和尺寸字段。

成功结果包含带边框图片的 Base64 文本、原始尺寸和处理后尺寸；有可用原始格式时保持原格式，否则为 PNG。

使用限制

• 处理并不保证适用于任意输入：空值、无法解码的图片、无效颜色值或其他处理异常都可能导致失败。

常见错误

• 如果输入字符串为空或不是可解码的图片数据，处理会失败。请先确认输入确实包含图片的 Base64 编码内容，再重新提交。

常见问题

需要什么格式的输入？

输入必须是图片数据的 Base64 编码字符串，不能留空；空值会导致处理失败。

默认边框宽度和颜色是什么？

未设置时，边框宽度为 10，颜色为 #000000。需要其他效果时，可以分别提供宽度和六位十六进制颜色值。

处理成功后会得到什么？

成功时会返回带边框图片的 Base64 文本，并包含原始尺寸和结果尺寸；有原始格式时保持该格式，否则保存为 PNG。