在 Java 中嵌入演示文稿的字体

介绍

嵌入字体会将字体数据存储在 PowerPoint 演示文稿中。当查看器支持嵌入字体时，即使目标系统未安装这些字体，也可以使用这些字体显示文本。这有助于保持换行、文本间距和幻灯片布局。

Aspose.Slides for Java 允许您通过返回的 IFontsManager 接口（通过 Presentation.getFontsManager）检索、添加和删除嵌入字体。您还可以通过删除演示文稿未使用的字符来减少嵌入字体数据的大小。

以下示例适用于 PPTX 文件。在嵌入字体之前，请确保该字体的数据可供 Aspose.Slides 使用，并且其许可允许嵌入。

获取并移除嵌入字体

使用 getEmbeddedFonts 列出存储在演示文稿中的字体。要移除其中的某个字体，请将该列表中的字体传递给 removeEmbeddedFont，然后保存演示文稿。

下面的示例列出了 EmbeddedFonts.pptx 中的嵌入字体，并在存在时移除 Calibri：

import com.aspose.slides.IFontData;
import com.aspose.slides.IFontsManager;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

Presentation presentation = new Presentation("EmbeddedFonts.pptx");
try {
    IFontsManager fontsManager = presentation.getFontsManager();
    IFontData[] embeddedFonts = fontsManager.getEmbeddedFonts();

    for (IFontData font : embeddedFonts) {
        System.out.println(font.getFontName());
    }

    IFontData fontToRemove = null;
    for (IFontData font : embeddedFonts) {
        if ("Calibri".equalsIgnoreCase(font.getFontName())) {
            fontToRemove = font;
            break;
        }
    }

    if (fontToRemove != null) {
        fontsManager.removeEmbeddedFont(fontToRemove);
        presentation.save("WithoutEmbeddedCalibri.pptx", SaveFormat.Pptx);
    } else {
        System.out.println("Calibri is not embedded. No output file was created.");
    }
} finally {
    presentation.dispose();
}

移除嵌入字体会删除其存储的字体数据；它不会更改文本所分配的字体。如果目标系统已安装该字体，文本仍然可以使用它。否则，渲染可能需要 字体替换，这可能影响布局。

检查字体数据和嵌入权限

使用 IFontsManager 接口在嵌入字体之前检查字体。调用 IFontsManager.getFonts 获取演示文稿中使用的字体。对于每个字体，传入一个 IFontData 对象和所需的 FontStyleType 值，调用 IFontsManager.getFontBytes。该方法返回该字体样式的二进制数据，如果请求的字体或样式不可用则返回 null。不要将 null 结果传递给 IFontsManager.getFontEmbeddingLevel，因为该方法需要字节数组。

EmbeddingLevel 是一个标志枚举，用于报告存储在字体中的嵌入限制：

  • Installable 允许嵌入并在其他系统上永久安装，但需遵守字体许可。
  • Restricted 禁止嵌入，除非从字体的合法所有者处获得许可（当它是唯一的使用权限标志时）。
  • PreviewPrint 允许临时用于查看和打印；包含该字体的文档必须为只读。
  • Editable 允许临时使用，并且文档可以编辑和保存。
  • NoSubsetting 是一种附加限制，禁止仅嵌入字形子集。当存在此标志时必须嵌入所有字符。
  • BitmapOnly 是一种附加限制，只允许嵌入位图字形，而不嵌入轮廓数据。如果字体没有位图字形，则无法嵌入。

前四个值描述使用权限，而 NoSubsetting 和 BitmapOnly 可以与它们组合。使用按位运算检查这些修饰符。由于 Installable 为零，请对使用权限位进行掩码并将结果与 Installable 比较，而不是将其视为标志进行检查。当前字体应最多设置一个使用权限位。为兼容设置了多个使用权限位的旧字体，下面的辅助方法将选择最宽松的权限：Editable，其后是 PreviewPrint，最后是 Restricted。

