• Golang Gin实践 连载十六 在图片上绘制文字
    • 前言
    • 实现
      • 安装
      • 绘制文字
      • 业务逻辑
    • 验证
    • 总结
    • 参考
      • 本系列示例代码

    Golang Gin实践 连载十六 在图片上绘制文字

    本章节是 连载十五 的补充内容，建议一同食用

    前言

    主要实现合并后的海报上绘制文字的功能（这个需求也是常见的很了），内容比较简单

    实现

    这里使用的是 微软雅黑 的字体，请点击进行下载并存放到 runtime/fonts 目录下（字体文件占 16 MB 大小）

    安装

    1. $ go get -u github.com/golang/freetype

    绘制文字

    打开 service/article_service/article_poster.go 文件，增加绘制文字的业务逻辑，如下：

    1. type DrawText struct {
    2.     JPG    draw.Image
    3.     Merged *os.File
    5.     Title string
    6.     X0    int
    7.     Y0    int
    8.     Size0 float64
    10.     SubTitle string
    11.     X1       int
    12.     Y1       int
    13.     Size1    float64
    14. }
    16. func (a *ArticlePosterBg) DrawPoster(d *DrawText, fontName string) error {
    17.     fontSource := setting.AppSetting.RuntimeRootPath + setting.AppSetting.FontSavePath + fontName
    18.     fontSourceBytes, err := ioutil.ReadFile(fontSource)
    19.     if err != nil {
    20.         return err
    21.     }
    23.     trueTypeFont, err := freetype.ParseFont(fontSourceBytes)
    24.     if err != nil {
    25.         return err
    26.     }
    28.     fc := freetype.NewContext()
    29.     fc.SetDPI(72)
    30.     fc.SetFont(trueTypeFont)
    31.     fc.SetFontSize(d.Size0)
    32.     fc.SetClip(d.JPG.Bounds())
    33.     fc.SetDst(d.JPG)
    34.     fc.SetSrc(image.Black)
    36.     pt := freetype.Pt(d.X0, d.Y0)
    37.     _, err = fc.DrawString(d.Title, pt)
    38.     if err != nil {
    39.         return err
    40.     }
    42.     fc.SetFontSize(d.Size1)
    43.     _, err = fc.DrawString(d.SubTitle, freetype.Pt(d.X1, d.Y1))
    44.     if err != nil {
    45.         return err
    46.     }
    48.     err = jpeg.Encode(d.Merged, d.JPG, nil)
    49.     if err != nil {
    50.         return err
    51.     }
    53.     return nil
    54. }

    这里主要使用了 freetype 包，分别涉及如下细项：

    1、freetype.NewContext：创建一个新的 Context，会对其设置一些默认值

    1. func NewContext() *Context {
    2.     return &Context{
    3.         r:        raster.NewRasterizer(0, 0),
    4.         fontSize: 12,
    5.         dpi:      72,
    6.         scale:    12 << 6,
    7.     }
    8. }

    2、fc.SetDPI：设置屏幕每英寸的分辨率

    3、fc.SetFont：设置用于绘制文本的字体

    4、fc.SetFontSize：以磅为单位设置字体大小

    5、fc.SetClip：设置剪裁矩形以进行绘制

    6、fc.SetDst：设置目标图像

    7、fc.SetSrc：设置绘制操作的源图像，通常为 image.Uniform

    1. var (
    2.         // Black is an opaque black uniform image.
    3.         Black = NewUniform(color.Black)
    4.         // White is an opaque white uniform image.
    5.         White = NewUniform(color.White)
    6.         // Transparent is a fully transparent uniform image.
    7.         Transparent = NewUniform(color.Transparent)
    8.         // Opaque is a fully opaque uniform image.
    9.         Opaque = NewUniform(color.Opaque)
    10. )

    8、fc.DrawString：根据 Pt 的坐标值绘制给定的文本内容

    业务逻辑

    打开 service/article_service/article_poster.go 方法，在 Generate 方法增加绘制文字的代码逻辑，如下：

    1. func (a *ArticlePosterBg) Generate() (string, string, error) {
    2.     fullPath := qrcode.GetQrCodeFullPath()
    3.     fileName, path, err := a.Qr.Encode(fullPath)
    4.     if err != nil {
    5.         return "", "", err
    6.     }
    8.     if !a.CheckMergedImage(path) {
    9.         ...
    11.         draw.Draw(jpg, jpg.Bounds(), bgImage, bgImage.Bounds().Min, draw.Over)
    12.         draw.Draw(jpg, jpg.Bounds(), qrImage, qrImage.Bounds().Min.Sub(image.Pt(a.Pt.X, a.Pt.Y)), draw.Over)
    14.         err = a.DrawPoster(&DrawText{
    15.             JPG:    jpg,
    16.             Merged: mergedF,
    18.             Title: "Golang Gin 系列文章",
    19.             X0:    80,
    20.             Y0:    160,
    21.             Size0: 42,
    23.             SubTitle: "---煎鱼",
    24.             X1:       320,
    25.             Y1:       220,
    26.             Size1:    36,
    27.         }, "msyhbd.ttc")
    29.         if err != nil {
    30.             return "", "", err
    31.         }
    32.     }
    34.     return fileName, path, nil
    35. }

    验证

    访问生成文章海报的接口 $HOST/api/v1/articles/poster/generate?token=$token，检查其生成结果，如下图

    image

    总结

    在本章节在 连载十五 的基础上增加了绘制文字，在实现上并不困难，而这两块需求一般会同时出现，大家可以多加练习，了解里面的逻辑和其他 API ?

    参考

    本系列示例代码

    • go-gin-example