java awt 添加文字水印必须使用graphics2d并配置抗锯齿与透明色,确保目标图类型为type_int_argb,正确计算drawstring坐标(y=基线,需用getascent()校正),水印图应缓存而非每次重绘重建。

Java AWT 绘图添加文字水印时,Graphics2D 必须开启抗锯齿和设置透明度
直接用 Graphics 画文字,水印要么发虚、要么完全不透明盖住原图——这是因为默认的绘图上下文没启用渲染提示,且 setColor() 不支持 alpha 通道。必须升级到 Graphics2D 并手动配置。
- 先调用
createGraphics()得到Graphics2D实例,别直接用getGraphics() - 立刻设置
g2.setRenderingHint(RenderingHints.KEY_TEXT_ANTIALIASING, RenderingHints.VALUE_TEXT_ANTIALIAS_ON) - 用
g2.setColor(new Color(r, g, b, alpha))(注意第四个参数是透明度,0–255),不能用setComposite()后再填纯色——那会把整块区域变半透,不是文字本身带透明 - 字体大小建议 ≥16,小字号在缩放或低DPI图上极易糊成一团灰
用 BufferedImage 加载图片后,TYPE_INT_ARGB 类型是加水印的前提
如果原始图是 JPEG(TYPE_INT_RGB),直接在上面 drawString,透明色会被强制转成黑色或白色,水印“消失”其实是被填实了。必须确保目标图像支持 alpha 通道。
- 加载后检查类型:
img.getType() == BufferedImage.TYPE_INT_ARGB,否则用new BufferedImage(w, h, BufferedImage.TYPE_INT_ARGB)创建新画布 - 用
g2.drawImage(srcImg, 0, 0, null)把原图完整拷贝过去,别漏这步——否则只画了水印,原图没了 - Swing 的
JLabel.setIcon()显示时若看到黑底,大概率是类型没转对,不是代码逻辑错
drawString() 坐标算不准?记住 y 是基线位置,不是顶部
写 g2.drawString("©2024", 10, 10),文字几乎全在画布外——因为 y=10 指的是文字“基线”纵坐标,而大写字母顶部(ascent)通常在基线上方 10–15 像素。肉眼看到的“贴顶”其实是文字被截了一半。
- 用
FontMetrics fm = g2.getFontMetrics()获取当前字体度量 - 真正让文字顶部离画布顶边 10 像素:y =
10 + fm.getAscent() - 想居中水印?x =
(width - fm.stringWidth(text)) / 2,但 y 要用height/2 + fm.getAscent()/2,不是简单除以 2 - 旋转水印时,
g2.rotate()会影响后续所有绘制,记得g2.dispose()前用g2.rotate(-angle)回正,或用g2.transform(AffineTransform.getRotateInstance(...))配合g2.setTransform(oldTx)
Swing 界面里实时预览水印,别在 paintComponent() 里反复创建 BufferedImage
每次重绘都 new 一张图、draw 一遍,UI 会卡顿,内存飙升。Swing 的绘制是高频触发的,不是“点一下才画一次”。
立即学习“Java免费学习笔记(深入)”;
- 水印图应作为类字段缓存:
private BufferedImage watermarkedImage; - 只在用户改文字/位置/透明度后,调用一次生成逻辑,然后
repaint() - 在
paintComponent()里只做g.drawImage(watermarkedImage, 0, 0, this)—— 这才是轻量级绘制 - 如果水印要随窗口缩放,别在 paintComponent 里 resize 图像,而是监听
ComponentListener.componentResized(),按需重建缓存图
实际最麻烦的从来不是“怎么画”,而是“什么时候画、画在哪张图上、这张图有没有 alpha、坐标系到底怎么算”。尤其当水印要叠加在用户上传的任意格式图片上时,BufferedImage 类型转换和 Graphics2D 的状态管理,比画几行字花的时间多得多。











