プレビュー生成ツール、写真エディタ、またはドキュメントワークフローを構築する際、プログラムで画像を回転させる必要が頻繁にあります。Conholdate.Total for Java は、Java アプリケーションで画像操作を簡単に行える堅牢な SDK を提供します。このガイドでは、PNG および JPG ファイルの回転方法、回転パラメータの設定、メタデータの保持と高品質な画像を保つ方法を学びます。

環境の準備 - 前提条件とセットアップ

開始する前に、以下のものが揃っていることを確認してください:

  • Java 17 以上がインストールされている。
  • IntelliJ IDEA や Eclipse などの IDE。
  • 依存関係管理のための Maven。

Conholdate Maven リポジトリと SDK 依存関係を 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 バイナリをダウンロードしてください: Conholdate.Total for Java ダウンロード。依存関係が解決したら、画像を回転させるコードを書く準備が整います。

Javaで画像を回転させる: ステップバイステップの手順

ステップ 1: ソースと宛先のパスをロードする

入力ファイルと出力ファイルの場所を定義します。SDKはPNGおよびJPG形式の両方に対応しています。

String inputPath = "input.jpg";
String outputPath = "output_rotated.jpg";

ステップ 2: 変換ハンドラとオプションの初期化

変換プロセスを駆動するコアオブジェクトを作成します。

ConversionHandler handler = new ConversionHandler();
ImageConvertOptions options = new ImageConvertOptions();

ステップ 3: 回転角度と背景色の設定

画像を回転させる角度と、空白のコーナーの塗りつぶし色を指定します。

options.setRotateAngle(90);               // Rotate 90 degrees clockwise
options.setBackgroundColor(Color.WHITE);  // Fill empty space with white

ステップ 4: 追加パラメータの構成

元のメタデータを保持し、出力が JPG の場合は JPEG の品質を定義します。

options.setPreserveMetadata(true);
options.setQuality(90); // JPEG quality (0‑100)

ステップ 5: 回転を実行する

回転を適用し、結果を書き込むために convert メソッドを呼び出します。

handler.convert(inputPath, outputPath, options);
System.out.println("Image rotated successfully: " + outputPath);

ConversionHandler クラスの詳細については、公式 API リファレンス を参照してください。

完全なコード例: Conholdate.Total を使用した Java での画像回転

以下の例は、画像ファイルを回転させるフルワークフローを示しています。

この例では、JPG画像を90度回転させ、結果を保存する方法を示します。

import com.groupdocs.conversion.ConversionHandler;
import com.groupdocs.conversion.options.convert.ImageConvertOptions;
import java.awt.Color;

public class RotateImageExample {
    public static void main(String[] args) {
        String inputPath = "input.jpg";
        String outputPath = "output_rotated.jpg";

try (ConversionHandler handler = new ConversionHandler()) {
            ImageConvertOptions options = new ImageConvertOptions();
            // Rotation angle in degrees (positive = clockwise)
            options.setRotateAngle(90);
            // Background color for empty areas after rotation
            options.setBackgroundColor(Color.WHITE);
            // Preserve original metadata (EXIF, DPI, etc.)
            options.setPreserveMetadata(true);
            // Optional: for large images you can limit memory usage
            options.setQuality(90); // JPEG quality (0-100)

handler.convert(inputPath, outputPath, options);
            System.out.println("Image rotated successfully: " + outputPath);
        } catch (Exception e) {
            System.err.println("Error during image rotation:");
            e.printStackTrace();
        }
    }
}

注: このコード例はコア機能を示しています。プロジェクトで使用する前に、ファイルパスや設定値が実際の環境に合わせて更新されていることを確認し、必要な依存関係がすべて正しくインストールされているか検証し、開発環境で徹底的にテストしてください。問題が発生した場合は、公式ドキュメント を参照するか、サポートチーム にお問い合わせください。

回転パラメータ: オプションと設定

SDK は回転プロセスを微調整するためのいくつかのオプションを提供します。

  • Rotate Angle - 画像が回転する角度（度）を決定します。正の値は時計回りに回転します。
options.setRotateAngle(90);

  • Background Color - 回転後に現れる空白の角の塗りつぶし色を設定します。任意の java.awt.Color 値を使用してください。

  • メタデータの保持 - 有効にすると、EXIF データ、DPI、その他のメタデータが出力ファイルに保持されます。詳細については、ImageConvertOptions API をご覧ください。

  • Quality - JPEG圧縮品質を制御します (0‑100)。値が高いほど詳細が保持されますが、ファイルサイズが大きくなります。

アプリケーションの要件に合わせてこれらの設定を調整してください。ロスレス PNG 出力が必要な場合や高品質 JPG 結果が必要な場合に最適です。

結論

Javaで画像を回転させるのは、Conholdate.Total for Java を使用すれば簡単です。このガイドでは、必要なセットアップ、詳細なステップバイステップの実装、および角度、背景、メタデータの保持、出力品質を制御できる主要な構成オプションについて説明します。本番環境での展開には適切なライセンスを取得することを忘れないでください。価格オプションは https://purchase.conholdate.com/pricing/total/family/ で確認でき、テスト用の一時ライセンスは https://purchase.conholdate.com/temporary-license/ から取得できます。SDK を統合すれば、あらゆる Java ベースのワークフローに信頼性の高い画像回転機能を追加できます。

よくある質問

  • JavaでConholdate.Totalを使用して画像ファイルを回転させるにはどうすればよいですか？
    ImageConvertOptions クラスを使用して目的の回転角度を設定し、上記の例に示すように handler.convert(inputPath, outputPath, options) を呼び出します。

  • 同じコードで PNG と JPG の画像の両方を回転させることはできますか？
    はい、SDK は自動的にソース形式を検出します。入力パスに正しいファイル拡張子を指定すれば、同じコードが PNG と JPG の両方で機能します。

  • 回転プロセスをカスタマイズするために利用できるオプションは何ですか？
    回転角度、背景色、出力品質を調整し、メタデータを保持するかどうかを選択できます。完全な一覧については、ImageConvertOptions API を参照してください。

  • 本機能を本番環境で使用するにはライセンスが必要ですか？
    本番環境での使用には有効なライセンスが必要です。評価用の一時ライセンスは https://purchase.conholdate.com/temporary-license/ で取得でき、完全な価格詳細は https://purchase.conholdate.com/pricing/total/family/ で確認できます。

さらに読む