La rotation d’images par programme est un besoin fréquent lors de la création de générateurs d’aperçus, d’éditeurs photo ou de flux de travail documentaires. Conholdate.Total for Java fournit un SDK robuste qui rend la manipulation d’images simple dans les applications Java. Dans ce guide, vous apprendrez comment faire pivoter les fichiers PNG et JPG, configurer les paramètres de rotation et préserver les métadonnées tout en conservant une haute qualité d’image.

Préparation de l’environnement - Prérequis et configuration

Avant de commencer, assurez‑vous d’avoir les éléments suivants :

  • Java 17 ou version plus récente installé.
  • Un IDE tel que IntelliJ IDEA ou Eclipse.
  • Maven pour la gestion des dépendances.

Ajoutez le référentiel Maven Conholdate et la dépendance SDK à votre 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>

Téléchargez les derniers binaires du SDK depuis la page de téléchargement officielle : Conholdate.Total for Java Download. Une fois les dépendances résolues, vous êtes prêt à écrire du code qui fait pivoter les images.

Faire pivoter une image en Java : guide étape par étape

Étape 1 : charger les chemins source et destination

Définissez les emplacements des fichiers d’entrée et de sortie. Le SDK fonctionne avec les formats PNG et JPG.

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

Étape 2 : Initialiser le gestionnaire de conversion et les options

Créez les objets principaux qui pilotent le processus de conversion.

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

Étape 3 : définir l’angle de rotation et la couleur d’arrière‑plan

Spécifiez le nombre de degrés de rotation de l’image et la couleur de remplissage des coins vides.

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

Étape 4 : Configurer les paramètres supplémentaires

Conservez les métadonnées d’origine et définissez la qualité JPEG lorsque la sortie est JPG.

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

Étape 5 : Exécuter la rotation

Appelez la méthode convert pour appliquer la rotation et écrire le résultat.

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

Pour plus de détails sur la classe ConversionHandler, consultez la référence API officielle.

Exemple complet de code : Faire pivoter une image en Java avec Conholdate.Total

L’exemple suivant démontre le flux de travail complet pour faire pivoter un fichier image.

Cet exemple montre comment faire pivoter une image JPG de 90 degrés et enregistrer le résultat.

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

Remarque : Cet exemple de code démontre la fonctionnalité principale. Avant de l’utiliser dans votre projet, assurez‑vous de mettre à jour tous les chemins de fichiers et les valeurs de configuration pour qu’ils correspondent à votre environnement réel, vérifiez que toutes les dépendances requises sont correctement installées et testez soigneusement dans votre environnement de développement. Si vous rencontrez des problèmes, veuillez consulter la documentation officielle ou contacter l’équipe de support pour obtenir de l’aide.

Paramètres de rotation : options et réglages

Le SDK propose plusieurs options pour affiner le processus de rotation.

  • Angle de rotation - Détermine le nombre de degrés de rotation de l’image. Les valeurs positives font pivoter dans le sens des aiguilles d’une montre.
options.setRotateAngle(90);

  • Couleur d’arrière-plan - Définit la couleur de remplissage des coins vides qui apparaissent après la rotation. Utilisez n’importe quelle valeur java.awt.Color.

  • Conserver les métadonnées - Lorsqu’elle est activée, les données EXIF, le DPI et d’autres métadonnées sont conservés dans le fichier de sortie. Voir l’API ImageConvertOptions pour plus de détails.

  • Qualité - Contrôle la qualité de compression JPEG (0‑100). Des valeurs plus élevées conservent plus de détails mais augmentent la taille du fichier.

Ajustez ces paramètres pour correspondre aux exigences de votre application, que vous ayez besoin d’une sortie PNG sans perte ou de résultats JPG de haute qualité.

Conclusion

Faire pivoter des images en Java est simple lorsque vous utilisez Conholdate.Total for Java. Ce guide vous a accompagné à travers la configuration requise, une implémentation détaillée étape par étape, et les principales options de configuration qui vous permettent de contrôler l’angle, l’arrière‑plan, la préservation des métadonnées et la qualité de sortie. N’oubliez pas d’obtenir une licence appropriée pour les déploiements en production ; vous pouvez explorer les options de tarification à https://purchase.conholdate.com/pricing/total/family/ ou obtenir une licence temporaire pour les tests à https://purchase.conholdate.com/temporary-license/. Avec le SDK intégré, vous pouvez ajouter une rotation d’image fiable à tout flux de travail basé sur Java.

FAQ

  • Comment faire pivoter un fichier image en Java avec Conholdate.Total ?
    Utilisez la classe ImageConvertOptions pour définir l’angle de rotation souhaité, puis appelez handler.convert(inputPath, outputPath, options) comme indiqué dans les exemples ci‑dessus.

  • Puis-je faire pivoter à la fois les images PNG et JPG avec le même code ?
    Oui, le SDK détecte automatiquement le format source. Fournissez la bonne extension de fichier dans le chemin d’entrée et le même code fonctionne pour les PNG et JPG.

  • Quelles options sont disponibles pour personnaliser le processus de rotation ?
    Vous pouvez ajuster l’angle de rotation, la couleur d’arrière-plan, la qualité de sortie, et choisir de conserver les métadonnées. Reportez-vous à l’API ImageConvertOptions API pour la liste complète.

  • Ai-je besoin d’une licence pour utiliser cette fonctionnalité en production ?
    Une licence valide est requise pour une utilisation en production. Obtenez une licence temporaire pour l’évaluation à https://purchase.conholdate.com/temporary-license/ ou consultez les détails complets des tarifs à https://purchase.conholdate.com/pricing/total/family/.

En savoir plus