在 PHP 中自定义 PowerPoint 字体

Aspose Slides 允许您使用 loadExternalFonts 方法加载这些字体：

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

加载自定义字体

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

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

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

// 定义包含自定义字体文件的文件夹。
$fontFolders = array($externalFontFolder1, $externalFontFolder2);

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

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

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

Note

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

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

获取自定义字体文件夹

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

以下 PHP 代码展示了如何使用 getFontFolders:

  # 此行输出搜索字体文件的文件夹。
  # 这些文件夹是通过 LoadExternalFonts 方法添加的以及系统字体文件夹。
  $fontFolders = FontsLoader->getFontFolders();

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

Aspose.Slides 提供了 setDocumentLevelFontSources 方法，以便您指定将在演示文稿中使用的外部字体。

以下 PHP 代码展示了如何使用 setDocumentLevelFontSources 方法：

  $Array = new JavaClass("java.lang.reflect.Array");
  $Byte = new JavaClass("java.lang.Byte");
  $file1 = new Java("java.io.File", "customfonts/CustomFont1.ttf");
  $memoryFont1 = $Array->newInstance($Byte, $Array->getLength($file1));
  try {
      $dis1 = new Java("java.io.DataInputStream", new Java("java.io.FileInputStream", $file1));
      $dis1->readFully($memoryFont1);
  } finally {
      if (!java_is_null($dis1)) $dis1->close();
  }
  $file2 = new Java("java.io.File", "customfonts/CustomFont2.ttf");
  $memoryFont2 = $Array->newInstance($Byte, $Array->getLength($file2));
  try {
        $dis2 = new Java("java.io.DataInputStream", new Java("java.io.FileInputStream", $file2));
        $dis2->readFully($memoryFont2);
  } finally {
        if (!java_is_null($dis2)) $dis2->close();
  }
  $loadOptions = new LoadOptions();
  $loadOptions->getDocumentLevelFontSources()->setFontFolders(array("assets/fonts", "global/fonts" ));
  $loadOptions->getDocumentLevelFontSources()->setMemoryFonts(array($memoryFont1, $memoryFont2 ));
  $pres = new Presentation("MyPresentation.pptx", $loadOptions);
  try {
    # 对演示文稿进行操作
    # CustomFont1、CustomFont2，以及来自 assets\fonts 和 global\fonts 文件夹及其子文件夹的字体可用于演示文稿
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

外部管理字体

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

以下 PHP 代码演示了字节数组字体加载过程：

$Array = new JavaClass("java.lang.reflect.Array");
$Byte = (new JavaClass("java.lang.Byte"))->TYPE;
try {
    $dis = new Java("java.io.DataInputStream", new Java("java.io.FileInputStream", "ARIALN.TTF"));
    $bytes = $Array->newInstance($Byte, $dis->available());
    $dis->readFully($bytes);
} finally {
    if (!java_is_null($dis)) $dis->close();
}
  FontsLoader->loadExternalFont($bytes);

try {
    $dis = new Java("java.io.DataInputStream", new Java("java.io.FileInputStream", "ARIALNBI.TTF"));
    $bytes = $Array->newInstance($Byte, $dis->available());
    $dis->readFully($bytes);
} finally {
    if (!java_is_null($dis)) $dis->close();
}
  FontsLoader->loadExternalFont($bytes);

try {
    $dis = new Java("java.io.DataInputStream", new Java("java.io.FileInputStream", "ARIALNI.TTF"));
    $bytes = $Array->newInstance($Byte, $dis->available());
    $dis->readFully($bytes);
} finally {
    if (!java_is_null($dis)) $dis->close();
}
  FontsLoader->loadExternalFont($bytes);

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

常见问题

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

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

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

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

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

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

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

是。只需指向自己的字体文件夹或从字节数组加载字体。这样就消除了容器镜像对系统字体目录的依赖。

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

您需要自行负责字体许可证的合规性。条款各不相同，某些许可证禁止嵌入或商业使用。分发输出前请始终查阅字体的 EULA。

使用 PHP 管理演示文稿中的字体在 PHP 中指定默认演示文稿字体