hugo/docs/content/en/methods/resource/Resize.md
2023-12-04 15:24:01 +01:00

1.3 KiB

title description categories keywords action
Resize Applicable to images, returns an image resource resized to the given width and/or height.
related returnType signatures
methods/resource/Crop
methods/resource/Fit
methods/resource/Fill
methods/resource/Process
functions/images/Process
images.ImageResource
RESOURCE.Resize SPEC

Resize an image to the given width and/or height.

If you specify both width and height, the resulting image will be disproportionally scaled unless the original image has the same aspect ratio.

{{ with resources.Get "images/original.jpg" }}
  {{ with .Resize "300x" }}
    <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 .Resize "300x 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="resize 300x webp q85 lanczos" example=true

}}