Das programmatische Drehen von Bildern ist ein häufiger Bedarf beim Erstellen von Vorschaugeneratoren, Fotobearbeitungsprogrammen oder Dokumenten‑Workflows. Conholdate.Total for Java bietet ein robustes SDK, das die Bildbearbeitung in Java‑Anwendungen unkompliziert macht. In diesem Leitfaden lernen Sie, wie Sie PNG und JPG Dateien drehen, Rotationsparameter konfigurieren und Metadaten erhalten, während die Bildqualität hoch bleibt.

Umgebungsvorbereitung - Voraussetzungen und Einrichtung

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

  • Java 17 oder neuer installiert.
  • Eine IDE wie IntelliJ IDEA oder Eclipse.
  • Maven für die Abhängigkeitsverwaltung.

Fügen Sie das Conholdate Maven-Repository und die SDK-Abhängigkeit zu Ihrer pom.xml hinzu:

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

Laden Sie die neuesten SDK‑Binärdateien von der offiziellen Download‑Seite herunter: Conholdate.Total for Java Download. Sobald die Abhängigkeiten aufgelöst sind, können Sie Code schreiben, der Bilder dreht.

Bild in Java drehen: Schritt‑für‑Schritt‑Anleitung

Schritt 1: Quell- und Zielpfade laden

Definieren Sie die Eingabe‑ und Ausgabepfade der Dateien. Das SDK unterstützt sowohl PNG‑ als auch JPG‑Formate.

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

Schritt 2: Initialisieren des Konvertierungs-Handlers und der Optionen

Erstellen Sie die Kernobjekte, die den Konvertierungsprozess steuern.

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

Schritt 3: Rotationswinkel und Hintergrundfarbe festlegen

Geben Sie an, um wie viele Grad das Bild gedreht werden soll, und die Füllfarbe für die leeren Ecken.

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

Schritt 4: Zusätzliche Parameter konfigurieren

Behalte die ursprünglichen Metadaten bei und definiere die JPEG Qualität, wenn die Ausgabe JPG ist.

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

Schritt 5: Rotation ausführen

Rufen Sie die convert-Methode auf, um die Rotation anzuwenden und das Ergebnis zu schreiben.

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

Weitere Details zur Klasse ConversionHandler finden Sie in der offiziellen API‑Referenz.

Vollständiges Codebeispiel: Bild in Java mit Conholdate.Total drehen

Das folgende Beispiel demonstriert den vollständigen Arbeitsablauf zum Drehen einer Bilddatei.

Dieses Beispiel zeigt, wie man ein JPG‑Bild um 90 Grad dreht und das Ergebnis speichert.

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

Hinweis: Dieses Codebeispiel demonstriert die Kernfunktionalität. Bevor Sie es in Ihrem Projekt verwenden, stellen Sie sicher, dass Sie alle Dateipfade und Konfigurationswerte an Ihre tatsächliche Umgebung anpassen, überprüfen Sie, dass alle erforderlichen Abhängigkeiten ordnungsgemäß installiert sind, und testen Sie gründlich in Ihrer Entwicklungsumgebung. Wenn Sie auf Probleme stoßen, lesen Sie bitte die offizielle Dokumentation oder wenden Sie sich an das Support-Team für Unterstützung.

Rotationsparameter: Optionen und Einstellungen

Das SDK bietet mehrere Optionen, um den Rotationsvorgang fein abzustimmen.

  • Rotate Angle - Bestimmt, um wie viele Grad das Bild gedreht wird. Positive Werte drehen im Uhrzeigersinn.
options.setRotateAngle(90);

  • Background Color - Legt die Füllfarbe für die leeren Ecken fest, die nach einer Drehung erscheinen. Verwenden Sie einen beliebigen java.awt.Color-Wert.

  • Metadaten beibehalten - Wenn aktiviert, werden EXIF Daten, DPI und andere Metadaten in der Ausgabedatei beibehalten. Siehe die ImageConvertOptions API für weitere Details.

  • Quality - Steuert die JPEG‑Komprimierungsqualität (0‑100). Höhere Werte erhalten mehr Details, erhöhen jedoch die Dateigröße.

Passen Sie diese Einstellungen an die Anforderungen Ihrer Anwendung an, egal ob Sie verlustfreie PNG‑Ausgabe oder hochwertige JPG‑Ergebnisse benötigen.

Fazit

Das Drehen von Bildern in Java ist einfach, wenn Sie Conholdate.Total for Java verwenden. Dieser Leitfaden führt Sie durch die erforderliche Einrichtung, eine detaillierte Schritt‑für‑Schritt‑Implementierung und die wichtigsten Konfigurationsoptionen, mit denen Sie Winkel, Hintergrund, Metadaten‑Erhaltung und Ausgabequalität steuern können. Denken Sie daran, für Produktionsbereitstellungen eine gültige Lizenz zu erwerben; Sie können die Preisoptionen unter https://purchase.conholdate.com/pricing/total/family/ einsehen oder eine temporäre Lizenz zum Testen unter https://purchase.conholdate.com/temporary-license/ erhalten. Mit dem integrierten SDK können Sie eine zuverlässige Bildrotation in jeden Java‑basierten Workflow einbinden.

FAQs

  • Wie kann ich eine Bilddatei in Java mit Conholdate.Total drehen?
    Verwenden Sie die Klasse ImageConvertOptions, um den gewünschten Rotationswinkel festzulegen, und rufen Sie dann handler.convert(inputPath, outputPath, options) wie in den obigen Beispielen gezeigt auf.

  • Kann ich sowohl PNG- als auch JPG-Bilder mit demselben Code drehen?
    Ja, das SDK erkennt das Quellformat automatisch. Geben Sie die richtige Dateierweiterung im Eingabepfad an, und derselbe Code funktioniert sowohl für PNG als auch für JPG.

  • Welche Optionen stehen zur Verfügung, um den Rotationsvorgang anzupassen?
    Sie können den Rotationswinkel, die Hintergrundfarbe, die Ausgabequalität anpassen und wählen, ob Metadaten erhalten bleiben sollen. Weitere Informationen finden Sie in der ImageConvertOptions API.

  • Benötige ich eine Lizenz, um diese Funktion in der Produktion zu verwenden?
    Für die Nutzung in der Produktion ist eine gültige Lizenz erforderlich. Sie können eine temporäre Lizenz für die Evaluierung unter https://purchase.conholdate.com/temporary-license/ erhalten oder die vollständigen Preisinformationen unter https://purchase.conholdate.com/pricing/total/family/ einsehen.

Mehr lesen