Go draw.DrawMask 怎样用透明遮罩合成局部图像

Go 的 image/draw.DrawMask 适合把一张源图按透明遮罩合成到目标画布。关键不是先调颜色，而是先让三组坐标指向同一个逻辑像素：目标矩形的 r.Min 对齐源图起点 sp，也对齐遮罩起点 mp。再根据是否保留目标背景，选择 draw.Src 或 draw.Over。

先把 DrawMask 的三组坐标对齐

DrawMask 的签名可以先按“目标区域、源图起点、mask 起点”来读：

draw.DrawMask(dst, r, src, sp, mask, mp, draw.Over)
// r.Min 是目标区域的锚点；sp 和 mp 分别是源图、mask 对应的锚点。
// 三个锚点表示同一个逻辑像素，尺寸由 r 的宽高限制。

例如 r := image.Rect(48, 18, 112, 82) 时，目标区域是 64×64；若 sp 和 mp 都是零点，就从源图和 mask 的左上角取 64×64。把 sp 改为 image.Pt(8, 4)，只会改变源图采样起点，不会改变目标位置。mask 也必须用同样的逻辑关系计算，否则会出现图像已移动、遮罩却还停在原处的错位。

用灰度 mask 控制局部覆盖

mask 不需要与源图使用同一种颜色模型，但它必须能提供透明度信息。最容易观察的做法是使用 image.Alpha：0 表示这一点不让源图参与，255 表示完全参与，中间值表示边缘渐变。

mask := image.NewAlpha(image.Rect(0, 0, 64, 64))
for y := 0; y 

这里的 mask 只控制“源图参与多少”，不是裁剪源图的尺寸。目标区域仍由 r 决定，源图坐标仍由 sp 决定。如果 mask 比 r 小，超出 mask Bounds 的部分不会凭空生成有效遮罩；排查时应先打印三者的 Bounds()，再确认采样起点加上区域尺寸没有超出预期。

根据 draw.Src 和 draw.Over 选择合成结果

先准备一个带背景色的目标画布和一张源图，再决定操作符：

dst := image.NewNRGBA(image.Rect(0, 0, 160, 100))
src := image.NewNRGBA(image.Rect(0, 0, 64, 64))

// 先铺一层目标背景，后面的结果才能看出是否保留了 dst。
draw.Draw(dst, dst.Bounds(), image.NewUniform(color.NRGBA{R: 24, G: 32, B: 48, A: 255}), image.Point{}, draw.Src)
draw.Draw(src, src.Bounds(), image.NewUniform(color.NRGBA{R: 42, G: 190, B: 176, A: 210}), image.Point{}, draw.Src)

r := image.Rect(48, 18, 112, 82)
draw.DrawMask(dst, r, src, image.Point{}, mask, image.Point{}, draw.Over)
// draw.Over 会把源图按 mask 和自身 alpha 覆盖到 dst 上，适合保留背景。

如果把最后一个参数改成 draw.Src，目标区域会更接近“用合成后的源像素替换原像素”；如果使用 draw.Over，目标背景会参与 Porter-Duff 覆盖。注意这不是简单的“透明就跳过”：mask、源图 alpha 和操作符会一起影响最终像素。

用像素检查定位空白和偏移

结果看起来为空时，不要只调 mask 的 alpha。优先检查目标采样点是否落在 r 内、源图和 mask 是否存在对应坐标，并确认目标画布实现了可写的 Set。必要时读取一个中心点和一个边缘点：

rr, gg, bb, aa := dst.At(80, 50).RGBA()
// RGBA 返回的是扩展到 16 位的通道值，先看 alpha 再判断颜色是否有效。
fmt.Printf("center=%d,%d,%d,%d\n", rr, gg, bb, aa)

中心点有颜色、边缘点过渡明显，通常说明坐标和 mask 已经生效；整个区域都不变，多半是 r 越界、sp/mp 取错起点或 mask alpha 全为 0。若只是想把源图完整贴到目标区域，可以先用 draw.Draw 验证坐标，再增加 mask，这样定位更快。

常见问题

DrawMask 的 mask 可以传 nil 吗？

可以。官方文档把 nil mask 视为不透明遮罩，但仍要正确传入 r、sp 和操作符。

为什么 mask 有灰度但合成边缘没有渐变？

检查源图自身 alpha、mask 的采样起点和操作符；若 mask 被错位采样，读到的可能是全 0 或全 255 区域。

应该先选 draw.Src 还是 draw.Over？

先用 draw.Src 验证区域和坐标，再按是否需要保留目标背景改用 draw.Over，不要用操作符差异掩盖坐标问题。