在 Java 中自定义 PowerPoint 字体

加载自定义字体

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

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

以下代码示例演示了字体加载过程:

// 定义包含自定义字体文件的文件夹。
String[] fontFolders = new String[] { externalFontFolder1, externalFontFolder2 };

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

Presentation presentation = null;
try {
    presentation = new Presentation("sample.pptx");
    
    // 使用已加载的字体渲染/导出演示文稿(例如,导出为 PDF、图像或其他格式)。
    presentation.save("output.pdf", SaveFormat.Pdf);
} finally {
    if (presentation != null) presentation.dispose();

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

获取自定义字体文件夹

Aspose.Slides 提供 getFontFolders 方法,以便您查找字体文件夹。该方法返回通过 LoadExternalFonts 方法添加的文件夹以及系统字体文件夹。

下面的 Java 代码展示了如何使用 getFontFolders

// 此行输出搜索字体文件的文件夹。
// 这些文件夹是通过 LoadExternalFonts 方法添加的以及系统字体文件夹。
String[] fontFolders = FontsLoader.getFontFolders();

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

Aspose.Slides 提供 setDocumentLevelFontSources 属性,允许您指定将在演示文稿中使用的外部字体。

下面的 Java 代码展示了如何使用 setDocumentLevelFontSources 属性:

byte[] memoryFont1 = Files.readAllBytes("customfonts/CustomFont1.ttf");
byte[] memoryFont2 = Files.readAllBytes("customfonts/CustomFont2.ttf");

LoadOptions loadOptions = new LoadOptions();
loadOptions.getDocumentLevelFontSources().setFontFolders(new String[] { "assets/fonts", "global/fonts" });
loadOptions.getDocumentLevelFontSources().setMemoryFonts(new byte[][] { memoryFont1, memoryFont2 });

Presentation pres = new Presentation("MyPresentation.pptx", loadOptions);
try {
    // 与演示文稿一起工作
    // CustomFont1、CustomFont2,以及来自 assets\fonts 和 global\fonts 文件夹及其子文件夹的字体都可用于演示文稿
} finally {
    if (pres != null) pres.dispose();
}

外部管理字体

Aspose.Slides 提供 loadExternalFont(byte[] data) 方法,以便您从二进制数据加载外部字体。

下面的 Java 代码演示了字节数组字体加载过程:

FontsLoader.loadExternalFont(Files.readAllBytes(Paths.get("ARIALN.TTF")));
FontsLoader.loadExternalFont(Files.readAllBytes(Paths.get("ARIALNBI.TTF")));
FontsLoader.loadExternalFont(Files.readAllBytes(Paths.get("ARIALNI.TTF")));

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

常见问答

自定义字体会影响所有格式的导出(PDF、PNG、SVG、HTML)吗?

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

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

否。为渲染注册字体并不等同于将其嵌入 PPTX。如果需要将字体包含在演示文稿文件中,必须使用显式的 embedding features 功能。

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

可以。通过配置 font substitutionreplacement rulesfallback sets,可以明确指定在请求的字形缺失时使用哪个字体。

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

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

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

您需要自行负责字体许可的合规性。条款各不相同;某些许可证禁止嵌入或商业使用。始终在分发输出之前检查字体的最终用户许可协议(EULA)。