La rotazione delle immagini in modo programmatico è una necessità frequente quando si creano generatori di anteprime, editor fotografici o flussi di lavoro documentali. Conholdate.Total for Java fornisce un SDK robusto che rende la manipolazione delle immagini semplice nelle applicazioni Java. In questa guida imparerai come ruotare i file PNG e JPG, configurare i parametri di rotazione e preservare i metadati mantenendo alta la qualità dell’immagine.

Preparazione dell’ambiente - Prerequisiti e configurazione

Prima di iniziare, assicurati di avere quanto segue:

  • Java 17 o versioni più recenti installato.
  • Un IDE come IntelliJ IDEA o Eclipse.
  • Maven per la gestione delle dipendenze.

Aggiungi il repository Maven di Conholdate e la dipendenza SDK al tuo 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>

Scarica gli ultimi binari SDK dalla pagina di download ufficiale: Conholdate.Total for Java Download. Una volta risolte le dipendenze, sei pronto a scrivere codice che ruota le immagini.

Ruota immagine in Java: Guida passo-passo

Passo 1: Carica i percorsi di origine e destinazione

Definisci le posizioni dei file di input e output. L’SDK funziona con i formati PNG e JPG.

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

Passo 2: Inizializzare il gestore di conversione e le opzioni

Crea gli oggetti principali che guidano il processo di conversione.

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

Passo 3: Imposta l’angolo di rotazione e il colore di sfondo

Specifica quanti gradi ruotare l’immagine e il colore di riempimento per gli angoli vuoti.

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

Passo 4: Configura parametri aggiuntivi

Mantieni i metadati originali e definisci la qualità JPEG quando l’output è JPG.

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

Passo 5: Esegui la rotazione

Chiama il metodo convert per applicare la rotazione e scrivere il risultato.

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

Per ulteriori dettagli sulla classe ConversionHandler, fare riferimento alla documentazione API ufficiale.

Esempio di Codice Completo: Ruotare l’Immagine in Java Utilizzando Conholdate.Total

Il seguente esempio dimostra il flusso di lavoro completo per ruotare un file immagine.

Questo esempio dimostra come ruotare un’immagine JPG di 90 gradi e salvare il risultato.

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

Nota: Questo esempio di codice dimostra la funzionalità principale. Prima di utilizzarlo nel tuo progetto, assicurati di aggiornare tutti i percorsi dei file e i valori di configurazione per corrispondere al tuo ambiente reale, verifica che tutte le dipendenze richieste siano installate correttamente e testa accuratamente nel tuo ambiente di sviluppo. Se riscontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Parametri di rotazione: opzioni e impostazioni

L’SDK offre diverse opzioni per perfezionare il processo di rotazione.

  • Angolo di rotazione - Determina quanti gradi l’immagine è ruotata. I valori positivi ruotano in senso orario.
options.setRotateAngle(90);

  • Colore di sfondo - Imposta il colore di riempimento per gli angoli vuoti che appaiono dopo la rotazione. Usa qualsiasi valore java.awt.Color.

  • Preservare i metadati - Quando abilitato, i dati EXIF, DPI e altri metadati vengono mantenuti nel file di output. Vedi l’API ImageConvertOptions per ulteriori dettagli.

  • Quality - Controlla la qualità della compressione JPEG (0‑100). Valori più alti conservano più dettagli ma aumentano le dimensioni del file.

Regola queste impostazioni per soddisfare i requisiti della tua applicazione, sia che tu abbia bisogno di un output PNG senza perdita di qualità o di risultati JPG ad alta qualità.

Conclusione

Ruotare le immagini in Java è semplice quando si utilizza Conholdate.Total for Java. Questa guida ti ha accompagnato nella configurazione necessaria, in un’implementazione dettagliata step‑by‑step e nelle principali opzioni di configurazione che ti consentono di controllare l’angolo, lo sfondo, la conservazione dei metadati e la qualità dell’output. Ricorda di acquisire una licenza adeguata per le distribuzioni in produzione; puoi esplorare le opzioni di prezzo su https://purchase.conholdate.com/pricing/total/family/ o ottenere una licenza temporanea per i test su https://purchase.conholdate.com/temporary-license/. Con l’SDK integrato, puoi aggiungere una rotazione affidabile delle immagini a qualsiasi flusso di lavoro basato su Java.

FAQs

  • Come ruoto un file immagine in Java usando Conholdate.Total?
    Utilizza la classe ImageConvertOptions per impostare l’angolo di rotazione desiderato e quindi chiama handler.convert(inputPath, outputPath, options) come mostrato negli esempi sopra.

  • Posso ruotare sia le immagini PNG che JPG con lo stesso codice?
    Sì, l’SDK rileva automaticamente il formato di origine. Fornisci l’estensione file corretta nel percorso di input e lo stesso codice funziona sia per PNG che per JPG.

  • Quali opzioni sono disponibili per personalizzare il processo di rotazione?
    È possibile regolare l’angolo di rotazione, il colore di sfondo, la qualità di output e scegliere se conservare i metadati. Consulta l’ImageConvertOptions API per l’elenco completo.

  • Ho bisogno di una licenza per utilizzare questa funzionalità in produzione?
    È necessaria una licenza valida per l’uso in produzione. Ottieni una licenza temporanea per la valutazione su https://purchase.conholdate.com/temporary-license/ o visualizza i dettagli completi dei prezzi su https://purchase.conholdate.com/pricing/total/family/.

Leggi di più