Skip to main content

参数总览

颜色一律为十六进制,支持 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.96 box 的坐标按处理后的图片(缩放、旋转之后)计算,超出图片的部分会被裁掉。

圆角与圆形

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=png
  • mask=ellipse 取图片的内切椭圆;图片为正方形时即圆形。
  • corner-radius 的百分比按图片短边计算,50% 即最大圆角。
  • 遮罩之外的区域为透明。
要保留透明效果,需输出支持透明的格式(fmt=png、webp 或 avif)。输出 JPEG 时,透明区域会被 bg 填充,默认为白色。

执行顺序

各项处理按以下顺序执行: 缩放、旋转 → 翻转 → 色块 → 水印 → 内边距与边框 → 遮罩 因此:水印可以压在色块上;边框和内边距不会影响水印的定位;遮罩最后执行,会把边框的外角一起裁圆。

适用范围

  • 动图:色块与遮罩逐帧生效。
  • HDR 图片:支持,输出仍是 HDR。
  • 视频:色块可用;遮罩不支持,会返回错误。