下面的示例审计 getFonts 返回的每种字体的常规、粗体、斜体和粗斜体数据。它会跳过不可用的样式、受限制的字体、仅位图字体、仅限预览和打印的字体（因为输出保持可编辑），以及已经嵌入的字体。如果任何可用样式具有 NoSubsetting，则为该字体系列嵌入所有字符。

import com.aspose.slides.EmbedFontCharacters;
import com.aspose.slides.EmbeddingLevel;
import com.aspose.slides.FontStyleType;
import com.aspose.slides.IFontData;
import com.aspose.slides.IFontsManager;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;
import java.util.ArrayList;
import java.util.HashSet;
import java.util.List;
import java.util.Locale;
import java.util.Set;

class EmbeddingPermission {
    int getUsagePermission(int level) {
        int permissionMask = EmbeddingLevel.Restricted | EmbeddingLevel.PreviewPrint | EmbeddingLevel.Editable;
        int permissions = level & permissionMask;

        if ((permissions & EmbeddingLevel.Editable) != 0) {
            return EmbeddingLevel.Editable;
        }

        if ((permissions & EmbeddingLevel.PreviewPrint) != 0) {
            return EmbeddingLevel.PreviewPrint;
        }

        if ((permissions & EmbeddingLevel.Restricted) != 0) {
            return EmbeddingLevel.Restricted;
        }

        return EmbeddingLevel.Installable;
    }
}

