在 .NET 中自定义 PowerPoint 字体

本页内容简介

使用 Aspose.Slides for .NET 自定义 PowerPoint 幻灯片中的字体，以确保您的演示文稿在任何设备上都保持清晰一致。

概述

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

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

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

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

Note

Aspose Slides 允许您使用 FontsLoader.LoadExternalFonts 方法加载以下字体：

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

加载自定义字体

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

指定包含字体文件的一个或多个文件夹。
调用静态 FontsLoader.LoadExternalFonts 方法从这些文件夹加载字体。
加载并渲染/导出演示文稿。
调用 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();

Note

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

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

获取自定义字体文件夹

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();
}

常见问题

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

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

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

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

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

可以。通过配置字体替代、替换规则和回退集，可以明确指定在请求的字形缺失时使用哪个字体。

我可以在 Linux/Docker 容器中使用字体而不在系统范围内安装吗？

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

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

关于授权——我可以在没有限制的情况下嵌入任何自定义字体吗？

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

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