ImageFont 模块

这个 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”服务。

参数
  • font -- 包含TrueType字体的文件名或类似文件的对象。在Windows下,如果在此文件名中找不到该文件,加载程序也会在Windows中查找 fonts/ 目录。

  • size -- 请求的大小,以磅为单位。

  • index -- 要加载的字体(默认为第一个可用的字体)。

  • encoding -- 要使用哪种字体编码(默认为Unicode)。常见的编码有“unic”(Unicode)、“symb”(Microsoft符号)、“adob”(Adobe标准)、“adbe”(Adobe专家)和“armn”(Apple Roman)。有关详细信息,请参阅freetype文档。

  • layout_engine -- 要使用的布局引擎(如果可用): ImageFont.LAYOUT_BASICImageFont.LAYOUT_RAQM.

返回

字体对象。

引发

IOError -- 如果无法读取文件。

PIL.ImageFont.load_default()[源代码]

加载“Better than Nothing”默认字体。

1.1.4 新版功能.

返回

字体对象。

方法

PIL.ImageFont.ImageFont.getsize(text, direction=None, features=[], language=None)

如果以提供方向、功能和语言的字体呈现,则返回给定文本的宽度和高度(以像素为单位)。

参数
  • text -- 要测量的文本。

  • direction -- 文本的方向。它可以是“rtl”(从右到左)、“ltr”(从左到右)或“ttb”(从上到下)。需要libraqm。…添加的版本:4.2.0

  • features -- 文本布局期间要使用的OpenType字体功能列表。这通常用于打开默认情况下未启用的可选字体功能,例如“dlig”或“ss01”,但也可用于关闭默认字体功能,例如“-liga”禁用连字,或“-kern”禁用紧排。要获取所有支持的功能,请参阅https://docs.microsoft.com/en-us/typography/openttype/spec/featurelist requires libraqm。…添加的版本:4.2.0

  • language -- 文本的语言。不同的语言可以使用不同的字形或连字。此参数告诉文本使用哪种语言的字体,并根据需要应用正确的替换(如果可用)。应该是一个 BCP 47 language code <https://www.w3.org/International/articles/language-tags/> 需要libraqm。我是说…版本已添加::6.0.0

返回

(宽度,高度)

PIL.ImageFont.ImageFont.getmask(text, mode='', direction=None, features=[], language=None)

为文本创建位图。

如果字体使用反锯齿,位图应具有模式“L”,并使用最大值255。否则,应具有模式“1”。

参数
  • text -- 要渲染的文本。

  • mode -- 某些图形驱动程序使用它来指示驱动程序喜欢哪种模式;如果为空,渲染器可能返回任一模式。请注意,模式始终是字符串,以简化C级实现。…添加的版本:1.1.5

  • direction -- 文本的方向。它可以是“rtl”(从右到左)、“ltr”(从左到右)或“ttb”(从上到下)。需要libraqm。…添加的版本:4.2.0

  • features -- 文本布局期间要使用的OpenType字体功能列表。这通常用于打开默认情况下未启用的可选字体功能,例如“dlig”或“ss01”,但也可用于关闭默认字体功能,例如“-liga”禁用连字,或“-kern”禁用紧排。要获取所有支持的功能,请参阅https://docs.microsoft.com/en-us/typography/openttype/spec/featurelist requires libraqm。…添加的版本:4.2.0

  • language -- 文本的语言。不同的语言可以使用不同的字形或连字。此参数告诉文本使用哪种语言的字体,并根据需要应用正确的替换(如果可用)。应该是一个 BCP 47 language code <https://www.w3.org/International/articles/language-tags/> 需要libraqm。我是说…版本已添加::6.0.0

返回

内部PIL存储内存实例由 PIL.Image.core 接口模块。

class PIL.ImageFont.FreeTypeFont(font=None, size=10, index=0, encoding='', layout_engine=None)[源代码]

freetype字体包装(需要“imagingft”服务)

font_variant(font=None, size=None, index=None, encoding=None, layout_engine=None)[源代码]

创建此FreeTypeFont对象的副本,使用任何指定的参数覆盖设置。

参数与用于初始化此对象的参数相同。

返回

FreeTypeFont对象。