摸鱼派网站所使用的徽章服务,支持自定义图片,渐变颜色及方向等。
参考自 unv-shield ,基于 Rust 重写并增加支持渐变颜色指定与 Gif 支援。
| 参数名 | 说明 | 允许值/范围 | 示例值 |
|---|---|---|---|
| ver | 接口版本号 | 字符串(建议数字或版本号格式) | 0.1 |
| scale | 缩放比例 | 数字(整数或小数,建议范围0.1~10) | 0.79 |
| txt | 显示文本 | 任意字符串(建议URL编码) | 00后tes |
| url | 图片地址 | 合法URL字符串 | https://file.fishpi.cn/2024/03/zhuanquanquan-3e16db97.gif |
| backcolor | 背景色(支持多色渐变) | 多个6位16进制色值(用英文逗号分隔),或单独auto,不能与颜色混用 | ffffff,000000,ffa500,ff0000 或 auto |
| way | 背景渐变方向 | 方向字符串(top、bottom、left、right、top-left、top-right、bottom-left、bottom-right),或角度(0deg~359deg),非法值默认bottom | top-left 或 45deg |
| fontcolor | 字体颜色(支持多色渐变) | 多个6位16进制色值(用英文逗号分隔),或单独auto,不能与颜色混用 | ffffff,000000 或 auto |
| fontway | 字体渐变方向 | 同way | bottom 或 120deg |
| shadow | 背景阴影浓度 | 数字(整数或小数,建议范围0~1,非法值默认0) | 0.8 |
| anime | 动画时间(秒) | 数字(整数或小数,建议范围0.1~10,非法值默认0) | 5 |
| size | 徽章尺寸 | 整数(建议范围16~512) | 32 |
| border | 边距和阴影扩散范围。 | 整数(建议范围0~size/4) | 3 |
| barlen | 徽章的文字条的长度。 | 整数,默认由文字长度决定 | 100 |
| fontsize | 字体大小 | 整数(建议范围12~48),默认为 15 | 30 |
| barradius | 文字条圆角大小 | 整数(建议范围0~size/2), 默认为 size 的一半 | 15 |
- backcolor/fontcolor:
- 允许多个6位16进制色值(如
ffffff,000000),用英文逗号分隔。 - 允许单独
auto,但不能与颜色混用(如auto,ffffff非法)。 - shadow/anime:
- 仅允许数字(整数或小数),非法值自动转为
0。 - way/fontway:
- 允许方向字符串或角度(如
45deg),非法值自动转为bottom。 - 其它参数:
- 建议做URL编码,防止特殊字符导致解析异常。
执行 cargo run,访问 http://127.0.0.1:3000/gen?...
执行 cargo build --release 可发布二进制。