Görüntüleri programlı olarak döndürmek, önizleme oluşturucular, fotoğraf düzenleyiciler veya belge iş akışları oluştururken sık karşılaşılan bir ihtiyaçtır. Conholdate.Total for Java güçlü bir SDK sunar ve Java uygulamalarında görüntü işleme işlemlerini basitleştirir. Bu rehberde, PNG ve JPG dosyalarını nasıl döndüreceğinizi, döndürme parametrelerini nasıl yapılandıracağınızı ve görüntü kalitesini yüksek tutarken meta verileri nasıl koruyacağınızı öğreneceksiniz.

Ortam Hazırlığı - Önkoşullar ve Kurulum

Başlamadan önce, aşağıdakilere sahip olduğunuzdan emin olun:

  • Java 17 veya daha yeni bir sürüm yüklü.
  • IntelliJ IDEA veya Eclipse gibi bir IDE.
  • Bağımlılık yönetimi için Maven.

Conholdate Maven deposunu ve SDK bağımlılığını pom.xml dosyanıza ekleyin:

<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>

En son SDK ikili dosyalarını resmi indirme sayfasından indirin: Conholdate.Total for Java Download. Bağımlılıklar çözüldükten sonra, görüntüleri döndüren kodu yazmaya hazırsınız.

Java’da Görüntüyü Döndürme: Adım Adım Kılavuz

Adım 1: Kaynak ve Hedef Yollarını Yükle

Giriş ve çıkış dosya konumlarını tanımlayın. SDK, PNG ve JPG formatlarını her ikisini de destekler.

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

Adım 2: Dönüştürme İşleyicisini ve Seçenekleri Başlat

Dönüştürme sürecini yöneten temel nesneleri oluşturun.

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

Adım 3: Döndürme Açısını ve Arka Plan Rengini Ayarlayın

Görüntünün kaç derece döndürüleceğini ve boş köşeler için doldurma rengini belirtin.

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

Adım 4: Ek Parametreleri Yapılandırın

Orijinal meta verileri koruyun ve çıktı JPG olduğunda JPEG kalitesini tanımlayın.

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

Adım 5: Döndürmeyi Yürütme

Döndürmeyi uygulamak ve sonucu yazmak için convert metodunu çağırın.

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

ConversionHandler sınıfı hakkında daha fazla ayrıntı için, resmi API referansına bakın.

Tam Kod Örneği: Java’da Conholdate.Total Kullanarak Görüntüyü Döndürme

Aşağıdaki örnek, bir görüntü dosyasını döndürme işlemi için tam iş akışını gösterir.

Bu örnek, bir JPG görüntüsünü 90 derece döndürüp sonucu kaydetmeyi gösterir.

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();
        }
    }
}

Not: Bu kod örneği temel işlevselliği gösterir. Projenizde kullanmadan önce, dosya yollarını ve yapılandırma değerlerini gerçek ortamınıza uygun şekilde güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi belgeler adresine bakın veya destek ekibi ile iletişime geçin.

Dönme Parametreleri: Seçenekler ve Ayarlar

SDK, dönüşüm sürecini ince ayar yapabilmek için çeşitli seçenekler sunar.

  • Döndürme Açısı - Görüntünün kaç derece döndürüleceğini belirler. Pozitif değerler saat yönünde döndürür.
options.setRotateAngle(90);

  • Arka Plan Rengi - Döndürme sonrası ortaya çıkan boş köşeler için doldurma rengini ayarlar. Herhangi bir java.awt.Color değeri kullanın.

  • Meta Verileri Koru - Etkinleştirildiğinde, EXIF verileri, DPI ve diğer meta veriler çıktı dosyasında tutulur. Daha fazla ayrıntı için ImageConvertOptions API sayfasına bakın.

  • Quality - JPEG sıkıştırma kalitesini (0‑100) kontrol eder. Daha yüksek değerler daha fazla ayrıntıyı korur ancak dosya boyutunu artırır.

Uygulamanızın gereksinimlerine uygun olarak bu ayarları düzenleyin; kayıpsız PNG çıktısı mı yoksa yüksek kaliteli JPG sonuçları mı gerektiğine göre.

Sonuç

Java’da görüntü döndürmek, Conholdate.Total for Java kullandığınızda basittir. Bu kılavuz, gerekli kurulumu, ayrıntılı adım adım uygulamayı ve açı, arka plan, meta veri koruması ve çıktı kalitesini kontrol etmenizi sağlayan temel yapılandırma seçeneklerini size gösterdi. Üretim dağıtımları için uygun bir lisans almayı unutmayın; fiyatlandırma seçeneklerini https://purchase.conholdate.com/pricing/total/family/ adresinde inceleyebilir veya test için geçici bir lisans alabilirsiniz: https://purchase.conholdate.com/temporary-license/. SDK entegre edildiğinde, herhangi bir Java tabanlı iş akışına güvenilir görüntü döndürme ekleyebilirsiniz.

SSS

  • Java’da Conholdate.Total kullanarak bir görüntü dosyasını nasıl döndürürüm?
    ImageConvertOptions sınıfını kullanarak istenen döndürme açısını ayarlayın ve ardından örneklerde gösterildiği gibi handler.convert(inputPath, outputPath, options) metodunu çağırın.

  • Aynı kodla hem PNG hem de JPG görüntülerini döndürebilir miyim?
    Evet, SDK kaynak formatı otomatik olarak algılar. Giriş yolunda doğru dosya uzantısını sağlayın ve aynı kod hem PNG hem de JPG için çalışır.

  • Döndürme işlemini özelleştirmek için hangi seçenekler mevcuttur?
    Döndürme açısını, arka plan rengini, çıktı kalitesini ayarlayabilir ve meta verileri koruyup korumayacağınızı seçebilirsiniz. Tam liste için ImageConvertOptions API adresine bakın.

  • Bu özelliği üretimde kullanmak için bir lisansa ihtiyacım var mı?
    Üretim kullanımı için geçerli bir lisans gereklidir. Değerlendirme için geçici bir lisans almak üzere https://purchase.conholdate.com/temporary-license/ adresini ziyaret edin veya tam fiyatlandırma detaylarını https://purchase.conholdate.com/pricing/total/family/ adresinde görüntüleyin.

Daha Fazla Oku