Go image/draw 怎样把图像绘制到带偏移的画布

用 Go 的 image/draw 把一张图放到画布右下角时，真正决定偏移的不是“移动画布”，而是目标矩形 r 的左上角。draw.Draw 会把 r.Min 与源点 sp 对齐：如果目标矩形从 (40, 30) 开始，源点取源图像左上角，图像就会从画布的 (40, 30) 写入。目标矩形越界时只保留有效交集，不会自动缩放。

问题现场：图像总是贴在画布左上角

常见写法是把 src.Bounds() 直接传给 draw.Draw，这样得到的确实是一次完整绘制，但它的 Min 通常是 (0,0)，结果自然贴在画布左上角。排查时先把“源图像大小”和“目标落点”拆开，不要用修改源图像边界来代替目标位置。

本例只做平移绘制：源图像大小为 80×60，目标画布为 240×160，期望它从 (40,30) 开始出现。

把偏移量翻译成目标矩形

用偏移量加上源图像尺寸构造目标矩形即可。image.Rect 的右下角是半开区间，宽度是 Max.X-Min.X，所以不要把宽高直接当成右下坐标。下面的 sp 使用源图像自己的 Bounds().Min，即使源图像带有非零坐标原点也不会错位。

package main

import (
    "image"
    "image/color"
    "image/draw"
)

func main() {
    // 创建可写的目标画布，坐标原点位于画布左上角。
    dst := image.NewRGBA(image.Rect(0, 0, 240, 160))
    // 用纯色源图代替真实图片，便于关注坐标关系。
    src := image.NewRGBA(image.Rect(0, 0, 80, 60))
    draw.Draw(src, src.Bounds(), image.NewUniform(color.RGBA{R: 40, G: 150, B: 220, A: 255}), image.Point{}, draw.Src)

    offsetX, offsetY := 40, 30
    // 右下角使用半开区间：落点加上源图像的宽高。
    r := image.Rect(offsetX, offsetY,
        offsetX+src.Bounds().Dx(), offsetY+src.Bounds().Dy())
    // r.Min 与 sp 对齐，源图像左上角落在 (40, 30)。
    draw.Draw(dst, r, src, src.Bounds().Min, draw.Src)
}

这段调用的关键关系是 dst(40,30) 对应 src.Bounds().Min，并不是把源图像的每个像素坐标再手动加一次偏移。手动加偏移后再传给 r，很容易造成双重偏移。

处理源点和边界裁剪

draw.Draw 不负责缩放。如果 r 比源图像大，能读取到的源区域不足；如果 r 比源图像小，则只绘制与 r 对应的那一部分。目标矩形超出 dst.Bounds() 时，库会把绘制区域裁到目标和源都有效的交集，越界像素不会写入画布。

因此，出现“右侧少了一截”时，先看 r.Max 是否超过画布边界；出现“取图位置不对”时，检查 sp 是否来自正确的源坐标。带非零原点的子图尤其要注意：image.Point{} 不一定是源图像左上角。

选择 draw.Src 还是 draw.Over

两张不透明图做整块替换时，draw.Src 语义直接，目标区域由源像素替换。需要保留目标背景、叠加带透明通道的贴纸或蒙版时，使用 draw.Over，源像素按透明度覆盖在目标像素之上。透明边缘发黑或背景被清空，通常不是偏移错了，而是合成操作选错了。

复查结果时可以按三个坐标点判断：偏移点 r.Min 是否出现源图像内容；目标矩形外是否保持原画布；目标矩形内的半透明像素是否仍能看到背景。若三者都符合，偏移绘制的坐标链路就成立。

相关问题

image/draw.Draw 会自动缩放图片吗？

不会。它按源点和目标矩形做绘制与裁剪，不提供缩放插值。需要缩放时应先得到尺寸匹配的源图像，再调用 Draw。

为什么传 image.Point{} 有时会错位？

因为源图像的有效坐标起点不一定是零。应根据要读取的区域传入源坐标，整张源图通常可用 src.Bounds().Min。

目标矩形超出画布会报错吗？

通常不会因普通越界直接报错，库会裁剪到有效交集；但越界部分不会产生像素，业务上仍应检查 r.Intersect(dst.Bounds()) 是否为空。

把偏移问题固定成“目标矩形 r、源点 sp、合成操作 op”三个变量，排查就会从猜坐标变成查对齐关系。先确认 r.Min，再确认 sp，最后决定 Src 或 Over，是这类绘制任务最短的检查路径。