处理
Syntax
RESOURCE.Process SPEC
Returns
images.ImageResource
使用给定的规格处理图像。规格可以包含一个可选的动作,其中之一是 调整大小
、剪裁
、适应
或填充
。这意味着您可以使用此方法而不是 剪裁
、填充
、适应
或调整大小
方法。
{{ with resources.Get "images/original.jpg" }}
{{ with .处理 "剪裁 200x200" }}
<img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
{{ end }}
{{ end }}
您还可以使用此方法应用简单的转换,例如旋转和转换格式:
{{/* 逆时针旋转 90 度。 */}}
{{ $image := $image.Process "r90" }}
{{/* 转换为 WebP 格式。 */}}
{{ $image := $image.Process "webp" }}
处理
方法还可作为过滤器使用,如果您需要对图像应用多个过滤器,则更有效。请参阅 images.处理
。
处理规范
处理规范是一个以空格分隔、不区分大小写的列表,可以按任意顺序包含以下内容之一:
- action
- 仅适用于
Process
方法。指定零或一个动作,其中可以是resize
、fit
、fill
或crop
。如果指定了动作,还必须提供尺寸。 - dimensions
- 在使用
Resize
方法时,提供宽度 或 高度,否则提供宽度 和 高度。详见 详情。 - anchor
- 与
Crop
和Fill
方法一起使用。指定零或一个锚点,其中可以是TopLeft
、Top
、TopRight
、Left
、Center
、Right
、BottomLeft
、Bottom
、BottomRight
或Smart
。默认值是Smart
。详见 详情。 - rotation
- 通常指定零或一个
r90
、r180
或r270
。还支持任意旋转角度。详见 详情。 - 目标格式
- 指定零或一个
gif
、jpeg
、png
、tiff
或webp
。详见 详情。 - 质量
- 适用于 JPEG 和 WebP 图像。可选择指定
qN
,其中N
是介于 [0, 100] 范围内的整数。默认值是75
。详见 详情。 - 提示
- 适用于 WebP 图像。指定零或一个
drawing
、icon
、photo
、picture
或text
。默认值是photo
。详见 详情。 - 背景色
- 当将透明度为 PNG 或 WebP 转换为不支持透明度的格式时,可以选择使用 3 位或 6 位十六进制颜色码指定背景色。默认值是
#ffffff
(白色)。详见 详情。 - 重采样滤波器
- 通常指定零或一个
Box
、Lanczos
、CatmullRom
、MitchellNetravali
、Linear
或NearestNeighbor
。还有其他可用的重采样滤波器。详见 详情。
示例
{{ with resources.Get "images/original.jpg" }}
{{ with .处理 "剪裁 200x200 右上 webp q85 lanczos" }}
<img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
{{ end }}
{{ end }}
Original
Processed