python_avatars

Python中的头像库

目录

1. 特征
2. 安装
3. 用法
   • 创建自己的头像
   • 创建一个随机头像
   • 自定义衬衫文字
   • 扩大图书馆
4. 执照
5. 致谢

特征

• 高度可定制。设计你自己的衣服、发型、眼睛......并将它们添加到库中，将 svg 文件复制到一个目录中
• 香草蟒。无需外部库
• 该库包含一些衣服、头发和皮肤的颜色，并支持使用十六进制编码的用户定义颜色
• 纯 SVG
• 随机头像生成

安装

使用来自 PyPi（最新稳定版本）的 pip：

pip install python-avatars

使用来自此存储库的 pip（可能不稳定！）：

git clone https://github.com/ibonn/python_avatars.git python_avatars
cd python_avatars
pip install -e .

用法

创建自己的头像

import python_avatars as pa

my_avatar = pa.Avatar(
    style=pa.AvatarStyle.CIRCLE,
    background_color=pa.BackgroundColor.BLACK,
    top=pa.HairType.STRAIGHT_2,
    eyebrows=pa.EyebrowType.DEFAULT_NATURAL,
    eyes=pa.EyeType.DEFAULT,
    nose=pa.NoseType.DEFAULT,
    mouth=pa.MouthType.EATING,
    facial_hair=pa.FacialHairType.NONE,
    # You can use hex colors on any color attribute...
    skin_color="#00FFFF",
    # Or you can use the colors provided by the library
    hair_color=pa.HairColor.BLACK,
    accessory=pa.AccessoryType.NONE,
    clothing=pa.ClothingType.HOODIE,
    clothing_color=pa.ClothingColor.HEATHER
)

# Save to a file
my_avatar.render("my_avatar.svg")

创建一个随机头像

import python_avatars as pa

# Completely random avatar
random_avatar_1 = pa.Avatar.random()

# Completely random avatar except for the hat
random_avatar_2 = pa.Avatar.random(top=pa.HatType.HAT)  # More attributes can stay fixed

# Fixed avatar but random clothes
random_avatar_3 = pa.Avatar(
    style=pa.AvatarStyle.CIRCLE,
    hair_color=pa.HairColor.BLACK,
    accessory=pa.AccessoryType.NONE,
    clothing=pa.ClothingType.pick_random(), # The clothes are chosen randomly
)

自定义衬衫文字

使用图形衬衫时， - ClothingType.GRAPHIC - 如果需要，您可以设置自定义文本。

import python_avatars as pa

pa.Avatar(
    style=pa.AvatarStyle.CIRCLE,
    background_color='#FF00FF',
    # Choose graphic shirt
    clothing=pa.ClothingType.GRAPHIC_SHIRT,
    clothing_color=pa.ClothingColor.GRAY_02,
    # Important to choose this as shirt_graphic, otherwise shirt_text will be ignored
    shirt_graphic=pa.ClothingGraphic.CUSTOM_TEXT,
    shirt_text='Chess'
).render("avatar_text.svg")

将输出文件avatar_text.svg：

扩大图书馆

假设您有一个名为suit.svg的文件 ，看起来像这样

您只需运行即可将其添加到库中

from python_avatars import install_part

# Install the new part
install_part("suit.svg", pa.ClothingType)

然后使用它

suit_avatar = pa.Avatar.random(
    clothing=pa.ClothingType.SUIT
)

suit_avatar.render("suit_avatar.svg")

输出文件suit_avatar.svg，看起来像这样

新添加的值的名称将与转换为大写的 svg 文件的名称完全相同，用下划线替换所有非字母数字字符并删除所有前导数字。

卸载已安装的部分就像安装它一样简单

from python_avatars import uninstall_part, ClothingType

uninstall_part(ClothingType.SUIT, confirm=False)    # confirm=False will not prompt for confirmation

执照

该项目在 MIT 许可下获得许可 - 请参阅LICENSE 文件了解详细信息

致谢

• Pablo Stanley设计的头像( https://avataaars.com/ )
• 来自 blush.design 的附加头像部件，由Pablo Stanley ( https://blush.design/ )设计