https://github.com/laojianzi/mdavatar
MDAvatar 可以根据字符串生成单字符头像，高度自定义，支持中文头像、圆形头像
https://github.com/laojianzi/mdavatar
avatar avatar-generator avatars go go-avatar golang image md-avatar mdavatar
Last synced: 6 months ago
JSON representation
MDAvatar 可以根据字符串生成单字符头像，高度自定义，支持中文头像、圆形头像
- Host: GitHub
- URL: https://github.com/laojianzi/mdavatar
- Owner: laojianzi
- License: mit
- Created: 2020-11-22T14:35:43.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2023-03-06T22:02:40.000Z (over 2 years ago)
- Last Synced: 2025-04-01T20:51:33.660Z (7 months ago)
- Topics: avatar, avatar-generator, avatars, go, go-avatar, golang, image, md-avatar, mdavatar
- Language: Go
- Homepage: https://github.com/laojianzi/mdavatar
- Size: 16.7 MB
- Stars: 6
- Watchers: 1
- Forks: 1
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# MDAvatar
MDAvatar 可以根据字符串生成单字符头像，并且可以高度自定义，支持生成中文头像，圆形头像
## Features
- 自定义头像 text 处理方式
- 自定义图片 size
- 自定义字体
- 自带默认字体，字体颜色为白色，暂不支持自定义字体颜色
- 当字体设置支持中文时，头像 text 也可以渲染中文
- 自定义头像背景颜色列表
- 自带默认颜色列表 Material Design Colors
- 当没有设置 background 时，默认是随机获取颜色列表中的一种 RGBA
- 自定义背景
- 当设置 background 后，不会启用随机颜色作为 background
- background 也是一种 RGBA
- 支持多种图形生成
- 正方形，默认
- 圆形
## Installation
- Require `go` version >= `1.13`
- Require `go mod` enable
```bash
$ go get -u github.com/laojianzi/mdavatar
```
## Examples
```go
package main
import (
"fmt"
"image/png"
"log"
"os"
"time"
"github.com/laojianzi/mdavatar"
)
func main() {
avatar, err := mdavatar.New("MDAvatar").Build()
if err != nil {
log.Fatal(err)
}
filename := fmt.Sprintf("out-%d.png", time.Now().Unix())
file, err := os.Create(filename)
if err != nil {
log.Fatal(err)
}
if err := png.Encode(file, avatar); err != nil {
log.Fatal(err)
}
}
```
## TODO
- [ ] 支持 cli (生成 png/jpg)
- [ ] 支持自定义形状 (圆形、椭圆形、方形 ...)
- [ ] 支持多种返回形式 (HTTP、Base64、WriteToFile ...)
## Prior Art
项目参考了一些现有的思路或者实现等
- [mdclub](https://github.com/zdhxiong/mdclub/tree/master/src/Vendor)
- [Michael Okoko](https://blog.logrocket.com/working-with-go-images/)
## License
This project is licensed under the MIT License.
License can be found [here](https://github.com/laojianzi/mdavatar/blob/master/LICENSE).