Crop

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

The Crop method returns a new resource from a processable image according to the given processing specification.

[!note] Use the reflect.IsImageResourceProcessable function to verify that an image can be processed.

Usage

When cropping, you must provide both width and height (such as 200x200) within the specification. This method does not perform any resizing; it simply extracts a region of the image based on the dimensions and the anchor provided, if any.

{{ with resources.Get "images/original.jpg" }}
  {{ with .Crop "200x200 TopRight" }}
    
  {{ end }}
{{ end }}

In the example above, "200x200 TopRight" is the processing specification.

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

Example

{{ with resources.Get "images/original.jpg" }}
  {{ with .Crop "200x200 TopRight" }}
    
  {{ end }}
{{ end }}

{{< img src="images/examples/zion-national-park.jpg" alt="Zion National Park" filter="Process" filterArgs="crop 200x200 TopRight" example=true

}}