在 Java 中格式化 PDF 文档

Aspose.PDF for Java 中的格式设置包括查看器行为、字体嵌入和显示设置。

获取文档窗口设置

使用此示例检查已存在的 PDF 文档中存储的当前查看器首选项。

  1. 打开源 PDF Document。
  2. 从文档中读取所需的窗口和显示属性。
  3. 输出当前设置以供检查或调试。
public static void getDocumentWindow(Path inputFile) {
    try (Document document = new Document(inputFile.toString())) {
        System.out.println("CenterWindow: " + document.isCenterWindow());
        System.out.println("Direction: " + document.getDirection());
        System.out.println("DisplayDocTitle: " + document.isDisplayDocTitle());
        System.out.println("FitWindow: " + document.isFitWindow());
        System.out.println("HideMenuBar: " + document.isHideMenubar());
        System.out.println("HideToolBar: " + document.isHideToolBar());
        System.out.println("HideWindowUI: " + document.isHideWindowUI());
        System.out.println("NonFullScreenPageMode: " + document.getNonFullScreenPageMode());
        System.out.println("PageLayout: " + document.getPageLayout());
        System.out.println("PageMode: " + document.getPageMode());
    }
}

设置文档窗口首选项

此示例更新了 PDF 在兼容查看器中打开时的显示方式。

  1. 打开源 PDF Document。
  2. 设置所需的窗口、布局和页面模式首选项。
  3. 保存更新后的 PDF Document。
public static void setDocumentWindow(Path inputFile, Path outputFile) {
    try (Document document = new Document(inputFile.toString())) {
        document.setCenterWindow(true);
        document.setDirection(Direction.R2L);
        document.setDisplayDocTitle(true);
        document.setFitWindow(true);
        document.setHideMenubar(true);
        document.setHideToolBar(true);
        document.setHideWindowUI(true);
        document.setNonFullScreenPageMode(PageMode.UseOC);
        document.setPageLayout(PageLayout.TwoColumnLeft);
        document.setPageMode(PageMode.UseThumbs);
        document.save(outputFile.toString());
    }
}

在现有 PDF 中嵌入字体

在文档需要携带其必需字体以便在其他系统上更可靠地渲染时，请使用此方法。

  1. 打开源 PDF Document。
  2. 启用标准字体嵌入并遍历每个使用的字体 Page。
  3. 标记任何未嵌入的 Font 用于嵌入的对象。
  4. 保存已更新的文档。
public static void embeddedFonts(Path inputFile, Path outputFile) {
    try (Document document = new Document(inputFile.toString())) {
        document.setEmbedStandardFonts(true);
        for (Page page : document.getPages()) {
            for (Font pageFont : page.getResources().getFonts()) {
                if (!pageFont.isEmbedded()) {
                    pageFont.setEmbedded(true);
                }
            }
        }
        document.save(outputFile.toString());
    }
}

在创建新 PDF 时嵌入字体

此示例创建一个新的 PDF，并从一开始就将嵌入字体分配给文本内容。

  1. 创建一个新的 PDF Document 并添加一个 Page。
  2. 创建所需的 TextFragment, TextSegment，和 TextState。
  3. 解析目标 Font 从仓库中获取并标记为嵌入。
  4. 将文本内容添加到页面并保存输出文档。
public static void embeddedFontsInNewDocument(Path outputFile) {
    try (Document document = new Document()) {
        try (Page page = document.getPages().add()) {
            TextFragment fragment = new TextFragment("");
            TextSegment segment = new TextSegment(" This is a sample text using Custom font.");
            TextState textState = new TextState();
            Font font = FontRepository.findFont("Arial");
            font.setEmbedded(true);
            textState.setFont(font);
            segment.setTextState(textState);
            fragment.getSegments().add(segment);
            page.getParagraphs().add(fragment);
        }
        document.save(outputFile.toString());
    }
}

设置 PDF 输出的默认字体

在生成输出时，如果保存的文档需要回退到特定字体，请使用此模式。

  1. 打开源 PDF Document。
  2. 创建 PdfSaveOptions 并设置默认字体名称。
  3. 使用配置的保存选项保存文档。
public static void setDefaultFont(Path inputFile, Path outputFile) {
    try (Document document = new Document(inputFile.toString())) {
        PdfSaveOptions saveOptions = new PdfSaveOptions();
        saveOptions.setDefaultFontName("Arial");
        document.save(outputFile.toString(), saveOptions);
    }
}

获取 PDF 中使用的所有字体

此示例列出文档中检测到的每种字体，以便您在导出或更新文件之前审计字体使用情况。

  1. 打开源 PDF Document。
  2. 枚举文档 Font 实用工具返回的 Font。
  3. 输出每个检测到的名称 Font。
public static void getAllFonts(Path inputFile) {
    try (Document document = new Document(inputFile.toString())) {
        for (Font font : document.getFontUtilities().getAllFonts()) {
            System.out.println(font.getFontName());
        }
    }
}

通过子集化字体来改进字体嵌入

当您希望在减小字体负载的同时保持嵌入字体数据与文档使用保持一致时，请使用此方法。

  1. 打开源 PDF Document。
  2. 通过文档字体实用工具运行字体子集化，使用所需的 FontSubsetStrategy 值。
  3. 保存优化后的文档。
public static void improveFontsEmbedding(Path inputFile, Path outputFile) {
    try (Document document = new Document(inputFile.toString())) {
        document.getFontUtilities().subsetFonts(FontSubsetStrategy.SubsetAllFonts);
        document.getFontUtilities().subsetFonts(FontSubsetStrategy.SubsetEmbeddedFontsOnly);
        document.save(outputFile.toString());
    }
}

设置文档打开时的缩放因子

此示例配置了在打开 PDF 时应应用的初始缩放级别。

  1. 打开源 PDF Document。
  2. 创建一个带有一个 XYZExplicitDestination 的 GoToAction。
  3. 将该操作分配为文档打开操作并保存结果。
public static void setZoomFactor(Path inputFile, Path outputFile) {
    try (Document document = new Document(inputFile.toString())) {
        GoToAction action = new GoToAction(new XYZExplicitDestination(1, 0.0, 0.0, 0.5));
        document.setOpenAction(action);
        document.save(outputFile.toString());
    }
}

获取文档打开时的缩放比例

使用此示例检查 PDF 是否已经为其打开操作定义了显式的缩放级别。

  1. 打开源 PDF Document。
  2. 检查打开操作是否为带有 XYZExplicitDestination 的 GoToAction。
  3. 输出已配置的缩放值，或报告未设置缩放。
public static void getZoomFactor(Path inputFile) {
    try (Document document = new Document(inputFile.toString())) {
        if (document.getOpenAction() instanceof GoToAction action
                && action.getDestination() instanceof XYZExplicitDestination destination) {
            System.out.println("Zoom: " + destination.getZoom());
        } else {
            System.out.println("Zoom: not set");
        }
    }
}
在 Java 中创建 PDF 文件 在 Java 中操作 PDF 文档