Comment fusionner des images verticalement avec GroupDocs.Merger pour Java

Dans ce guide étape par étape, vous allez créer un collage photo vertical en fusionnant plusieurs images en une seule image haute à l’aide de GroupDocs.Merger pour Java. Que vous ayez besoin d’une bannière adaptée au défilement, d’une annexe de rapport ou d’un simple collage, ce tutoriel explique pourquoi la fusion verticale est importante, montre les appels d’API exacts et vous donne des conseils pratiques pour maintenir une faible utilisation de la mémoire.

Réponses rapides

  • Quelle bibliothèque puis‑je utiliser ? GroupDocs.Merger for Java.
  • Puis‑je joindre plus de trois images ? Oui – ajoutez autant que vous le souhaitez.
  • Quels formats d’image sont pris en charge ? PNG, BMP, JPG et d’autres formats statiques courants.
  • Ai‑je besoin d’une licence pour le développement ? Un essai gratuit suffit pour les tests ; une licence payante est requise pour la production.
  • Le processus est‑il efficace en mémoire ? Chargez uniquement les images nécessaires et enregistrez rapidement pour garder une faible utilisation de la mémoire.

Qu’est‑ce que la fusion d’images ?

La fusion d’images est la technique consistant à combiner deux fichiers image ou plus en une seule image composite. Lorsque les images sont empilées verticalement, le résultat ressemble à une bande photo haute — parfait pour un collage photo vertical ou l’assemblage de sections visuelles d’un rapport.

Pourquoi utiliser GroupDocs.Merger pour Java ?

GroupDocs.Merger pour Java vous permet de joindre plusieurs images verticalement avec seulement quelques lignes de code. Il prend en charge plus de 50 formats d’image statiques, traite les fichiers en mémoire sans créer de fichiers temporaires, et peut gérer des documents de plusieurs centaines de pages tout en restant sous 200 Mo de mémoire heap sur un serveur typique.

Prérequis

  • Java Development Kit (JDK) 8 ou plus récent.
  • Un IDE tel qu’IntelliJ IDEA ou Eclipse.
  • Maven ou Gradle pour la gestion des dépendances.
  • Une connaissance de base de la syntaxe Java (pas besoin de connaissances approfondies en traitement d’image).

Configuration de GroupDocs.Merger pour Java

Utilisation de Maven

Ajoutez la dépendance à votre fichier pom.xml :

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-merger</artifactId>
    <version>latest-version</version>
</dependency>

Utilisation de Gradle

Incluez la bibliothèque dans votre fichier build.gradle :

implementation 'com.groupdocs:groupdocs-merger:latest-version'

Téléchargement direct

Alternativement, vous pouvez télécharger la dernière version depuis GroupDocs.Merger for Java releases.

Étapes d’obtention de licence

  1. Essai gratuit – explorez toutes les fonctionnalités sans frais.
  2. Licence temporaire – obtenez une clé à court terme pour des tests prolongés.
  3. Achat – achetez une licence permanente pour une utilisation en production.

Une fois la bibliothèque ajoutée, importez la classe principale dans votre fichier Java :

import com.groupdocs.merger.Merger;

Comment fusionner des images verticalement

Chargez vos images sources, indiquez à l’API d’utiliser une disposition verticale, ajoutez chaque image et enregistrez le résultat. Ce schéma en quatre étapes vous permet de créer un collage photo vertical avec un code minimal et des performances optimales.

Étape 1 : définir les chemins et initialiser le merger

Tout d’abord, indiquez à la bibliothèque le chemin de votre image source et décidez où le résultat fusionné sera enregistré.

String filePath = "YOUR_DOCUMENT_DIRECTORY/SAMPLE_PNG";
String filePathOut = new File("YOUR_OUTPUT_DIRECTORY", 
    "CrossJoinMultipleDocuments-" + Paths.get(filePath).getFileName().toString()).getPath();

// Initialize Merger with the first image file.
Merger merger = new Merger(filePath);

Étape 2 : configurer les options de jointure

Indiquez à GroupDocs.Merger que vous souhaitez une disposition verticale.

