参数总览
颜色一律为十六进制,支持 3、4、6、8 位写法;4 位和 8 位的首段为不透明度,如
80000000 为 50% 透明的黑色。
百分比在 URL 中需把 % 写作 %25。
翻转
https://demo.bitiful.com/girl.jpeg?flip=h 翻转在自动转正和旋转之后执行。mirror 是 flip=h 的简写。
边框与内边距
https://demo.bitiful.com/girl.jpeg?border=10,ff0000 https://demo.bitiful.com/girl.jpeg?pad=40&bg=f5f5f5- 边框和内边距都向外扩展画布,图片本身的内容不会被遮挡。
- 内边距的颜色取
bg。未指定bg时,带透明通道的图片补透明,其余补白色。
纯色块
在图片上绘制一个矩形色块,位于水印之下。常与文字水印搭配,做成标题栏或信息条: https://demo.bitiful.com/girl.jpeg?box=0,85%25,100%25,15%25&box-color=a0000000&txt=标题文字&txt-pos=0.5,0.96box 的坐标按处理后的图片(缩放、旋转之后)计算,超出图片的部分会被裁掉。
圆角与圆形
https://demo.bitiful.com/girl.jpeg?mask=corners&corner-radius=24&fmt=png https://example.com/avatar.jpg?w=200&h=200&mask=ellipse&fmt=pngmask=ellipse取图片的内切椭圆;图片为正方形时即圆形。corner-radius的百分比按图片短边计算,50%即最大圆角。- 遮罩之外的区域为透明。
执行顺序
各项处理按以下顺序执行: 缩放、旋转 → 翻转 → 色块 → 水印 → 内边距与边框 → 遮罩 因此:水印可以压在色块上;边框和内边距不会影响水印的定位;遮罩最后执行,会把边框的外角一起裁圆。适用范围
- 动图:色块与遮罩逐帧生效。
- HDR 图片:支持,输出仍是 HDR。
- 视频:色块可用;遮罩不支持,会返回错误。