处理
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