使用 PHP 配置演示文稿中的字体替换

本页内容简介

在渲染或转换 PowerPoint 和 OpenDocument 演示文稿时，通过 Java 为 PHP 的 Aspose.Slides 配置字体替换规则并检查被替换的字体。

概述

字体替换允许 Aspose.Slides 在呈现或转换演示文稿时使用可用的字体来代替无法访问的字体。替换影响渲染后的输出；它不会更改演示文稿内容中分配的字体。

您可以定义在特定字体不可用时使用的字体，并且可以检查 Aspose.Slides 在渲染期间将进行的替换。这有助于在拥有不同已安装字体的环境之间保持输出一致。

如果字体可用但没有专用的粗体字形，请参阅处理没有专用粗体字形的字体。该章节解释了在 PDF 导出期间如何栅格化受影响的文本以及对文本选择、搜索和缩放的影响。

获取字体替代

使用FontsManager::getSubstitutions方法来确定在渲染演示文稿时将被替换的字体。该方法返回FontSubstitutionInfo对象，这些对象标识原始字体和替代字体的名称。

以下 PHP 示例列出了演示文稿的所有字体替代：

use aspose\slides\Presentation;

$presentation = new Presentation("Presentation.pptx");
try {
    $enumerator = $presentation->getFontsManager()->getSubstitutions()->iterator();
    try {
        while (java_values($enumerator->hasNext())) {
            $substitution = $enumerator->next();
            $originalFontName = java_values($substitution->getOriginalFontName());
            $substitutedFontName = java_values($substitution->getSubstitutedFontName());
            echo $originalFontName . " -> " . $substitutedFontName . PHP_EOL;
        }
    } finally {
        $enumerator->dispose();
    }
} finally {
    $presentation->dispose();
}

获取选定幻灯片的字体替代

使用带有 int[] slides 参数的FontsManager::getSubstitutions重载来仅检查渲染特定幻灯片所需的替代。这在以下情况下很有用：渲染或导出演示文稿的部分内容、增量检查大型演示文稿、定位依赖于不可用字体的幻灯片、为服务器或容器准备最小的字体包，或在不处理无关幻灯片的情况下诊断渲染差异。

slides 数组使用基于 1 的幻灯片索引：1 表示第一张幻灯片。相比之下，Presentation::getSlides集合访问器使用基于 0 的索引，因此同一幻灯片可通过 $presentation->getSlides()->get_Item(0) 访问。在构建数组时请记住此差异，以避免越界错误。

通过Presentation::getFontsManager方法调用此重载。它仅返回在渲染选定幻灯片时确定的替代。每个结果都是一个包含原始和替代字体名称的FontSubstitutionInfo对象。结果反映了当前的字体环境、已配置的回退规则、存储在FontSubstRuleCollection中的替代规则以及外部加载的字体。

同一替代可能被多个选定幻灯片所需。在创建字体清单或预检报告时请对结果进行去重。以下示例报告每个返回的替代，然后创建唯一字体映射的排序列表：

use aspose\slides\Presentation;

$presentation = new Presentation("Presentation.pptx");
try {
    $selectedSlides = [1, 3, 5];
    $substitutions = [];
    $enumerator = $presentation->getFontsManager()->getSubstitutions($selectedSlides)->iterator();
    try {
        while (java_values($enumerator->hasNext())) {
            $substitutions[] = $enumerator->next();
        }
    } finally {
        $enumerator->dispose();
    }

    echo "Substitutions for the selected slides:" . PHP_EOL;
    foreach ($substitutions as $substitution) {
        $originalFontName = java_values($substitution->getOriginalFontName());
        $substitutedFontName = java_values($substitution->getSubstitutedFontName());
        echo $originalFontName . " -> " . $substitutedFontName . PHP_EOL;
    }

    $sortedPreflightEntries = [];
    foreach ($substitutions as $substitution) {
        $originalFontName = java_values($substitution->getOriginalFontName());
        $substitutedFontName = java_values($substitution->getSubstitutedFontName());
        $entry = $originalFontName . " -> " . $substitutedFontName;
        $sortedPreflightEntries[strtolower($entry)] = $entry;
    }
    ksort($sortedPreflightEntries, SORT_NATURAL | SORT_FLAG_CASE);

    echo "Deduplicated font preflight report:" . PHP_EOL;
    foreach ($sortedPreflightEntries as $entry) {
        echo $entry . PHP_EOL;
    }
} finally {
    $presentation->dispose();
}

