文档章节

图像函数

创建图像滤镜、把滤镜链应用到图片上,以及读取图像信息:亮度、对比度、色彩、模糊、遮罩、叠加、二维码等。

难度
进阶
预计用时
按需查阅;动手约 30 分钟

开始之前,你需要

  • 站点里已经有图片资源(放在页面包里或 assets/ 下),并且你知道用 resources.Get 或页面资源方法把它们取出来。
  • 读过图像处理的总览——本组是那里的细分参考。

读完之后你能

  • 分清本组的三种角色:生成滤镜(如 images.Brightness)、应用滤镜(images.Filter)、读信息(images.Config / images.QR);
  • 把多个滤镜串成一条链应用到图片上,并理解滤镜的应用顺序会影响结果;
  • 知道滤镜只作用于图像资源,缩放裁剪那类几何操作属于 Resource 上的方法(.Resize / .Fill / .Fit / .Crop);
  • 遇到「滤镜没效果」时,先确认拿到的确实是图像资源(而不是普通文件),再用 debug.Dump 看资源类型。

接着读:图像处理 · Filter · Resize

这一组的三种角色

先把角色分清,用起来就不会乱:

角色 代表 说明
生成滤镜 Brightness、Contrast、GaussianBlur、Grayscale、Sepia、Colorize、Hue、Saturation、Gamma、Sigmoid、Pixelate、Dither、Invert、Opacity、ColorBalance、UnsharpMask、AutoOrient、Padding、Text、Overlay、Mask、Process 本身不处理图片,只是产出一个「滤镜值」
应用滤镜 Filter 把一个或多个滤镜作用到图像资源上,返回新的图像资源
读信息 / 生成 Config、QR 读图像配置;按文本生成二维码图片

典型用法

滤镜必须通过 images.Filter 应用,单独调用不会产生任何效果:

go-html-template
{{ with resources.Get "images/photo.jpg" }}
  {{ $filters := slice
    (images.Grayscale)
    (images.Contrast 20)
    (images.GaussianBlur 2)
  }}
  {{ $img := .Filter $filters }}
  <img src="{{ $img.RelPermalink }}" width="{{ $img.Width }}" height="{{ $img.Height }}" alt="">
{{ end }}

顺序有意义:先灰度再提对比度,和先提对比度再灰度,结果不同——按你想要的视觉流程排列。

什么时候用、什么时候别用

  • 用:需要在构建期批量统一图片风格(水印、去色、统一亮度),产物是一次性生成好的静态文件;
  • 别用:旋转、缩放、裁剪、改格式 → 那些是 Resource 的方法(.Resize、.Fill、.Fit、.Crop、.Process),不属于本组;
  • 代价:每个滤镜都会产生一份新的派生图片文件,滤镜数量 × 图片数量会显著增加构建时间与产物体积,先用少量图片量一下再全量铺开。

完整的处理流程(取资源 → 处理 → 输出、缓存与指纹)见图像处理。

下方列出本站收录的本组全部函数。

本章内容

  • images.AutoOrient 返回一个图像滤镜,按图像的 Exif 方向标记自动旋转和翻转图像。 (今天)
  • images.Brightness 返回一个改变图像亮度的图像滤镜。 (今天)
  • images.ColorBalance 返回一个改变图像色彩平衡的图像滤镜。 (今天)
  • images.Colorize 返回一个生成图像着色版本的图像滤镜。 (今天)
  • images.Config 返回指定路径(相对于工作目录)图像对应的 image.Config 结构。 (今天)
  • images.Contrast 返回一个改变图像对比度的图像滤镜。 (今天)
  • images.Dither 返回一个对图像做抖动(dither)处理的图像滤镜。 (今天)
  • images.Filter 返回一个新的图像资源,它是把一个或多个图像滤镜应用到给定图像资源后得到的结果。 (今天)
  • images.Gamma 返回一个对图像做伽马校正的图像滤镜。 (今天)
  • images.GaussianBlur 返回一个对图像做高斯模糊的图像滤镜。 (今天)
  • images.Grayscale 返回一个生成图像灰度版本的图像滤镜。 (今天)
  • images.Hue 返回一个旋转图像色相的图像滤镜。 (今天)
  • images.Invert 返回一个把图像颜色取反的图像滤镜。 (今天)
  • images.Mask 返回一个对源图像应用遮罩的图像滤镜。 (今天)
  • images.Opacity 返回一个改变图像不透明度的图像滤镜。 (今天)
  • images.Overlay 返回一个把源图像叠加到指定坐标(相对左上角)的图像滤镜。 (今天)
  • images.Padding 返回一个只改变图像画布尺寸、不缩放图像本身的图像滤镜。 (今天)
  • images.Pixelate 返回一个对图像做像素化(pixelate)处理的图像滤镜。 (今天)
  • images.Process 返回一个按给定处理规格处理图像的图像滤镜。 (今天)
  • images.QR 按指定选项把给定文本编码为二维码,返回一个包含该二维码的图像资源。 (今天)
  • images.Saturation 返回一个改变图像饱和度的图像滤镜。 (今天)
  • images.Sepia 返回一个生成图像棕褐色(sepia)版本的图像滤镜。 (今天)
  • images.Sigmoid 返回一个用 S 形函数改变图像对比度的图像滤镜。 (今天)
  • images.Text 返回一个为图像添加文字的图像滤镜。 (今天)
  • images.UnsharpMask 返回一个锐化图像的图像滤镜。 (今天)