跳到正文
控制台

图形与画布

参数总览

参数含义取值
flip翻转h 水平 / v 垂直 / hv 两者
border边框,格式 宽度,颜色宽度为像素或百分比(按图片短边)
pad四边内边距像素,0 ~ 4000
pad-left / pad-top / pad-right / pad-bottom单边内边距像素,0 ~ 4000
box纯色块,格式 x,y,w,h像素或百分比(按图片宽高)
box-color色块颜色,默认黑色十六进制颜色,可半透明
box-radius色块圆角像素或百分比(按色块短边)
mask外形遮罩corners 圆角矩形 / ellipse 椭圆
corner-radius圆角半径,mask=corners 时必填单个值,或 左上,右上,右下,左下

颜色一律为十六进制,支持 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。
  • 视频:色块可用;遮罩不支持,会返回错误。