处理
语法
RESOURCE.Process SPEC
返回值
images.ImageResource
使用给定规范处理图像。该规范可以包含一个可选操作,即 crop
、fill
、fit
或 resize
中的一个。这意味着您可以使用此方法代替 Crop
、Fill
、Fit
或 Resize
。
{{ with resources.Get "images/original.jpg" }}
{{ with .Process "crop 200x200" }}
<img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
{{ end }}
{{ end }}
您也可以使用此方法应用简单的转换,例如旋转和转换
{{/* Rotate 90 degrees counter-clockwise. */}}
{{ $image := $image.Process "r90" }}
{{/* Convert to WebP. */}}
{{ $image := $image.Process "webp" }}
如果需要将多个过滤器应用于图像,Process
方法也可用作过滤器,这更有效。请参阅 images.Process
。
处理规范
处理规范是一个以空格分隔、不区分大小写的列表,其中包含以下一个或多个(以任何顺序):
- 操作
- 仅适用于
Process
方法。指定零个或一个crop
、fill
、fit
或resize
。如果指定操作,则还必须提供尺寸。 - 尺寸
- 使用
Resize
方法时提供宽度或高度,否则提供宽度和高度。请参阅详细信息。 - 锚点
- 与
Crop
和Fill
方法一起使用。指定零个或一个TopLeft
、Top
、TopRight
、Left
、Center
、Right
、BottomLeft
、Bottom
、BottomRight
或Smart
。默认值为Smart
。请参阅详细信息。 - 旋转
- 通常指定零个或一个
r90
、r180
或r270
。还支持任意旋转角度。请参阅详细信息。 - 目标格式
- 指定零个或一个
gif
、jpeg
、png
、tiff
或webp
。请参阅详细信息。 - 质量
- 适用于 JPEG 和 WebP 图像。可选择指定
qN
,其中N
是 [0, 100] 范围内的整数。默认值为75
。请参阅详细信息。 - 提示
- 适用于 WebP 图像,等效于
cwebp
编码器的-preset
标志。指定零个或一个drawing
、icon
、photo
、picture
或text
。默认值为photo
。请参阅详细信息。
- 背景色
- 将具有透明度的 PNG 或 WebP 转换为不支持透明度的格式时,可选择使用 3 位或 6 位十六进制颜色代码指定背景色。默认值为
#ffffff
(白色)。请参阅详细信息。 - 重采样过滤器
- 通常指定零个或一个
Box
、Lanczos
、CatmullRom
、MitchellNetravali
、Linear
或NearestNeighbor
。还有其他重采样过滤器可用。请参阅详细信息。
示例
{{ with resources.Get "images/original.jpg" }}
{{ with .Process "crop 200x200 topright webp q85 lanczos" }}
<img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
{{ end }}
{{ end }}
原始

已处理
