Go image/draw.Draw 怎样按坐标偏移复制图像区域
Go image/draw.Draw 怎样按坐标偏移复制图像区域
用 Go 把一张小图贴到画布的指定位置时,image/draw.Draw 的关键不是“把图片画上去”这句描述,而是把目标矩形 r 与源起点 sp 对齐:r.Min 对应 sp,r 的宽高决定复制多少像素。只要这条关系固定,局部贴图、拼接和裁剪都可以用同一套坐标推导完成。
本文只讨论标准库 image/draw.Draw 的坐标关系、边界裁剪和 draw.Src/draw.Over 选择,不把透明蒙版或图片编码混进同一个示例。

先记住一条坐标规则
Draw 的签名是:
func Draw(dst Image, r image.Rectangle, src image.Image, sp image.Point, op Op)
官方文档把它定义为“使用空 mask 调用 DrawMask”。因此可以把参数理解为:
dst:要被写入的目标图像,必须是可写的draw.Image。r:目标图像中的写入矩形,宽高决定要复制的区域。src:提供像素的源图像。sp:源图像中与r.Min对齐的起点。op:像素合成方式,常见的是draw.Src和draw.Over。
例如,r 是 (20, 10)-(70, 50),sp 是 (5, 8),那么目标点 (20, 10) 读取源点 (5, 8),目标点向右下移动一个像素,源点也同步向右下移动一个像素。
用目标矩形复制一块区域
下面的示例创建一张画布,从源图的 (8, 6) 开始取出与目标矩形同样大小的区域,贴到画布的 (24, 16) 位置。示例使用 draw.Src,表示目标矩形内的像素由源图结果直接替换。
package main
import (
"fmt"
"image"
"image/color"
"image/draw"
)
func main() {
// 画布使用带透明通道的 RGBA 图像,便于观察目标区域的覆盖结果。
dst := image.NewRGBA(image.Rect(0, 0, 96, 64))
src := image.NewRGBA(image.Rect(0, 0, 48, 32))
// 先给源图填充颜色;真实项目中这里通常来自解码后的图片。
draw.Draw(src, src.Bounds(), image.NewUniform(color.RGBA{R: 40, G: 150, B: 220, A: 255}), image.Point{}, draw.Src)
// r 的左上角是目标位置,宽高是要复制的区域大小。
r := image.Rect(24, 16, 72, 48)
sp := image.Point{X: 8, Y: 6}
// r.Min 与 sp 对齐;Src 会直接替换目标矩形中的像素。
draw.Draw(dst, r, src, sp, draw.Src)
fmt.Printf("target=%v source-start=%v\n", r, sp)
}
这个调用复制的是源图中从 (8,6) 到 (56,38) 的对应区域。源图没有被移动,sp 只是告诉绘制器从哪里开始读;真正的写入范围由 r 决定。
偏移不是修改 sp,而是同时改变 r
如果要让同一块源图向右下移动 12 个像素,通常保持 sp 不变,把 r 的两个坐标同时加上偏移量:
// 偏移只改变目标矩形,源图采样起点保持不变。
offset := image.Pt(12, 10)
r = r.Add(offset)
draw.Draw(dst, r, src, sp, draw.Src)
如果同时改变 r 和 sp,那就不只是移动,而是改变了源图的采样区域。可以用下面这张判断表快速区分:
| 目标 | r | sp | 结果 |
|---|---|---|---|
| 移动同一块内容 | 整体平移 | 不变 | 内容采样不变,目标位置改变 |
| 换一块源区域 | 不变 | 改变 | 目标位置不变,采样窗口改变 |
| 缩小复制范围 | 缩小宽高 | 按需要调整 | 只复制更小的矩形 |
目标矩形超出 Bounds 时会怎样
贴图位置可能来自用户坐标或布局计算,r 不一定完全落在 dst.Bounds() 内。安全做法是先求交集,再同步调整源点:
func drawClipped(dst draw.Image, r image.Rectangle, src image.Image, sp image.Point, op draw.Op) {
// 保存原始左上角,用于把目标裁剪量换算成源图偏移量。
originalMin := r.Min
clipped := r.Intersect(dst.Bounds())
if clipped.Empty() {
// 没有交集时不调用 Draw,避免把空区域当成有效贴图。
return
}
// 目标左上角被裁掉多少,源起点就向同方向前进多少。
sp = sp.Add(clipped.Min.Sub(originalMin))
draw.Draw(dst, clipped, src, sp, op)
}
这里的关键是 clipped.Min - originalMin。例如目标矩形左侧越界 5 个像素,裁剪后的目标从原来的 x+5 开始,源起点也必须加 5;只裁剪 r 而不改 sp,得到的会是错位内容。

