在goframe框架中实现图片缩放与打水印,核心是调用 gimage 包的 newimage() 方法加载源文件,随后链式调用 resize() 或 scale() 进行尺寸调整,并使用 watermark() 方法叠加文字或图片。执行完毕后,通过 save() 将处理后的图像对象保存至指定路径即可。

gimage 如何配置缩放比例与模式
使用 Resize() 方法时,需明确传入目标宽度、高度及缩放模式(如等比缩放、拉伸填充)。若希望保持原图比例,应设置其中一个维度为0,由系统自动计算另一维度;若强制指定宽高,则图像会被拉伸以适应新尺寸。该操作直接修改内存中的图像数据,不会立即写入磁盘。

package main
import (
"github.com/gogf/gf/v2/frame"
"github.com/gogf/gf/v2/os/gfile"
)
func main() {
// 初始化框架
gf := frame.Default()
// 定义输入输出路径
inputPath := "./source.jpg"
outputPath := "./resized.jpg"
// 1. 加载图片
img, err := gimage.NewImage(inputPath)
if err != nil {
panic(err)
}
// 2. 等比缩放:宽度设为200,高度自动计算
err = img.Resize(200, 0, gimage.ResizeAuto)
if err != nil {
panic(err)
}
// 3. 保存结果
err = img.Save(outputPath)
if err != nil {
panic(err)
}
println("缩放完成")
}运行上述代码后,source.jpg 将被缩放并保存为 resized.jpg。若原图宽400高300,结果将为宽200高150。若使用 Resize(200, 200, gimage.Stretch),则结果强制为200x200,可能导致变形。
如何添加文字水印并控制位置与透明度
调用 Watermark() 方法可叠加文字水印。该方法接受水印文本、字体文件路径、字号、颜色、不透明度以及位置参数。位置支持常量如 gimage.WatermarkCenter、gimage.WatermarkBottomRight 等。若未提供字体文件,GoFrame 会尝试使用系统默认字体,但在跨平台环境中建议显式指定字体路径以确保一致性。

package main
import (
"github.com/gogf/gf/v2/frame"
"github.com/gogf/gf/v2/os/gfile"
"image/color"
)
func main() {
gf := frame.Default()
inputPath := "./source.jpg"
outputPath := "./watermarked.jpg"
img, err := gimage.NewImage(inputPath)
if err != nil {
panic(err)
}
// 添加文字水印:内容、字体、大小、颜色、透明度、位置
fontPath := "/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf"
colorWhite := color.RGBA{255, 255, 255, 200} // 半透明白色
err = img.Watermark(
"Copyright 2024",
fontPath,
24,
colorWhite,
0.8,
gimage.WatermarkBottomRight,
10, // 边距
)
if err != nil {
panic(err)
}
err = img.Save(outputPath)
if err != nil {
panic(err)
}
println("水印添加完成")
}执行后,source.jpg 右下角将叠加半透明白色文字“Copyright 2024”,字体大小为24px,边距10像素。若字体路径无效,程序将抛出错误。
同时缩放与打水印的执行顺序会影响结果吗
是的,执行顺序直接影响最终效果。若先缩放再打水印,水印将基于缩小后的图像尺寸进行定位和渲染,文字相对图像比例更协调;若先打水印再缩放,水印也会被一同缩小,可能导致文字模糊或难以辨认。因此,推荐先完成几何变换(缩放),再进行内容叠加(水印)。
package main
import (
"github.com/gogf/gf/v2/frame"
"github.com/gogf/gf/v2/os/gfile"
"image/color"
)
func main() {
gf := frame.Default()
inputPath := "./source.jpg"
outputPath := "./final.jpg"
img, err := gimage.NewImage(inputPath)
if err != nil {
panic(err)
}
// 正确顺序:先缩放
err = img.Resize(300, 0, gimage.ResizeAuto)
if err != nil {
panic(err)
}
// 再打水印
fontPath := "/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf"
colorBlack := color.RGBA{0, 0, 0, 180}
err = img.Watermark(
"Sample Watermark",
fontPath,
20,
colorBlack,
0.7,
gimage.WatermarkCenter,
0,
)
if err != nil {
panic(err)
}
err = img.Save(outputPath)
if err != nil {
panic(err)
}
println("缩放+水印完成")
}此代码确保水印在缩放后的图像上居中显示,文字清晰可读。若颠倒顺序,水印将随图像一起缩小,视觉效果较差。


















