在 Python 中自定义 PowerPoint 字体

概述

Aspose.Slides for Python 允许您在运行时提供自定义字体，从而即使在主机系统未安装所需字体，演示文稿也能正确渲染。导出为 PDF 或图像时，您可以提供字体文件夹或内存中的字体数据，以保留文本布局、字形度量和排版。这使得服务器端渲染在不同环境下保持可预测，消除操作系统级别的字体依赖，并防止不希望的回退或重排。本文展示了如何注册字体来源。

Aspose.Slides 通过 load_external_font 和 load_external_fonts 方法，使用 FontsLoader 类加载以下字体：

TrueType（.ttf）和 TrueType 集合（.ttc）字体。参见 TrueType。
OpenType（.otf）字体。参见 OpenType。

加载自定义字体

Aspose.Slides 允许您在不将字体安装到系统的情况下加载演示文稿使用的字体。这会影响导出输出——如 PDF、图像及其他受支持的格式——从而使生成的文档在各环境中保持一致。字体从自定义目录加载。

指定一个或多个包含字体文件的文件夹。
调用静态 FontsLoader.load_external_fonts 方法，从这些文件夹加载字体。
加载并渲染/导出演示文稿。
调用 FontsLoader.clear_cache 清除字体缓存。

下面的代码示例演示了字体加载过程：

import aspose.slides as slides

# 定义包含自定义字体文件的文件夹。
font_folders = [ external_font_folder1, external_font_folder2 ]

# 从指定的文件夹加载自定义字体。
slides.FontsLoader.load_external_fonts(font_folders)

with slides.Presentation("sample.pptx") as presentation:
    # 使用已加载的字体渲染/导出演示文稿（例如 PDF、图像或其他格式）。
    presentation.save("output.pdf", slides.export.SaveFormat.PDF)

# 工作完成后清除字体缓存。
slides.FontsLoader.clear_cache()

注意

FontsLoader.load_external_fonts 会向字体搜索路径添加额外的文件夹，但不会改变字体初始化顺序。
字体按以下顺序初始化：

默认的操作系统字体路径。
通过 FontsLoader 加载的路径。

获取自定义字体文件夹

Aspose.Slides 提供 get_font_folders 方法来检索字体文件夹。它返回通过 load_external_fonts 添加的文件夹以及系统字体文件夹。

下面的 Python 代码展示了如何使用 get_font_folders：

import aspose.slides as slides

# 此调用返回检查字体文件的文件夹。
# 这些包括通过 load_external_fonts 方法添加的文件夹以及系统字体文件夹。
font_folders = slides.FontsLoader.get_font_folders()

为演示文稿指定自定义字体

Aspose.Slides 提供 document_level_font_sources 属性，允许您为演示文稿指定外部字体。

以下 Python 示例演示了如何使用 document_level_font_sources：

import aspose.slides as slides

with open("CustomFont1.ttf", "br") as font1_stream:
    font1_data = font1_stream.read()
    
with open("CustomFont2.ttf", "br") as font2_stream:
    font2_data = font2_stream.read()

load_options = slides.LoadOptions()
load_options.document_level_font_sources.font_folders = ["assets\\fonts", "global\\fonts"] 
load_options.document_level_font_sources.memory_fonts = [font1_data, font2_data]

with slides.Presentation("Fonts.pptx", load_options) as presentation:
    # ...
    # 对演示文稿进行操作。
    # CustomFont1、CustomFont2 以及来自 assets\fonts 和 global\fonts 文件夹（及其子文件夹）的字体可供演示文稿使用。
    # ...
    print(len(presentation.slides))

从二进制数据加载外部字体

Aspose.Slides 提供 load_external_font 方法，从二进制数据加载外部字体。

以下 Python 示例演示了从字节数组加载字体：

import aspose.slides as slides

def read_all_bytes(file_path):
    with open(file_path, "rb") as file_stream:
        file_data = file_stream.read()
    return file_data

# 从字节数组加载外部字体。
slides.FontsLoader.load_external_font(read_all_bytes("ARIALN.TTF"))
slides.FontsLoader.load_external_font(read_all_bytes("ARIALNBI.TTF"))
slides.FontsLoader.load_external_font(read_all_bytes("ARIALNI.TTF"))

try:
    with slides.Presentation() as presentation:
        # 外部字体在此演示文稿实例的整个生命周期内可用。
        print("processing")
finally:
    slides.FontsLoader.clear_cache()

常见问题

自定义字体会影响所有导出格式（PDF、PNG、SVG、HTML）吗？
是的。已连接的字体将在所有导出格式的渲染过程中使用。

自定义字体会自动嵌入生成的 PPTX 吗？
不会。为渲染注册字体并不等同于将其嵌入 PPTX。如果需要将字体随演示文稿文件一起携带，必须使用显式的嵌入功能。

当自定义字体缺少某些字形时，能否控制回退行为？
可以。配置字体替代、替换规则和回退集可精确定义在请求的字形缺失时使用哪种字体。

能否在 Linux/Docker 容器中使用字体而无需系统范围安装？
可以。指向您自己的字体文件夹或从字节数组加载字体即可，这样就消除了容器镜像对系统字体目录的依赖。

关于许可证——是否可以在没有限制的情况下嵌入任何自定义字体？
您必须自行负责字体许可证的合规性。许可证条款各不相同，有些禁止嵌入或商业使用。分发输出前请始终查阅字体的最终用户许可协议（EULA）。

使用 Python 自定义演示文稿的默认字体