Crop

根據給定的 處理規格 裁剪圖像。裁剪時，您必須在規格中提供寬度和高度（如 200x200）。此方法不執行任何調整大小操作；它僅根據尺寸和提供的 錨點（如果有）提取圖像的區域。

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

在上面的示例中，"200x200 TopRight" 是_處理規格_。

處理規范

處理規范是一個空格分隔、不區分大小寫的列表，包含以下一個或多個選項（順序任意）：

action

指定 crop、fill、fit 或 resize 之一。這適用於 Process 方法和 images.Process 濾鏡。如果指定了動作，還必須提供尺寸。

anchor

裁剪或填充圖像時使用的焦點。有效選項包括 TopLeft、Top、TopRight、Left、Center、Right、BottomLeft、Bottom、BottomRight 或 Smart。Smart 選項利用 smartcrop.js 庫來識別圖像中最有趣的區域。這默認為站點配置中的 anchor 參數。

background color

將透明圖像轉換為不支持透明的格式（如 PNG 轉 JPEG）時使用的背景色。當按非正交角度旋轉圖像時，如果空間不透明且處理規范中未指定背景色，此顏色也會填充產生的空白區域。值必須是 RGB 十六進制顏色。這默認為站點配置中的 bgColor 參數。

compression

New in v0.153.5

用於圖像的編碼策略。選項為 lossy 或 lossless。請注意，lossless 僅 WebP 格式支持。這默認為站點配置中的 compression 參數。

dimensions

結果圖像的尺寸，以像素為單位。格式為 WIDTHxHEIGHT，其中 WIDTH 和 HEIGHT 為整數。調整圖像大小時，您可以僅指定寬度（如 600x）或僅指定高度（如 x400）以進行比例縮放。調整圖像大小時同時指定寬度和高度可能會導致非比例縮放。裁剪、適配或填充時，必須同時指定寬度和高度，如 600x400。

format

結果圖像的格式。有效選項包括 bmp、gif、jpeg、png、tiff 或 webp。這默認為源圖像的格式。

hint

處理 WebP 圖像時使用的編碼預設，相當於 cwebp CLI 的 -preset 標志。有效選項包括 drawing、icon、photo、picture 或 text。這默認為站點配置中的 hint 參數。

值	示例
drawing	具有高對比度細節的手繪或線條畫
icon	小型彩色圖像
photo	自然光下的戶外照片
picture	室內照片，如人像
text	主要是文本的圖像

quality

圖像的視覺保真度，適用於使用 lossy 壓縮的 JPEG 和 WebP 格式。格式為 qQUALITY，其中 QUALITY 是 1 到 100（含）之間的整數。較小的數字優先考慮較小的文件大小，而較大的數字優先考慮視覺清晰度。這默認為站點配置中的 quality 參數。

resampling filter

調整大小、適配或填充圖像時用於計算新像素的算法。常見選項包括 box、lanczos、catmullRom、mitchellNetravali、linear 或 nearestNeighbor。這默認為站點配置中的 resampleFilter 參數。

濾鏡	描述
box	簡單快速的平均濾鏡，適用於縮小
lanczos	高質量重采樣濾鏡，適用於攝影圖像，產生清晰的結果
catmullRom	銳利的立方濾鏡，比 Lanczos 濾鏡更快，同時提供相似的結果
mitchellNetravali	立方濾鏡，比 CatmullRom 產生更平滑的結果，振鈴偽影更少
linear	雙線性重采樣濾鏡，產生平滑輸出，比立方濾鏡更快
nearestNeighbor	最快的重采樣濾鏡，無抗鋸齒

有關可用重采樣濾鏡的完整列表，請參閱 源文檔。如果您希望以性能為代價提高圖像質量，可以嘗試使用替代濾鏡。

rotation

逆時針旋轉圖像的整度數。格式為 rDEGREES，其中 DEGREES 為整數。Hugo 在執行任何其他變換之前執行旋轉，因此您的 目標尺寸 和任何 錨點 都應指旋轉後的圖像方向。使用 r90、r180 或 r270 進行正交旋轉，或使用任意角度如 r45。要順時針旋轉，請使用負數如 r-45。要根據圖像的 Exif 方向標簽自動旋轉圖像，請使用 images.AutoOrient 濾鏡而不是手動旋轉。

按非正交值旋轉會增加圖像范圍以適應旋轉後的角落。對於支持 alpha 通道的格式（如 PNG 或 WebP），此產生的空白區域默認為透明。如果目標格式不支持透明（如 JPEG），或者您在處理規范中明確指定了 背景色，則會填充該空間。如果需要顏色但未在處理字符串中指定，則默認為站點配置中的 bgColor 參數。

示例

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

Original

Processed