Skip to content

FishPiOffical/fishpi-badge-rust

Repository files navigation

鱼排徽章服务

摸鱼派网站所使用的徽章服务,支持自定义图片,渐变颜色及方向等。

参考自 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,ff0000auto
way 背景渐变方向 方向字符串(topbottomleftrighttop-lefttop-rightbottom-leftbottom-right),或角度(0deg~359deg),非法值默认bottom top-left45deg
fontcolor 字体颜色(支持多色渐变) 多个6位16进制色值(用英文逗号分隔),或单独auto,不能与颜色混用 ffffff,000000auto
fontway 字体渐变方向 way bottom120deg
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编码,防止特殊字符导致解析异常。

Docker 部署

部署文档

调试与发布

执行 cargo run,访问 http://127.0.0.1:3000/gen?...

执行 cargo build --release 可发布二进制。

参考仓库

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors 3

  •  
  •  
  •