处理
语法
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 }}
原始
已处理