FontsManager 类提供了这两种重载。请根据渲染操作的范围选择使用哪一种：

Overload	使用场景
getSubstitutions with no arguments	您需要对整个演示文稿进行替代。
getSubstitutions with `int[] slides`	您需要对选定范围、增量检查或部分导出进行替代。

设置字体替代规则

指定当源字体不可用时 Aspose.Slides 应使用的字体：

加载演示文稿。
为源字体和替代字体创建字体定义。
使用WhenInaccessible条件创建一个FontSubstRule。
将规则添加到FontSubstRuleCollection。
使用FontsManager::setFontSubstRuleList方法分配该集合。
渲染或转换演示文稿。

以下 PHP 示例在 SomeRareFont 不可用时将 Arial 替代为 SomeRareFont，然后渲染第一张幻灯片以验证结果。替代字体必须对 Aspose.Slides 可用。

use aspose\slides\FontData;
use aspose\slides\FontSubstCondition;
use aspose\slides\FontSubstRule;
use aspose\slides\FontSubstRuleCollection;
use aspose\slides\ImageFormat;
use aspose\slides\Presentation;

$presentation = new Presentation("Fonts.pptx");
try {
    $sourceFont = new FontData("SomeRareFont");
    $substituteFont = new FontData("Arial");
    $substitutionRule = new FontSubstRule($sourceFont, $substituteFont, FontSubstCondition::WhenInaccessible);

    $substitutionRules = new FontSubstRuleCollection();
    $substitutionRules->add($substitutionRule);
    $presentation->getFontsManager()->setFontSubstRuleList($substitutionRules);

    $image = $presentation->getSlides()->get_Item(0)->getImage(1.0, 1.0);
    try {
        $image->save("slide.jpg", ImageFormat::Jpeg);
    } finally {
        $image->dispose();
    }
} finally {
    $presentation->dispose();
}

Note

要对整个演示文稿中使用的字体进行无条件更改，请参阅Font Replacement。

数学公式字体的限制

字体替代规则是渲染和转换过程中使用的标准字体选择过程的一部分。当 Aspose.Slides 能够使用规则指定的可用字体替代不可访问的字体时，它们适用于普通文本。

Office Math 公式有额外的要求。如果公式使用 Cambria Math，Aspose.Slides 可能需要该精确字体来计算和渲染公式布局。替代另一个数学字体（例如 STIX Two Math）的规则无法替代 Cambria Math，因此渲染仍可能报告需要 Cambria Math。

要渲染或转换此类演示文稿，请确保 Cambria Math 对 Aspose.Slides 可用。可在操作系统中安装它或将其作为外部字体加载。

此限制适用于公式布局。上述替代规则仍适用于普通演示文稿文本。

常见问题

字体替换与字体替代有什么区别？

Font replacement 有意在整个演示文稿中将一种字体更改为另一种。而字体替代则在满足配置的条件（例如原始字体不可用）时，为渲染输出选择一种字体。

何时应用替代规则？

规则参与在渲染和转换期间的字体选择序列。使用 WhenInaccessible 时，规则仅在 Aspose.Slides 无法访问源字体时使用。

当字体缺失且未配置替代规则时会怎样？

Aspose.Slides 根据其字体选择过程选择最接近的可用字体。结果取决于运行时环境中可用的字体。

我可以加载外部字体以避免替代吗？

可以。您可以加载外部字体，使 Aspose.Slides 在渲染和转换期间使用它们。

Aspose 是否随库分发字体？

不。您需自行提供字体并遵守其许可。

替代结果会在 Windows、Linux 和 macOS 之间有所差异吗？

会。不同操作系统的已安装字体和字体搜索位置不同，某台机器上可用的字体在另一台机器上可能需要替代。

如何在批量转换中保持字体选择的一致性？

在每台机器或容器上使用相同的字体文件和版本，加载所需的外部字体，并在许可允许的情况下嵌入字体。您还可以在导出前调用FontsManager::getSubstitutions以识别意外的替代。

使用 PHP 简化演示文稿中的字体替换 Aspose.Slides for PHP 中的字体选择序列