跳到正文
控制台

图片缩放

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

参数说明

参数含义默认值取值
w目标宽度–像素(至多 10000),或百分比如 50%
h目标高度–同上
dpr额外缩放倍率,目标宽高再乘以该值1大于 0,至多 10
mode缩放模式,见下表cropcrop / clip / fill / scale / adapt
pos裁切时保留的位置,见下文center预设方位、自定义坐标或智能裁切
fill补边方式,仅 mode=fill 时生效solidsolid / blur / dominant / auto
bg背景色,用于补边白色十六进制颜色

URL 中 % 需写作 %25,如 w=50%25。

缩放模式

mode行为输出尺寸
crop等比缩放后裁掉多余部分恰为 w × h
clip等比缩放到 w × h 的框内,不裁切不超过 w × h
fill等比缩放到框内,再补边至目标尺寸恰为 w × h
scale拉伸到目标尺寸,不保持宽高比恰为 w × h
adapt自动选择:裁切损失不大时按 crop,否则按 fill恰为 w × h
  • 只指定 w 或 h 其中之一时,始终等比缩放。
  • 同时指定 w 和 h 且未指定 mode 时,按 crop 处理。

补边方式

mode=fill 时,fill 决定留白区域的填充内容:

fill效果
solid用 bg 指定的纯色
blur用原图放大模糊后的画面作背景
dominant用原图的主色
auto内容感知:边缘是纯色或平滑渐变时沿边缘自然延伸,否则使用模糊背景

裁切位置

mode=crop 时,pos 决定保留画面的哪一部分。

写法取值
九宫格top-left、top、top-right、left、center、right、bottom-left、bottom、bottom-right
居中偏移top-center、bottom-center、left-center、right-center:在居中的基础上向该方向偏移
自定义坐标x,y,取值 0 ~ 1 或 0% ~ 100%,如 0.25,0.75
智能裁切smart(face、auto 等价)

智能裁切

pos=smart 会识别画面中的人脸、人体、猫狗和显著主体,自动选择最能完整保留它们的裁切窗口;有人脸时会让人脸落在画面偏上的自然位置。

  • 仅当原图与目标的宽高比相差超过 25% 时才进行识别,否则居中裁切。
  • 动图不做识别,居中裁切。

头像、商品图、信息流封面等需要把不同比例的图片裁成统一比例的场景,推荐使用 pos=smart。

使用示例

演示:只指定宽度 w=200,等比缩放
演示:只指定高度 h=200,等比缩放
演示:同时指定 w=200 & h=200(默认 mode=crop,pos=center)
演示:w=200 & h=200,mode=clip 等比缩入框内
演示:w=200 & h=200,dpr=0.5 输出 100 × 100
演示:w=200 & h=200,pos=top 保留上部
演示:w=200 & h=200,pos=bottom 保留下部
演示:w=200 & h=200,pos=smart 智能裁切
演示:w=300 & h=200,mode=fill 并用模糊背景补边