文档章节
图像函数
创建图像滤镜、把滤镜链应用到图片上,以及读取图像信息:亮度、对比度、色彩、模糊、遮罩、叠加、二维码等。
开始之前,你需要
- 站点里已经有图片资源(放在页面包里或
assets/下),并且你知道用resources.Get或页面资源方法把它们取出来。 - 读过图像处理的总览——本组是那里的细分参考。
读完之后你能
- 分清本组的三种角色:生成滤镜(如
images.Brightness)、应用滤镜(images.Filter)、读信息(images.Config/images.QR); - 把多个滤镜串成一条链应用到图片上,并理解滤镜的应用顺序会影响结果;
- 知道滤镜只作用于图像资源,缩放裁剪那类几何操作属于
Resource上的方法(.Resize/.Fill/.Fit/.Crop); - 遇到「滤镜没效果」时,先确认拿到的确实是图像资源(而不是普通文件),再用
debug.Dump看资源类型。
这一组的三种角色
先把角色分清,用起来就不会乱:
| 角色 | 代表 | 说明 |
|---|---|---|
| 生成滤镜 | 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 返回一个锐化图像的图像滤镜。 (今天)