Presentation presentation = new Presentation("Fonts.pptx");
try {
    IFontsManager fontsManager = presentation.getFontsManager();
    int[] fontStyles = {
        FontStyleType.Regular,
        FontStyleType.Bold,
        FontStyleType.Italic,
        FontStyleType.Bold | FontStyleType.Italic
    };

    Set<String> embeddedFontNames = new HashSet<String>();
    for (IFontData embeddedFont : fontsManager.getEmbeddedFonts()) {
        embeddedFontNames.add(embeddedFont.getFontName().toLowerCase(Locale.ROOT));
    }

    EmbeddingPermission permissionHelper = new EmbeddingPermission();
    List<IFontData> fontsToEmbed = new ArrayList<IFontData>();
    List<Integer> embeddingRules = new ArrayList<Integer>();
    for (IFontData font : fontsManager.getFonts()) {
        if (embeddedFontNames.contains(font.getFontName().toLowerCase(Locale.ROOT))) {
            System.out.println(font.getFontName() + ": already embedded.");
            continue;
        }

        boolean hasAvailableData = false;
        boolean allAvailableStylesCanBeEmbedded = true;
        boolean previewPrintOnly = false;
        boolean requiresFullFont = false;

        for (int fontStyle : fontStyles) {
            byte[] fontBytes = fontsManager.getFontBytes(font, fontStyle);
            if (fontBytes == null) {
                System.out.println(font.getFontName() + " (" + fontStyle + "): font data is unavailable.");
                continue;
            }

            hasAvailableData = true;
            int embeddingLevel = fontsManager.getFontEmbeddingLevel(fontBytes, font.getFontName());
            int usagePermission = permissionHelper.getUsagePermission(embeddingLevel);
            boolean noSubsetting = (embeddingLevel & EmbeddingLevel.NoSubsetting) != 0;
            boolean bitmapOnly = (embeddingLevel & EmbeddingLevel.BitmapOnly) != 0;

            requiresFullFont |= noSubsetting;
            previewPrintOnly |= usagePermission == EmbeddingLevel.PreviewPrint;
            allAvailableStylesCanBeEmbedded &= usagePermission != EmbeddingLevel.Restricted && !bitmapOnly;

            System.out.println(font.getFontName() + " (" + fontStyle + "): " + embeddingLevel + ".");
        }

        if (!hasAvailableData) {
            System.out.println(font.getFontName() + ": skipped because no requested style is available.");
        } else if (!allAvailableStylesCanBeEmbedded) {
            System.out.println(font.getFontName() + ": skipped because at least one available style does not permit outline embedding.");
        } else if (previewPrintOnly) {
            System.out.println(font.getFontName() + ": skipped because this example produces an editable presentation.");
        } else {
            int rule = requiresFullFont ? EmbedFontCharacters.All : EmbedFontCharacters.OnlyUsed;
            fontsToEmbed.add(font);
            embeddingRules.add(rule);
        }
    }

    for (int i = 0; i < fontsToEmbed.size(); i++) {
        fontsManager.addEmbeddedFont(fontsToEmbed.get(i), embeddingRules.get(i));
    }

    presentation.save("WithAuditedFonts.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

此检查报告了每个字体文件中编码的限制。它并不授予许可、证明您已合法获取字体，也不能替代在分发嵌入副本之前检查字体许可协议的步骤。

添加嵌入字体

使用 addEmbeddedFont 可以嵌入字体。其重载接受 IFontData 对象或包含字体数据的字节数组。EmbedFontCharacters 枚举控制包含哪些字符：

  • All 嵌入字体中的所有字符。当接收者需要编辑演示文稿并输入新文本时使用此选项。
  • OnlyUsed 仅嵌入演示文稿中使用的字符，以减小文件大小。对于主要供查看的已完成演示文稿请选择此选项。

下面的示例使用 getFonts 检索 Fonts.pptx 中使用的字体，并嵌入那些尚未嵌入的字体。要添加的字体必须在运行代码的机器上可用。已嵌入的字体将保留其当前的字符集。

import com.aspose.slides.EmbedFontCharacters;
import com.aspose.slides.IFontData;
import com.aspose.slides.IFontsManager;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;
import java.util.HashSet;
import java.util.Locale;
import java.util.Set;

Presentation presentation = new Presentation("Fonts.pptx");
try {
    IFontsManager fontsManager = presentation.getFontsManager();
    IFontData[] allFonts = fontsManager.getFonts();
    IFontData[] embeddedFonts = fontsManager.getEmbeddedFonts();
    Set<String> embeddedFontNames = new HashSet<String>();

    for (IFontData embeddedFont : embeddedFonts) {
        embeddedFontNames.add(embeddedFont.getFontName().toLowerCase(Locale.ROOT));
    }

    for (IFontData font : allFonts) {
        String fontName = font.getFontName().toLowerCase(Locale.ROOT);
        if (!embeddedFontNames.contains(fontName)) {
            fontsManager.addEmbeddedFont(font, EmbedFontCharacters.All);
            embeddedFontNames.add(fontName);
        }
    }

    presentation.save("WithEmbeddedFonts.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

压缩嵌入字体

Compress.compressEmbeddedFonts 通过删除未使用的字符来减少嵌入字体数据。它作用于已经嵌入的字体，因此大小的降低取决于演示文稿中未使用的字体数据量。

下面的示例压缩 EmbeddedFonts.pptx 中的字体，并将结果另存为单独的文件：

import com.aspose.slides.Compress;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

Presentation presentation = new Presentation("EmbeddedFonts.pptx");
try {
    Compress.compressEmbeddedFonts(presentation);
    presentation.save("CompressedEmbeddedFonts.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

如果收件人以后可能需要添加文本，请保留原始文件。压缩期间删除的字符在嵌入字体中不再可用，即使您最初已嵌入所有字符。

常见问题

如何检查嵌入的字体在渲染时是否仍会被替换？

在渲染演示文稿的环境中调用 getSubstitutions 可查看 Aspose.Slides 将替换哪些字体。同时检查 字体替换 设置和 字体回退 规则。回退处理缺失的字符，因此嵌入字体并不能解决字体本身不包含的字符。

我应该嵌入像 Arial 和 Calibri 这样的常用字体吗？

应根据目标环境做决定。如果所需字体在每台打开或渲染演示文稿的机器上都可用，则嵌入它们可能会导致不必要的文件增大。如果收件人或服务器可能缺少这些字体，嵌入它们可以帮助保持预期的外观，前提是其许可证允许这样做。

在 Java 中指定默认演示文稿字体 管理 Java 演示文稿的后备字体