JavaでWordを画像に変換する完全な実装例

// Load the input Word document
com.aspose.words.Document doc = new com.aspose.words.Document("Words.docx");

// Initialize an object of ImageSaveOptions class
com.aspose.words.ImageSaveOptions options = new com.aspose.words.ImageSaveOptions(com.aspose.words.SaveFormat.JPEG);

// Set the "PageSet" to "0" to convert only the first page of a document.
options.setPageSet(new com.aspose.words.PageSet(0));

// Set the image's brightness and contrast.
options.setImageBrightness(0.3f);
options.setImageContrast(0.7f);

// Set the horizontal resolution.
options.setHorizontalResolution(72f);

// Save output JPG image
doc.save("Word-to-JPG.jpg", options);

注意: このコード例はコア機能を示しています。プロジェクトで使用する前に、ファイルパス（Words.docx、Word-to-JPG.jpg）を更新し、すべての必須依存関係が正しくインストールされていることを確認し、開発環境で徹底的にテストしてください。問題が発生した場合は、公式ドキュメント を参照するか、サポートチーム にお問い合わせください。

JavaコードでWordを画像に変換することの理解

デモは明確なシーケンスに従います：

1. 入力 Word ドキュメントをロード - new com.aspose.words.Document("Words.docx") は DOCX ファイルをメモリにロードします。

com.aspose.words.Document doc = new com.aspose.words.Document("Words.docx");

Document クラスは Word ファイルの読み込みと操作のエントリーポイントです（API リファレンス）。

2. ImageSaveOptions インスタンスを作成する - コンストラクタに SaveFormat.JPEG を渡すことで、ドキュメントが JPG 画像としてレンダリングされます。

   com.aspose.words.ImageSaveOptions options = new com.aspose.words.ImageSaveOptions(com.aspose.words.SaveFormat.JPEG);
   

3. ページ範囲を制限する - setPageSet(new PageSet(0)) は、コンバータに最初のページのみをレンダリングするよう指示します（ページインデックスはゼロベースです）。

   options.setPageSet(new com.aspose.words.PageSet(0));
   

4. 明るさ、コントラスト、解像度の調整 - 出力画像の見た目を微調整します。

options.setImageBrightness(0.3f);
options.setImageContrast(0.7f);
options.setHorizontalResolution(72f);

5. 出力画像を保存 - doc.save("Word-to-JPG.jpg", options) は、設定されたオプションでドキュメントをレンダリングし、JPG ファイルをディスクに書き込みます。

   doc.save("Word-to-JPG.jpg", options);
   

Word を画像に変換 - 前提条件とセットアップ

Conholdate.Total for Java の使用を開始するには、Maven リポジトリと依存関係を pom.xml に追加します：

<repositories>
    <repository>
        <id>conholdate-repo</id>
        <name>Conholdate Maven Repository</name>
        <url>https://repository.conholdate.com/repo/</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.conholdate</groupId>
    <artifactId>conholdate-total</artifactId>
    <version>24.9</version>
    <type>pom</type>
</dependency>

最新の SDK バイナリはダウンロードページから取得できます。ライブラリは Java 8 以降が必要で、標準的な JVM 上で動作します。追加の Office コンポーネントは必要ありません。

変換の微調整: オプションと設定

出力要件に合わせて、ImageSaveOptions のいくつかのプロパティを調整できます。

• 画像形式 - JPEG、PNG、または BMP などの希望の形式を SaveFormat 列挙体を介して ImageSaveOptions コンストラクタに渡します。

  com.aspose.words.ImageSaveOptions options = new com.aspose.words.ImageSaveOptions(com.aspose.words.SaveFormat.JPEG);
  

• ページ範囲 - setPageSet はどのページがレンダリングされるかを制御します。1ページの場合は単一のゼロベースインデックスを、複数ページの場合は範囲を指定してください。

  options.setPageSet(new com.aspose.words.PageSet(0));
  

