这个 ImageFont
模块定义具有相同名称的类。此类的实例存储位图字体,并与 PIL.ImageDraw.Draw.text()
方法。
PIL使用自己的字体文件格式来存储位图字体。你可以使用 pilfont 实用程序将bdf和pcf字体描述符(x窗口字体格式)转换为此格式。
从1.1.4版开始,PIL可以配置为支持TrueType和OpenType字体(以及FreeType库支持的其他字体格式)。对于早期版本,TrueType支持仅作为IMtoolkit包的一部分提供
from PIL import ImageFont, ImageDraw
draw = ImageDraw.Draw(image)
# use a bitmap font
font = ImageFont.load("arial.pil")
draw.text((10, 10), "hello", font=font)
# use a truetype font
font = ImageFont.truetype("arial.ttf", 15)
draw.text((10, 25), "world", font=font)
PIL.ImageFont.
load
(filename)[源代码]¶加载字体文件。此函数从给定的位图字体文件加载字体对象,并返回相应的字体对象。
参数: | filename -- 字体文件的名称。 |
---|---|
返回: | 字体对象。 |
引发: | IOError -- 如果无法读取文件。 |
PIL.ImageFont.
load_path
(filename)[源代码]¶加载字体文件。等同于 load()
,但沿python路径搜索位图字体。
参数: | filename -- 字体文件的名称。 |
---|---|
返回: | 字体对象。 |
引发: | IOError -- 如果无法读取文件。 |
PIL.ImageFont.
truetype
(font=None, size=10, index=0, encoding='', layout_engine=None)[源代码]¶从文件或类似文件的对象加载TrueType或OpenType字体,然后创建字体对象。此函数从给定的文件或类似文件的对象加载字体对象,并为给定大小的字体创建字体对象。
此功能需要“Imagingft”服务。
参数: |
|
---|---|
返回: | 字体对象。 |
引发: | IOError -- 如果无法读取文件。 |
PIL.ImageFont.ImageFont.
getsize
(text, direction=None, features=[], language=None)¶如果以提供方向、功能和语言的字体呈现,则返回给定文本的宽度和高度(以像素为单位)。
参数: |
|
---|---|
返回: | (宽度,高度) |
PIL.ImageFont.ImageFont.
getmask
(text, mode='', direction=None, features=[], language=None)¶为文本创建位图。
如果字体使用反锯齿,位图应具有模式“L”,并使用最大值255。否则,应具有模式“1”。
参数: |
|
---|---|
返回: | 内部PIL存储内存实例由 |