Java での PDF ファイルの作成

Aspose.PDF for Java は、シンプルなドキュメント作成と OCR を利用した検索可能な PDF ワークフローの両方をサポートしています。

新しい PDF ドキュメントの作成

シンプルな PDF ファイルを最初から生成する必要がある場合は、このアプローチを使用してください。

  1. 新しい PDF の Document を作成してください。
  2. ドキュメントに Page を追加してください。
  3. TextFragment を作成し、ページに追加してください。
  4. 出力 PDF を Document として保存してください。
public static void createNewDocument(Path outputFile) {
    try (Document document = new Document()) {
        Page page = document.getPages().add();
        page.getParagraphs().add(new TextFragment("Hello World!"));
        document.save(outputFile.toString());
    }
}

検索可能な PDF の作成

createSearchablePdf の使用例では、Document.convert(...) と CallBackGetHocr の実装が使用されます。コールバックは、ソース画像を一時ファイルに書き込み、Tesseract を hocr オプション付きで実行し、生成された HOCR マークアップを読み取って Aspose.PDF に返します。

  1. ソース PDF の Document を開いてください。
  2. CallBackGetHocr コールバックを作成し、ソースドキュメントを検索可能な PDF コンテンツに変換してください。
  3. 更新した PDF の Document を保存してください。
public static void createSearchablePdf(Path inputFile, Path outputFile) {
    Path tempDir = outputFile.getParent().resolve("ocr-temp");
    CallBackGetHocr cbgh = new CallBackGetHocr() {
        @Override
        public String invoke(java.awt.image.BufferedImage img) {
            // save the image, run Tesseract with "hocr", and return the HOCR text
            return fileContents.toString();
        }
    };
    try (Document document = new Document(inputFile.toString())) {
        document.convert(cbgh);
        document.save(outputFile.toString());
    }
}

ドキュメントウィンドウ設定の取得

この例を使用して、既存の 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. ドキュメントフォントユーティリティが返すフォントを列挙してください。
  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. GoToAction と XYZExplicitDestination を作成してください。
  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. オープンアクションが GoToAction で、その先頭が XYZExplicitDestination であるかどうかを確認してください。
  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 ドキュメントのフォーマット