draw.Src 和 draw.Over 怎么选
op 不负责坐标计算,它只决定源像素如何与目标像素组合:
draw.Src:用源结果替换目标区域,适合不透明贴图、清理旧像素或希望透明像素也覆盖目标的场景。draw.Over:把源内容叠加在目标之上,源图的 alpha 会参与合成,适合透明装饰层。
如果你发现“透明区域没有把目标清掉”,通常不是坐标错了,而是选择了 draw.Over。反过来,如果希望半透明图层保留背景,却用了 draw.Src,结果也会显得像整块替换。
封装一个不容易错位的贴图函数
项目里反复贴图时,建议把“目标矩形、源起点、越界处理”放到同一个函数里,让调用者只关心位置和尺寸:
func pasteAt(dst draw.Image, src image.Image, at image.Point, size image.Point, op draw.Op) {
// size 决定目标矩形,不直接使用 src.Bounds,便于只复制源图的一部分。
r := image.Rectangle{Min: at, Max: at.Add(size)}
sp := src.Bounds().Min
// 交集为空时直接返回;否则按裁剪量同步调整源点。
originalMin := r.Min
r = r.Intersect(dst.Bounds())
if r.Empty() {
return
}
sp = sp.Add(r.Min.Sub(originalMin))
draw.Draw(dst, r, src, sp, op)
}
调用时可以写成 pasteAt(dst, src, image.Pt(24, 16), image.Pt(48, 32), draw.Src)。这个封装没有替你检查源图是否足够大;如果 sp 加上复制尺寸超出源图,仍应在业务层决定是接受源图边界带来的空白、先裁剪源区域,还是拒绝这次操作。
最后的速查结论
image/draw.Draw 的坐标心智模型可以压缩成三句话:r.Min 和 sp 是同一个像素的两种坐标;r 的宽高决定读写窗口;目标越界时,目标裁剪量必须同步加到源点。完成坐标计算后,再根据“直接替换”还是“透明叠加”选择 draw.Src 或 draw.Over。
相关问题
为什么同一张源图贴到不同位置时只改 r 就够了?
因为 sp 决定源采样起点,保持它不变并整体平移 r,表示复制同一块内容到新位置。
r 是空矩形时还需要调用 Draw 吗?
不需要。空矩形没有有效像素区域,封装函数里先判断 Empty() 可以减少无意义调用。
Draw 能不能完成缩放?
不能。它按像素一一对应地复制矩形;如果目标尺寸和源区域尺寸不同,应使用专门的缩放实现,再把缩放结果交给 Draw 进行贴图。
Go debug/pe.FileHeader.TimeDateStamp 怎样读取 PE 时间戳
- 上一篇
- Go debug/pe.FileHeader.TimeDateStamp 怎样读取 PE 时间戳
- 下一篇
- Go text/template Exec 怎样把模板输出直接写入缓冲区
-
- Golang · Go教程 | 19分钟前 |
- Go debug/pe.FileHeader.TimeDateStamp 怎样读取 PE 时间戳
- 393浏览 收藏
-
- Golang · Go教程 | 22分钟前 |
- Go image/draw.Over 怎样进行带透明度的图像合成
- 123浏览 收藏
-
- Golang · Go教程 | 25分钟前 |
- Go zlib.NewReader 遇到预置字典时怎么配置
- 217浏览 收藏
-
- Golang · Go教程 | 28分钟前 | Go教程 · Go image/gif gif.Encode 单帧GIF
- Go image/gif.Encode 怎样写入单帧 GIF 并处理编码错误
- 284浏览 收藏
-
- Golang · Go教程 | 31分钟前 |
- Go hash/fnv 怎样计算稳定的非加密哈希
- 324浏览 收藏
-
- Golang · Go教程 | 34分钟前 |
- Go color.Palette.Index 怎样为颜色寻找最近调色板索引
- 342浏览 收藏
-
- Golang · Go教程 | 39分钟前 | go · Go ELF debug/elf DynamicVersionNeeds DynamicVersionDep
- Go debug/elf.File.DynamicVersionNeeds 怎样读取动态库版本依赖
- 178浏览 收藏
-
- Golang · Go教程 | 43分钟前 |
- Go unicode/utf8.DecodeLastRuneInString 怎样从字符串尾部读取字符
- 490浏览 收藏
-
- Golang · Go教程 | 49分钟前 |
- Go flate Resetter 如何复用压缩器降低分配
- 124浏览 收藏
-
- Golang · Go教程 | 50分钟前 | go ·
- Go x509.OID.MarshalText 怎样序列化对象标识符
- 398浏览 收藏
-
- Golang · Go教程 | 56分钟前 | 标准库 · Go教程 · 兼容性 · Go archive/zip FileHeader NonUTF8 ZIP文件名
- Go archive/zip.FileHeader.NonUTF8 怎样处理非 UTF-8 文件名
- 250浏览 收藏
-
- Golang · Go教程 | 1小时前 |
- Go http.Server.ConnState 怎样区分 StateNew 和 StateActive
- 269浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1062次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1062次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1228次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1172次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1013次使用
-
- GScript 编写标准库示例详解
- 2022-12-30 369浏览
-
- 关于Golang标准库flag的全面讲解
- 2023-02-25 344浏览
-
- Golang标准库unsafe源码解读
- 2022-12-29 464浏览
-
- 快速掌握Go语言HTTP标准库的实现方法
- 2022-12-30 327浏览
-
- 解析golang 标准库template的代码生成方法
- 2022-12-24 349浏览

