GroupDocs.Viewer を使用した Java での PDF ページ回転方法

PDF 内の特定のページを回転させることは、文書の整列やプレゼンテーションスライドの調整に不可欠です。このガイドでは、GroupDocs.Viewer を使用してプログラムで pdf ページを回転させる方法を学びます。pdf を 90 度回転させる、セクション全体を反転させる、または単一の呼び出しで複数ページを処理する場合にも対応できます。

GroupDocs.Viewer for Java で特定の PDF ページを回転

What You’ll Learn:

Java プロジェクトで GroupDocs.Viewer を設定する方法（Maven GroupDocs Viewer の構成を含む）
特定の PDF ページをプログラムで回転させる方法（rotate pdf 90 degrees、180 degrees など）
最適な使用のための重要な構成
実装中に発生する一般的な問題のトラブルシューティング

クイック回答

Java で PDF ページを回転できるライブラリは何ですか？ GroupDocs.Viewer for Java.
単一ページを 90 度回転できますか？ はい、rotatePage(pageNumber, Rotation.ON_90_DEGREE) を使用します。
開発にライセンスは必要ですか？ 無料トライアル用の一時ライセンスが利用可能です。
Maven は必須ですか？ Maven は GroupDocs の依存関係管理に推奨される方法です。
回転したページはどのようにレンダリングしますか？ HtmlViewOptions を使用し、viewer.view(...) を呼び出します。

前提条件

必要なライブラリと依存関係

開始するには、以下がインストールされていることを確認してください。

Java Development Kit (JDK) バージョン 8 以上がマシンにインストールされていること。
IntelliJ IDEA や Eclipse などの統合開発環境 (IDE)。
プロジェクトの依存関係管理に使用する Maven。

環境設定要件

Maven Configuration: pom.xml に必要なリポジトリと依存関係を追加して、GroupDocs.Viewer を Maven プロジェクトに組み込みます。
License Acquisition: GroupDocs から一時ライセンスを取得し、開発中に機能制限なしで全機能を試すことができます。詳細は GroupDocs Free Trial または GroupDocs Temporary License Page をご覧ください。

Java 用 GroupDocs.Viewer の設定

Maven を使用して Java プロジェクトに GroupDocs.Viewer を統合するには、pom.xml を更新します。

Maven Configuration

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

基本的な初期化と設定

ドキュメントディレクトリと出力パスを指定して GroupDocs.Viewer を初期化します。

Path YOUR_DOCUMENT_DIRECTORY = Path.of("YOUR_DOCUMENT_DIRECTORY");
Path YOUR_OUTPUT_DIRECTORY = Path.of("YOUR_OUTPUT_DIRECTORY");

// Format for page file paths
Path pageFilePathFormat = YOUR_OUTPUT_DIRECTORY.resolve("page_{0}.html");

HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

実装ガイド

GroupDocs.Viewer を使用した特定ページの回転

Overview: 文書の提示を改善するために、特定の PDF ページを回転させます。

ステップ 1: ページの回転を設定する

HtmlViewOptions を使用して、最初のページを 90 度、2 番目のページを 180 度回転させます。

// Rotate the first page by 90 degrees clockwise.
viewOptions.rotatePage(1, Rotation.ON_90_DEGREE);

// Rotate the second page by 180 degrees.
viewOptions.rotatePage(2, Rotation.ON_180_DEGREE);

ステップ 2: ビューアを初期化してレンダリングする

ドキュメントを指定して Viewer インスタンスを作成し、指定したページをレンダリングします。

Viewer viewer = new Viewer(YOUR_DOCUMENT_DIRECTORY.resolve("SampleDocument.pdf"));

// Render the specified pages (1 and 2) using the configured options.
viewer.view(viewOptions, 1, 2);

// Always close the viewer to free resources.
viewer.close();

パラメータと設定

