# Conflicts: # docs/data/docs.yaml
1.9 KiB
title, description, categories, keywords, params
| title | description | categories | keywords | params | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Process | Applicable to images, returns a new image resource processed according to the given processing specification. |
|
|
{{% include "/_common/methods/resource/global-page-remote-resources.md" %}}
Process an image according to the given processing specification. This versatile method supports the full range of image transformations, including resizing, cropping, rotation, and format conversion, all within a single specification string.
{{ with resources.Get "images/original.jpg" }}
{{ with .Process "crop 200x200 TopRight webp q50" }}
<img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
{{ end }}
{{ end }}
In the example above, "crop 200x200 TopRight webp q50" is the processing specification.
You can also use this method to apply simple transformations such as rotation and conversion:
{{/* Rotate 90 degrees counter-clockwise. */}}
{{ $image := $image.Process "r90" }}
{{/* Convert to WebP. */}}
{{ $image := $image.Process "webp" }}
The Process method is also available as a filter, which is more effective if you need to apply multiple filters to an image. See images.Process.
{{% include "/_common/methods/resource/processing-spec.md" %}}
Example
{{ with resources.Get "images/original.jpg" }}
{{ with .Process "crop 200x200 TopRight webp q50" }}
<img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
{{ end }}
{{ end }}
{{< img src="images/examples/zion-national-park.jpg" alt="Zion National Park" filter="Process" filterArgs="crop 200x200 TopRight webp q50" example=true
}}