프로그래밍 방식으로 이미지를 회전하는 것은 미리보기 생성기, 사진 편집기 또는 문서 워크플로를 구축할 때 자주 필요한 작업입니다. 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 참조를 참조하십시오.

전체 코드 예제: Java에서 Conholdate.Total을 사용하여 이미지 회전

다음 예제는 이미지 파일을 회전하는 전체 워크플로를 보여줍니다.

이 예제는 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);

  • 배경 색상 - 회전 후 나타나는 빈 코너의 채우기 색상을 설정합니다. java.awt.Color 값을 사용하십시오.

  • Preserve Metadata - 활성화하면, EXIF 데이터, DPI 및 기타 메타데이터가 출력 파일에 보존됩니다. 자세한 내용은 ImageConvertOptions API를 참조하세요.

  • 품질 - 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 기반 워크플로우에 신뢰할 수 있는 이미지 회전을 추가할 수 있습니다.

FAQs

  • 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/ 에서 확인하십시오.

자세히 보기