Rotation: ページ番号と回転角度を指定して rotatePage を使用します。利用可能な回転は ON_90_DEGREE、ON_180_DEGREE、ON_270_DEGREE です。
HtmlViewOptions: PDF ページの HTML 変換を構成し、埋め込みリソースが含まれるようにします。
pdf to html java: HtmlViewOptions クラスはレイアウトを保持しながら PDF‑to‑HTML 変換を処理します。

トラブルシューティングのヒント (PDF の回転に関するトラブルシューティング)

ドキュメントおよび出力ディレクトリへのパスを確認してください。
依存関係の欠如やライブラリバージョンの不一致がないかチェックしてください。
トライアル中に機能制限が発生した場合は、ライセンスが正しく適用されていることを確認してください。
メモリ使用量が急増する場合は、ページを小さなバッチで順次レンダリングすることを検討してください（rotate multiple pdf pages gradually）。

実用的な応用

実際のユースケース

Document Alignment – スキャンした文書を正しいデジタル向きに回転させます。
Presentation Adjustments – 共有前に PDF 内のプレゼンテーションスライドを修正します。
Archival Workflows – デジタル化中に歴史的文書の向きを自動的に調整します。

統合の可能性

Java ベースのドキュメント管理システム、コンテンツプラットフォーム、または動的な閲覧機能を必要とするカスタムエンタープライズソリューションと GroupDocs.Viewer を統合します。

パフォーマンスに関する考慮事項

Resource Management: Viewer インスタンスを閉じてリソースを解放します。
Java Memory Management: 大容量ドキュメントをレンダリングする際はメモリ使用量を監視し、効率的なデータ構造を使用します。
Best Practices: 頻繁にアクセスされるドキュメントやページはキャッシュを活用します。

まとめ

このチュートリアルでは how to rotate pdf ページを Java の GroupDocs.Viewer を使用して環境設定から実用的な応用までカバーしました。透かしの追加や別フォーマットへの変換など、追加機能も試してみてください。

次のステップ: ドキュメント処理機能を強化するために、さらに多くの GroupDocs.Viewer 機能を探求してください。

FAQ セクション

よくある質問

Troubleshooting Rotation Issues: ページ番号と回転パラメータが正しいことを確認してください。
Handling Large PDF Files: 適切なリソース管理で大容量文書を効率的に処理します。
Licensing Requirements: 開発には一時ライセンスを使用し、本番環境では正式ライセンスを購入してください。
Rotating Multiple Pages: 異なるページ番号と角度で rotatePage を複数回呼び出します。
Integration with Java Libraries: GroupDocs.Viewer を大規模アプリケーションやフレームワークにシームレスに統合します。

よくある質問

Q: PDF の全ページを一度に回転できますか？ A: はい。ページ番号をループし、各ページに対して rotatePage(page, Rotation.ON_90_DEGREE) を呼び出してください。

Q: 回転は元の PDF ファイルに影響しますか？ A: いいえ。回転はレンダリング処理中にのみ適用され、元の PDF は変更されません。

Q: PDF がパスワードで保護されている場合はどうなりますか？ A: Viewer インスタンスを作成する際にパスワードを指定してください：new Viewer(path, password)

Q: HtmlViewOptions の設定時に発生する「null ポインタ」エラーをデバッグするにはどうすればよいですか？ A: 出力ディレクトリが存在し、pageFilePathFormat が正しく解決されることを確認してください。

Q: 他の形式（例: PNG）に変換するときにページを回転させる方法はありますか？ A: 変換先の形式に適した表示オプションを使用して、同じ rotatePage 設定を使用してください。

リソース

ドキュメント: GroupDocs Viewer ドキュメント
API リファレンス: GroupDocs API リファレンス
ダウンロード: GroupDocs ダウンロードページ
購入: GroupDocs 購入オプション
無料トライアル: GroupDocs 無料トライアル
一時ライセンス: 一時ライセンスのリクエスト
サポート: GroupDocs サポートフォーラム

最終更新日: 2026-01-18
テスト環境: GroupDocs.Viewer 25.2 for Java
作者: GroupDocs