ImageJoinOptions imageJoinOptions = new ImageJoinOptions(ImageJoinMode.Vertical);

Étape 3 : ajouter des images supplémentaires

Utilisez la méthode join pour chaque image supplémentaire que vous souhaitez empiler sous la précédente.

merger.join("YOUR_DOCUMENT_DIRECTORY/SAMPLE_BMP", imageJoinOptions); // Second image.
merger.join("YOUR_DOCUMENT_DIRECTORY/SAMPLE_JPG", imageJoinOptions); // Third image.

Vous pouvez répéter cet appel autant de fois que nécessaire pour ajouter des images au fichier et créer un long collage vertical.

Étape 4 : enregistrer l’image fusionnée

Enfin, écrivez l’image combinée sur le disque.

merger.save(filePathOut);

Résultat attendu

Le fichier de sortie contiendra toutes les images fournies alignées les unes après les autres de haut en bas, formant une seule image haute qui peut être utilisée dans des rapports, des présentations ou des galeries web.

Problèmes courants et solutions

  • Chemins de fichiers incorrects – vérifiez que chaque chemin pointe vers une image existante et que votre application possède les permissions de lecture/écriture.
  • Format non pris en charge – assurez‑vous que le type d’image fait partie des formats statiques pris en charge (PNG, BMP, JPG). Les GIF animés ne sont pas traités par cette fonctionnalité.
  • Erreurs de mémoire insuffisante – lors de la fusion de nombreuses images haute résolution, envisagez de les redimensionner avant la jointure ou augmentez la taille du heap JVM (drapeau -Xmx).

Applications pratiques

Cas d’utilisationComment cela aide
Créer un collage photo verticalCombinez les photos de vacances en une seule image défilable.
Assembler des sections visuelles de rapportFusionnez graphiques, diagrammes et captures d’écran pour une exportation PDF unifiée.
Préparer des éléments marketingEmpilez les images de produits pour une bannière web élégante et adaptée au défilement.

Conseils de performance

  • Chargez uniquement les images dont vous avez besoin à la fois ; libérez les références après save pour permettre au ramasse‑miettes de libérer la mémoire.
  • Utilisez un stockage SSD pour les dossiers source et de destination afin d’accélérer les entrées/sorties.
  • Lors du traitement de gros lots, exécutez la fusion dans un thread en arrière‑plan pour garder l’interface réactive.

Conclusion

Vous disposez maintenant d’une solution complète, étape par étape, pour fusionner des images verticalement en utilisant GroupDocs.Merger pour Java. Expérimentez avec différents ensembles d’images, essayez d’autres modes de jointure (horizontal, grille), et intégrez cette logique dans des pipelines d’automatisation plus vastes.

Étapes suivantes

  • Explorez l’option ImageJoinMode.Horizontal pour des collages côte à côte.
  • Combinez l’image fusionnée avec la génération de PDF en utilisant GroupDocs.PDF pour une création de document de bout en bout.

Questions fréquemment posées

Q : Quels formats d’image puis‑je combiner avec cette méthode ?
R : PNG, BMP, JPG et d’autres formats statiques courants sont pris en charge.

Q : Y a‑t‑il une limite au nombre d’images que je peux joindre ?
R : Aucun plafond strict ; la limite pratique est la disponibilité de la mémoire. Ajoutez les images séquentiellement avec join.

Q : Mon fichier de sortie est trop volumineux—que puis‑je faire ?
R : Redimensionnez ou compressez les images sources avant la fusion, ou utilisez ImageIO de Java pour réduire la qualité.

Q : Puis‑je fusionner des GIF animés verticalement ?
R : L’API actuelle se concentre sur les images statiques ; les GIF animés ne sont pas pris en charge pour la jointure verticale.

Q : Comment obtenir une licence de production ?
R : Achetez une licence via le portail GroupDocs ; une licence temporaire est disponible pour les tests.

Dernière mise à jour : 2026-08-15
Testé avec : dernière version de GroupDocs.Merger (en 2026)
Auteur : GroupDocs

Ressources

Tutoriels associés