跳到正文
控制台

自定义裁剪

以下示例的原图均为:https://demo.bitiful.com/girl.jpeg

参数说明

参数含义格式
rect裁剪区域x,y,w,h,四个值用半角逗号分隔
分量含义取值
x、y区域左上角的坐标像素或百分比;负数表示从右边缘、下边缘往回量
w、h区域的宽、高像素或百分比,必须大于 0
  • 百分比以原图宽高为基准,URL 中 % 需写作 %25,如 rect=10%25,10%25,80%25,80%25。
  • 负数坐标让你无需知道原图尺寸就能取到右侧或底部的区域:rect=-900,-900,900,900 即右下角 900 × 900。
  • 区域超出图片边界的部分会被截掉,输出相应变小。
  • rect 先于 w、h 执行:先裁剪,再缩放。
  • HDR 图片裁剪后仍是 HDR。

rect 用于按坐标精确裁剪。如需按目标宽高自动裁切并保留人脸或主体,请使用 图片缩放 中的 pos=smart。

使用示例

演示:从左上角截取 500 宽、500 高的区域
演示:从左上角截取 1000 × 1000 的区域,再缩放到 500 宽

rect 的优先级高于 w 和 h,处理分两步:

  1. 按 rect=0,0,1000,1000 截取原图左上角 1000 × 1000 的区域;
  2. 按 w=500 把截取结果等比缩放到 500 宽。

URL:https://demo.bitiful.com/girl.jpeg? rect=0,0,1000,1000 & w=500

裁剪后缩放