在 .NET 中自定义 PowerPoint 字体

概述

Aspose.Slides 允许您在演示文稿中使用自定义字体，而无需在操作系统上安装它们。您可以从自定义文件夹加载字体，通过文档级字体源为特定演示文稿提供字体，或直接从二进制数据加载外部字体。

加载的字体将在演示文稿渲染或导出时使用，例如导出为 PDF、图像以及其他受支持的格式。这有助于在不同环境中保持演示文稿输出的一致性。本文还说明了如何检查 Aspose.Slides 使用的字体文件夹以及在使用外部字体后如何清除字体缓存。

为渲染注册自定义字体与将字体嵌入 PPTX 文件是分开的。如果必须将字体存储在演示文稿本身内，请显式使用字体嵌入功能。

演示文稿主题可以为各个书写系统引用不同的字体族。这些映射仅存储字体名称，不会安装或加载字体文件。请参阅 脚本特定主题字体 以管理映射，并使用下面的加载选项使引用的字体可用于一致的渲染。

加载自定义字体

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

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

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

using Aspose.Slides;
using Aspose.Slides.Export;

// 定义包含自定义字体文件的文件夹。
string[] fontFolders = { @"C:\MyFonts", @"D:\Fonts" };

// 从指定的文件夹加载自定义字体。
FontsLoader.LoadExternalFonts(fontFolders);

using Presentation presentation = new Presentation("sample.pptx");

// 使用已加载的字体渲染/导出演示文稿（例如，导出为 PDF、图像或其他格式）。
presentation.Save("output.pdf", SaveFormat.Pdf);

// 完成工作后清除字体缓存。
FontsLoader.ClearCache();

获取自定义字体文件夹

Aspose.Slides 提供了 GetFontFolders 方法，帮助您查找字体文件夹。此方法返回通过 LoadExternalFonts 方法添加的文件夹以及系统字体文件夹。

下面的 C# 代码展示了如何使用 GetFontFolders：

using Aspose.Slides;

// 此行输出检查字体文件的文件夹。
// 这些文件夹是通过 LoadExternalFonts 方法添加的，以及系统字体文件夹。
string[] fontFolders = FontsLoader.GetFontFolders();

指定演示文稿使用的自定义字体

Aspose.Slides 提供了 DocumentLevelFontSources 属性，允许您为演示文稿指定将要使用的外部字体。

下面的 C# 代码展示了如何使用 DocumentLevelFontSources 属性：

using Aspose.Slides;

byte[] memoryFont1 = File.ReadAllBytes("customfonts\\CustomFont1.ttf");
byte[] memoryFont2 = File.ReadAllBytes("customfonts\\CustomFont2.ttf");

LoadOptions loadOptions = new LoadOptions();
loadOptions.DocumentLevelFontSources.FontFolders = new string[] { "assets\\fonts", "global\\fonts" };
loadOptions.DocumentLevelFontSources.MemoryFonts = new byte[][] { memoryFont1, memoryFont2 };
using (IPresentation presentation = new Presentation("MyPresentation.pptx", loadOptions))
{
    // 对演示文稿进行操作
    // CustomFont1、CustomFont2 和来自 assets\fonts 与 global\fonts 文件夹及其子文件夹的字体可用于演示文稿
}

在外部管理字体

Aspose.Slides 提供了 LoadExternalFont(byte[] data) 方法，允许您从二进制数据加载外部字体。

下面的 C# 代码演示了字节数组字体加载过程：

using Aspose.Slides;

FontsLoader.LoadExternalFont(File.ReadAllBytes("ARIALN.TTF"));
FontsLoader.LoadExternalFont(File.ReadAllBytes("ARIALNBI.TTF"));
FontsLoader.LoadExternalFont(File.ReadAllBytes("ARIALNI.TTF"));

try
{
    using (Presentation pres = new Presentation(""))
    {
        // 在演示文稿生命周期内加载的外部字体
    }
}
finally
{
    FontsLoader.ClearCache();
}

若希望在导出时让已注册的匹配字体优先，而不移除嵌入的字体，请参阅 首选已注册字体而非嵌入字体（.NET 26.11 或更高）。

常见问题

自定义字体会影响所有格式（PDF、PNG、SVG、HTML）的导出吗？

是的。已连接的字体会被渲染器在所有导出格式中使用。

自定义字体会自动嵌入生成的 PPTX 吗？

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

当自定义字体缺少某些字形时，我可以控制回退行为吗？

可以。配置 font substitution、replacement rules 和 fallback sets 可精确定义在请求的字形缺失时使用哪个字体。

我能在 Linux/Docker 容器中使用字体而无需在系统范围内安装吗？

可以。指向您自己的字体文件夹或从字节数组加载字体。这可以消除容器镜像中对系统字体目录的任何依赖。

Note for Linux/Docker: 在调用 FontsLoader.LoadExternalFonts 时，请确保 directories 数组中的每个条目都包含指向已存在目录的非空路径。如果用于构造字体路径的环境变量未定义或为空，Aspose.Slides 可能会尝试将空值解析为完整路径，从而导致 System.ArgumentException。

关于许可证——我可以在不受限制的情况下嵌入任何自定义字体吗？

您需要自行负责字体许可证的合规性。许可证条款各不相同，有的禁止嵌入或商业使用。分发输出之前，请务必查阅字体的最终用户授权协议（EULA）。

Related features

在 .NET 中指定默认演示文稿字体