如何使用github.com/fogleman/gg为任意图片添加带黑色阴影的白色文字？

我目前使用github.com/fogleman/gg库在图片上绘制白色文字，代码如下：

existing, _ := gg.LoadJPG(path)
dc := gg.NewContextForImage(existing)
dc.SetRGB(0, 0, 0)
dc.DrawString(word, x, y)
dc.SetRGB(1, 1, 1)
dc.DrawString(word, x-3, y-3)

这种方式有时显示效果良好：

但有时效果很差：

请问是否有技巧能让文字在任意图片上都清晰可读？

以下几种实用技巧可确保文字在任意图片背景上清晰可读：

1. 描边+填充（通用可靠方案） #

放弃偏移阴影的方式，改为给文字添加粗描边后填充主体。这种方法能让文字在复杂背景下始终保持清晰的边缘对比。

示例代码：

existing, err := gg.LoadJPG(path)
if err != nil {
    // 处理错误逻辑
}
dc := gg.NewContextForImage(existing)

// 加载粗体字体增强可读性（替换为实际字体路径）
if err := dc.LoadFontFace("/path/to/bold-font.ttf", 48); err != nil {
    // 处理字体加载错误
}

word := "目标文字"
x, y := 100.0, 200.0

// 第一步：绘制黑色粗描边
dc.SetRGB(0, 0, 0)
dc.SetLineWidth(4) // 描边宽度随文字大小调整
dc.DrawString(word, x, y)
dc.Stroke()

// 第二步：绘制白色填充文字
dc.SetRGB(1, 1, 1)
dc.DrawString(word, x, y)
dc.Fill()

2. 添加半透明背景块 #

在文字下方绘制半透明矩形背景，将文字与复杂图片背景彻底隔离，从根源避免背景干扰。

示例代码：

existing, err := gg.LoadJPG(path)
if err != nil {
    // 处理错误逻辑
}
dc := gg.NewContextForImage(existing)

// 加载字体
dc.LoadFontFace("/path/to/font.ttf", 48)
word := "目标文字"
x, y := 100.0, 200.0

// 获取文字边界框，计算背景块尺寸
bounds := dc.MeasureString(word)
padding := 10.0
bgX := x - padding
bgY := y - bounds.Height - padding
bgWidth := bounds.Width + padding*2
bgHeight := bounds.Height + padding*2

// 绘制半透明黑色背景（透明度可按需调整）
dc.SetRGBA(0, 0, 0, 0.7)
dc.DrawRectangle(bgX, bgY, bgWidth, bgHeight)
dc.Fill()

// 绘制白色文字
dc.SetRGB(1, 1, 1)
dc.DrawString(word, x, y)

3. 优化字体与尺寸 #

• 使用粗体字体：粗体字视觉权重更高，在复杂背景下辨识度更强；
• 适当放大文字：在场景允许的前提下，增大文字尺寸直接提升可读性。

4. 自适应背景颜色（进阶方案） #

检测文字区域的背景平均亮度，动态切换文字与阴影颜色：

• 背景偏亮时用深色文字+浅色阴影；
• 背景偏暗时用浅色文字+深色阴影。

示例代码（简化版）：

// 假设已获取文字区域背景的平均颜色值avgR, avgG, avgB（范围0-1）
brightness := (avgR + avgG + avgB) / 3.0
var textColor, shadowColor gg.Color

if brightness > 0.5 { // 背景偏亮
    textColor = gg.NewRGB(0, 0, 0)   // 黑色文字
    shadowColor = gg.NewRGB(1, 1, 1) // 白色偏移阴影
} else { // 背景偏暗
    textColor = gg.NewRGB(1, 1, 1)   // 白色文字
    shadowColor = gg.NewRGB(0, 0, 0) // 黑色偏移阴影
}

// 绘制小偏移阴影
dc.SetColor(shadowColor)
dc.DrawString(word, x+1, y+1)

// 绘制主体文字
dc.SetColor(textColor)
dc.DrawString(word, x, y)

内容的提问来源于stack exchange，提问作者Andrew Arrow