pyglet.font
加载字体。
Pyglet将自动加载任何系统安装的字体。您可以使用以下命令添加其他字体(例如,从您的程序资源) add_file()
或 add_directory()
。这些字体的可用方式与系统安装的字体相同:
from pyglet import font
font.add_file('action_man.ttf')
action_man = font.load('Action Man', 16)
# or
from pyglet import resource
resource.add_font('action_man.ttf')
action_man = font.load('Action Man')
请参阅 pyglet.font.base
模块,以获取有关此包使用的基类的文档。
- add_directory(directory)
将字体目录添加到pyglet的搜索路径。
此函数简单地调用
pyglet.font.add_file()
对于每个具有.ttf
给定目录中的扩展名。不搜索子目录。- 参数:
- dir应力
包含字体文件的目录。
- add_file(font: str | BinaryIO)
将字体添加到pyglet的搜索路径。
为了加载系统上未安装的字体,您必须调用此方法来告诉pyglet它存在。您可以提供文件名或任何类似文件的对象。
字体格式取决于平台,但通常是包含单个字体的TrueType字体文件。请注意,要使用通过此方法添加的字体,应将Face名称(而不是文件名)传递给 :meth:
pyglet.font.load()
或通常指定字体的任何其他位置。- 参数:
- font字符串或类似文件的对象
要从中加载字体的文件名或类似文件的对象。
- add_user_font(font: UserDefinedFontBase)
添加用户创建的自定义字体。
需要对字体对象应用强引用,否则侏儒以后可能找不到该字体。
- 参数:
- font~pyglet.font.user.UserDefinedFont
用户定义的字体类实例。
- load(name: str | Iterable[str] | None = None, size: float | None = None, bold: bool = False, italic: bool = False, stretch: bool = False, dpi: float | None = None)
加载用于呈现的字体。
- 参数:
- name字符串或字符串列表
字体系列,例如,“Times New Roman”。如果提供了名称列表,则使用与已知字体匹配的第一个名称。如果没有与该名称(S)匹配的字体,则使用默认字体。在pyglet1.1中,这个名字可以省略。
- size浮动
字体大小,以磅为单位。返回的字体可能完全匹配,也可能是最接近的可用字体。
- bold布尔尔
如果为True,则返回一个粗体变量(如果给定族和大小存在)。
- italic布尔尔
如果为True,则返回斜体变量(如果给定族和大小存在斜体变量)。
- dpi浮动
显示设备的假定分辨率,用于确定字体的像素大小。默认为96。
- 返回类型:
Font