• 明るさとコントラスト - 値は 0.0 から 1.0 の範囲です。0.5 はデフォルト（変更なし）のレベルです。

  options.setImageBrightness(0.3f);
  options.setImageContrast(0.7f);
  

• 解像度 (DPI) - setHorizontalResolution（および対応する setVerticalResolution）は、出力画像のピクセル密度を制御します。値が高いほど、ファイルサイズの増加を犠牲にして、より鮮明な画像になります。

options.setHorizontalResolution(72f);

これらの設定は、API リファレンスに記載されています。

複数ページの変換

上記の例はドキュメントの最初のページのみをレンダリングします。すべてのページを個別の画像としてエクスポートするには、ドキュメントのページ数をループし、各イテレーションで PageSet を更新します:

com.aspose.words.Document doc = new com.aspose.words.Document("Words.docx");
com.aspose.words.ImageSaveOptions options = new com.aspose.words.ImageSaveOptions(com.aspose.words.SaveFormat.JPEG);
options.setImageBrightness(0.3f);
options.setImageContrast(0.7f);
options.setHorizontalResolution(72f);

int pageCount = doc.getPageCount();
for (int page = 0; page < pageCount; page++) {
    options.setPageSet(new com.aspose.words.PageSet(page));
    doc.save(String.format("Word-to-JPG-page_%d.jpg", page + 1), options);
}

ループ内で同じ Document と ImageSaveOptions インスタンスを再利用することで、メモリ使用量を抑え、各ページごとにファイルを再読み込みするオーバーヘッドを回避できます。

高品質画像出力のための実用的なヒント

• 同じ ImageSaveOptions インスタンスを再利用 して、すべてのページで不要なオブジェクト生成を避けます。
• ストリーミング方式でファイルを処理（例: InputStream を使用）し、大きなドキュメントでもメモリ使用量を抑えます。
• 適切な解像度を選択：Web プレビューには 72 DPI で十分で、印刷品質の出力には 300 DPI が推奨されます。
• 明るさとコントラストは控えめに調整 - 小さな調整（デフォルト 0.5 から ±0.1–0.2）で、極端な値よりも可読性が保たれやすいです。
• 変換前に出力パスを検証 して IOException を防ぎ、対象ディレクトリが存在することを確認します。

結論

Conholdate.Total for Java は、Java で Word を画像に変換することを簡単にし、サーバー上で Microsoft Office を必要とせずに高忠実度の JPG ページを提供します。上記の手順に従うことで、任意の Java アプリケーションにドキュメントから画像への変換を統合でき、明るさ、コントラスト、解像度を微調整し、リソース消費を抑えることができます。本番環境での導入には商用ライセンスが必要です。価格の詳細は 価格ページ にあり、一時ライセンスページ から取得できます。

よくある質問

Word文書が多数ページを含む場合、JavaでWordを画像に変換するにはどうすればよいですか？
doc.getPageCount() をループし、各イテレーションで options.setPageSet(new PageSet(page)) を更新し、ページごとに別々の画像ファイルを保存します。上記の Converting Multiple Pages セクションに示されています。

Word を JPEG ではなく直接 PNG に変換することは可能ですか？ はい。ImageSaveOptions を作成するときに com.aspose.words.SaveFormat.JPEG を com.aspose.words.SaveFormat.PNG に変更してください。

変換時に元のレイアウトとフォントを保持できますか？ SDK はデフォルトで元のレイアウト、色、フォントを埋め込みます。カスタムフォントを埋め込む必要がある場合は、サーバー上で利用可能であることを確認してください（ドキュメント を参照）。

商用プロジェクトにはどのライセンスモデルを選択すべきですか？ 永続ライセンスまたはサブスクリプションライセンスは価格ページから購入できます。評価用の一時ライセンスは一時ライセンスページから入手可能です。

さらに読む

• Javaで画像をグレースケールに変換
• JavaでWordをPDFに変換
• JavaでCDRをPNGに変換