如何给图片添加文字水印并导出 PNG

先了解输入与输出

这款工具用于在已有图片上绘制文字水印，处理成功后会输出 PNG 图片数据。它适合为图片加入版权标识、来源说明、项目名称或简短提示，但处理对象是文字水印，而不是另一张水印图片。使用前需要准备目标图片的数据字符串；工具会先对该字符串进行 Base64 解码，再尝试打开图片并完成文字处理。

开始设置前，可以先确定水印内容、显示位置和视觉效果。例如，版权文字较长时，可先考虑缩短内容；来源说明通常适合放在角落，标题或提示语则可以根据图片构图选择位置。透明度和字体大小也应结合图片背景调整。未填写文字时，工具会使用默认文字，因此不要把空白文字输入理解为完全不显示水印。

给图片添加文字水印的步骤

1. 准备目标图片的 Base64 数据字符串，并将其填入图片数据输入位置。该输入不能为空；如果没有提供图片数据，处理不会继续。请确认传入的是代表图片的数据字符串，而不是仅有文件名或普通说明文字。
2. 填写水印文字。例如，可以输入版权标识、来源名称或项目说明。如果不填写，水印文字默认为“Watermark”。
3. 设置透明度。默认值为 0.5，应用前会将数值限制在 0.0 至 1.0 的范围内。数值较低时文字通常更淡，数值较高时文字通常更明显；实际观感仍取决于图片内容和渲染结果。
4. 选择位置。支持左上、右上、左下、右下和居中五种位置，默认位置为居中。如果传入其他位置值，工具会按居中位置处理。选择角落位置时，注意水印是否会与图片中的重要内容重叠。
5. 设置字体大小。未填写时使用 36。若图片尺寸或文字长度不同，可根据结果检查文字是否过小、过大或影响主体内容。
6. 提交处理并查看返回结果。处理成功时，得到的是经过文字水印处理的 PNG 图片数据。后续保存或传递时，应按照 PNG 图片数据来处理，并保留能够识别该数据的方式。

如何理解结果与失败情况

成功返回后，先确认结果确实包含所填写的文字水印，再检查水印的位置、透明度和字体大小是否符合预期。位置应与所选选项对应；如果填写了不受支持的位置值，应按居中结果理解。输出是 PNG 图片数据，所以不能据此判断它会保留输入图片原本的文件格式。

没有得到成功结果时，先检查图片数据字符串是否为空，以及它能否被正确解码并打开。即使输入不为空，处理仍可能在图片处理依赖不可用，或在解码、打开、绘制、合成、编码环节发生异常时失败。声明的网络访问设置为关闭，但这一设置不能说明具体部署环境，也不能据此推断图片是否会被存储、保留或删除。

使用示例

你要为一张项目资料图添加来源标识，并希望标识显示在图片右下角。

准备一张需要标注来源的图片，将其编码为 Base64 图片数据字符串，填写“项目资料”作为水印文字，选择右下位置并提交处理。

成功结果为一份经过文字水印处理的 PNG 图片数据，其中包含指定文字，并按所选位置呈现。

使用限制

• 处理可能因图片处理依赖不可用，或解码、打开、绘制、合成、编码过程中出现异常而失败；声明的网络访问设置为关闭本身不代表具体部署、存储或隐私属性。

常见错误

• 错误原因：图片数据输入为空，处理不会继续。纠正方法：先提供非空且代表图片的 Base64 数据字符串，再提交处理。

常见问题

可以调整文字水印的透明度吗？

可以。透明度默认是 0.5，应用前会将数值限制在 0.0 至 1.0 的范围内。

文字水印可以放在哪些位置？

可以。支持左上、右上、左下、右下和居中；未指定时默认居中，其他位置值也会按居中处理。

处理成功后会输出什么格式？

处理成功时，输出是 PNG 图片数据；如果图片处理依赖不可用，或解码、打开、绘制、合成、编码环节发生异常，处理可能失败。