Het roteren van afbeeldingen via code is een veelvoorkomende behoefte bij het bouwen van preview‑generatoren, foto‑editors of document‑workflows. Conholdate.Total for Java biedt een robuuste SDK die beeldbewerking eenvoudig maakt in Java‑toepassingen. In deze gids leer je hoe je PNG‑ en JPG‑bestanden roteert, rotatie‑parameters configureert en metadata behoudt terwijl je de beeldkwaliteit hoog houdt.

Omgevingsvoorbereiding - Vereisten en installatie

Voordat u begint, zorg ervoor dat u het volgende heeft:

  • Java 17 of nieuwer geïnstalleerd.
  • Een IDE zoals IntelliJ IDEA of Eclipse.
  • Maven voor afhankelijkheidsbeheer.

Voeg de Conholdate Maven-repository en de SDK-afhankelijkheid toe aan uw 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>

Download de nieuwste SDK-binaries van de officiële downloadpagina: Conholdate.Total for Java Download. Zodra de afhankelijkheden zijn opgelost, ben je klaar om code te schrijven die afbeeldingen roteert.

Afbeelding roteren in Java: Stapsgewijze handleiding

Stap 1: Laad bron- en bestemmingspaden

Definieer de invoer- en uitvoerbestandslocaties. De SDK werkt met zowel PNG- als JPG-formaten.

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

Stap 2: Initialiseer Conversiehandler en Opties

Maak de kernobjecten aan die het conversieproces aansturen.

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

Stap 3: Stel rotatiehoek en achtergrondkleur in

Geef op hoeveel graden de afbeelding moet worden geroteerd en de vulkleur voor lege hoeken.

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

Stap 4: Configureer extra parameters

Behoud de oorspronkelijke metadata en definieer de JPEG kwaliteit wanneer de uitvoer JPG is.

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

Stap 5: Voer de rotatie uit

Roep de convert-methode aan om de rotatie toe te passen en het resultaat weg te schrijven.

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

Voor meer details over de ConversionHandler‑klasse, raadpleeg de officiële API‑referentie.

Volledig codevoorbeeld: Afbeelding roteren in Java met Conholdate.Total

Het volgende voorbeeld toont de volledige workflow voor het roteren van een afbeeldingsbestand.

Dit voorbeeld laat zien hoe je een JPG‑afbeelding 90 graden draait en het resultaat opslaat.

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

Opmerking: Dit codevoorbeeld toont de kernfunctionaliteit. Voordat u het in uw project gebruikt, moet u ervoor zorgen dat alle bestands‑paden en configuratiewaarden worden bijgewerkt zodat ze overeenkomen met uw werkelijke omgeving, controleren dat alle vereiste afhankelijkheden correct zijn geïnstalleerd, en grondig testen in uw ontwikkelomgeving. Als u problemen ondervindt, raadpleeg dan de officiële documentatie of neem contact op met het ondersteuningsteam voor hulp.

Rotatieparameters: Opties en Instellingen

De SDK biedt verschillende opties om het rotatieproces fijn af te stemmen.

  • Rotate Angle - Bepaalt hoeveel graden de afbeelding wordt gedraaid. Positieve waarden draaien met de klok mee.
options.setRotateAngle(90);

  • Background Color - Stelt de vulkleur in voor de lege hoeken die verschijnen na rotatie. Gebruik een willekeurige java.awt.Color waarde.

  • Metadata behouden - Wanneer ingeschakeld, blijven EXIF‑gegevens, DPI en andere metadata behouden in het uitvoerbestand. Zie de ImageConvertOptions API voor meer details.

  • Kwaliteit - Regelt de JPEG-compressiekwaliteit (0‑100). Hogere waarden behouden meer details maar vergroten de bestandsgrootte.

Pas deze instellingen aan om te voldoen aan de eisen van uw toepassing, of u nu lossless PNG‑uitvoer of hoge‑kwaliteit JPG‑resultaten nodig heeft.

Conclusie

Afbeeldingen roteren in Java is eenvoudig wanneer je Conholdate.Total for Java gebruikt. Deze gids leidt je door de vereiste installatie, een gedetailleerde stap‑voor‑stap implementatie, en de belangrijkste configuratie‑opties waarmee je de hoek, achtergrond, metadata‑behoud en uitvoerkwaliteit kunt regelen. Vergeet niet een juiste licentie aan te schaffen voor productie‑implementaties; je kunt de prijsopties bekijken op https://purchase.conholdate.com/pricing/total/family/ of een tijdelijke licentie verkrijgen voor testen op https://purchase.conholdate.com/temporary-license/. Met de geïntegreerde SDK kun je betrouwbare beeldrotatie toevoegen aan elke Java‑gebaseerde workflow.

Veelgestelde vragen

  • Hoe roteer ik een afbeeldingsbestand in Java met Conholdate.Total?
    Gebruik de ImageConvertOptions-klasse om de gewenste rotatiehoek in te stellen en roep vervolgens handler.convert(inputPath, outputPath, options) aan zoals getoond in de bovenstaande voorbeelden.

  • Kan ik zowel PNG- als JPG-afbeeldingen roteren met dezelfde code?
    Ja, de SDK detecteert automatisch het bronformaat. Geef de juiste bestandsextensie op in het invoerpad en dezelfde code werkt voor zowel PNG als JPG.

  • Welke opties zijn beschikbaar om het rotatieproces aan te passen?
    U kunt de rotatiehoek, achtergrondkleur, uitvoerkwaliteit aanpassen en kiezen of u metadata wilt behouden. Raadpleeg de ImageConvertOptions API voor de volledige lijst.

  • Heb ik een licentie nodig om deze functie in productie te gebruiken?
    Een geldige licentie is vereist voor gebruik in productie. Verkrijg een tijdelijke licentie voor evaluatie op https://purchase.conholdate.com/temporary-license/ of bekijk de volledige prijsdetails op https://purchase.conholdate.com/pricing/total/family/.

Lees meer