Files
hugo/docs/content/en/methods/resource/Crop.md
Bjørn Erik Pedersen 5fd1e74903 Merge commit '9b0050e9aabe4be65c78ccf292a348f309d50ccd' as 'docs'
```
git subtree add --prefix=docs/ https://github.com/gohugoio/hugoDocs.git master --squash
```

Closes #11925
2024-01-27 10:48:57 +01:00

1.3 KiB

title, description, categories, keywords, action, toc
title description categories keywords action toc
Crop Applicable to images, returns an image resource cropped to the given dimensions without resizing.
related returnType signatures
methods/resource/Fit
methods/resource/Fill
methods/resource/Resize
methods/resource/Process
functions/images/Process
images.ImageResource
RESOURCE.Crop SPEC
true

Crop an image to match the given dimensions without resizing. You must provide both width and height.

{{ with resources.Get "images/original.jpg" }}
  {{ with .Crop "200x200" }}
    <img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
  {{ end }}
{{ end }}

{{% include "methods/resource/_common/global-page-remote-resources.md" %}}

{{% include "/methods/resource/_common/processing-spec.md" %}}

Example

{{ with resources.Get "images/original.jpg" }}
  {{ with .Crop "200x200 topright webp q85 lanczos" }}
    <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 q85 lanczos" example=true

}}