Pygame 官方文档 - pygame.freetype

pygame.freetype

增强的pygame模块，用于加载和呈现计算机字体
pygame.freetype.get_error - 返回最新的FreeType错误
pygame.freetype.get_version - 返回FreeType版本
pygame.freetype.init - 初始化基础FreeType库。
pygame.freetype.quit - 关闭底层的FreeType库。
pygame.freetype.was_init - 返回是否初始化FreeType库。
pygame.freetype.get_cache_size - 返回字形大小
pygame.freetype.get_default_resolution - 以每英寸点数返回默认像素大小
pygame.freetype.set_default_resolution - 为模块设置默认像素大小，以每英寸点数为单位
pygame.freetype.SysFont - 从系统字体创建一个Font对象
pygame.freetype.get_default_font - 获取默认字体的文件名
pygame.freetype.Font - 从支持的字体文件创建一个新的Font实例。

        pygame.freetype模块是pygame.font模块的替代品，用于加载和呈现字体。它具有原始的所有功能，以及许多新功能。然而，它绝对不依赖于SDL_ttf库。它直接在FreeType 2库上实现。 pygame.freetype模块本身不与pygame.font模块向后兼容。相反，使用pygame.ftfont模块作为pygame.font模块的替代品。
        FreeType支持的所有字体文件格式都可以由pygame.freetype呈现，即TTF，Type1，CFF，OpenType，SFNT，PCF，FNT，BDF，PFR和Type42字体。所有具有UTF-32码点的字形都是可访问的（参见Font.ucs4）。
        大多数字体工作都是使用Font实例完成的。模块本身只有初始化和创建Font对象的程序。您可以使用SysFont()函数从系统加载字体。
        可以使用位图字体作为额外支持。可以列出可用的位图大小（请参阅Font.get_sizes()）。对于仅位图字体Font可以为您设置大小（请参阅Font.size属性）。
现在，未定义的字符代码将替换为.notdef（not defined未定义）字符。如何处理未定义的代码可能在将来的版本中可配置。
        Pygame带有内置的默认字体。通过将None作为字体名称传递给Font构造函数，可以始终访问它。
        pygame.freetype.Font可用的额外渲染功能直接表面渲染（参见Font.render_to()），字符字距调整（参见Font.kerning），垂直布局（参见Font.vertical），旋转渲染文本（参见Font.rotation）和strong样式（参见Font.strong）。某些属性是可配置的，例如strong
样式强度（请参阅Font.strength）和下划线定位（请参阅Font.underline_adjustment）。文本可以通过文本框的右上角或文本基线定位（请参阅Font.origin）。最后，可以单独调整字体的垂直和水平尺寸（请参阅Font.size）。 pygame.examples.freetype_misc示例显示了这些正在使用的功能。
pygame包在加载时不会自动导入freetype。必须明确导入此模块才能使用。

import pygame
import pygame.freetype

freetype模块是pygame 1.9.2中的新增功能
 

pygame.freetype.get_error() ↶

返回最新的FreeType错误
get_error() -> str
返回FreeType2库中发生的最后一个错误的描述，如果没有错误，则返回None。
搜索pygame.freetype.get_error的示例

pygame.freetype.get_version() ↶

返回FreeType版本
get_version() -> (int, int, int)
返回此模块使用的用于FreeType库的版本。
请注意，freetype模块依赖于FreeType 2库。它不会使用原始的FreeType 1.0进行编译。因此，元组的第一个元素将始终为“2”。
搜索pygame.freetype.get_version的示例

pygame.freetype.init() ↶

初始化基础FreeType库。
init(cache_size=64, resolution=72)
此函数初始化基础FreeType库，必须在尝试使用freetype模块的任何函数之前调用它。
但是，如果已导入freetype模块，则pygame.init()初始化所有导入的pygame模块将自动调用此函数。 多次调用此函数是安全的。
（可选）您可以为Glyph缓存指定默认的cache_size：模块在任何给定时间缓存的最大字形数。 超出小的值将自动调整性能。 还可以给出默认像素分辨率（以每英寸点数为单位）来调整字体缩放。
搜索pygame.freetype.init的示例

pygame.freetype.quit() ↶

关闭底层的FreeType库。
qiut()
此函数关闭freetype模块。 调用此函数后，您不应调用与freetype模块相关的任何类，方法或函数，因为它们可能会失败或可能产生不可预测的结果。 即使模块尚未初始化，也可以安全地调用此函数。
搜索pygame.freetype.quit的示例

pygame.freetype.was_init() ↶

返回是否初始化FreeType库。
was_init() -> bool
返回是否初始化FreeType库。
搜索pygame.freetype.was_init的示例

pygame.freetype.get_cache_size() ↶

返回字形大小
get_cache_size() -> long
见pygame.freetype.init()
搜索pygame.freetype.get_cache_size的示例

pygame.freetype.get_default_resolution() ↶

以每英寸点数返回默认像素大小
set_default_resolution([resolution])
设置模块的默认像素大小（以每英寸点数为单位）。如果省略可选参数或为零，则分辨率将重置为72 DPI。
搜索pygame.freetype.get_default_resolution的示例

pygame.freetype.set_default_resolution() ↶

为模块设置默认像素大小，以每英寸点数为单位
SysFont(name, size, bold=False, italic=False) -> Font
返回从系统字体加载的新Font对象。 该字体将匹配请求的bold粗体和italic斜体标志。 如果找不到合适的系统字体，则返回默认的Pygame。 字体名称可以是逗号分隔的要搜索的字体名称列表。
搜索pygame.freetype.set_default_resolution的示例

pygame.freetype.SysFont() ↶

从系统字体创建一个Font对象
SysFont(name, size, bold=False, italic=False) -> Font
返回从系统字体加载的新Font对象。 该字体将匹配请求的bold粗体和italic斜体标志。 如果找不到合适的系统字体，则返回默认的Pygame。 字体名称可以是逗号分隔的要搜索的字体名称列表。
搜索pygame.freetype.SysFont的示例

pygame.freetype.get_default_font() ↶

获取默认字体的文件名
get_default_font() -> string
返回默认pygame字体的文件名。 这不是文件的完整路径。 该文件通常与字体模块位于同一目录中，但也可以捆绑在单独的存档中。
搜索pygame.freetype.get_default_font的示例