如何使用 GroupDocs.Merger for Java 垂直合并图像

在本分步指南中，您将通过使用 GroupDocs.Merger for Java 将多张图像合并为一张高图，创建垂直照片拼贴。无论您需要滚动友好的横幅、报告附录，还是简单的拼贴，本教程都会解释垂直合并的意义，展示确切的 API 调用，并提供实用技巧以降低内存使用。

快速答案

  • 我可以使用哪个库？ GroupDocs.Merger for Java.
  • 我可以合并超过三张图像吗？ 是的 – 添加任意数量。
  • 支持哪些图像格式？ PNG, BMP, JPG, and other common static formats.
  • 开发是否需要许可证？ 免费试用可用于测试；生产环境需要付费许可证。
  • 该过程是否内存高效？ 仅加载所需图像并及时保存，以保持低内存使用。

什么是图像合并？

图像合并是一种将两个或多个独立图像文件组合成单个复合图像的技术。当图像 垂直 堆叠时，结果看起来像一条高长的照片条——非常适合 垂直照片拼贴 或组装报告的视觉章节。

为什么使用 GroupDocs.Merger for Java？

GroupDocs.Merger for Java 只需几行代码即可垂直合并多张图像。它支持 50+ 静态图像格式，在内存中处理文件而不创建临时文件，并且能够在典型服务器上保持堆内存低于 200 MB 的情况下处理数百页的文档。

前置条件

  • Java Development Kit (JDK) 8 或更高。
  • 如 IntelliJ IDEA 或 Eclipse 等 IDE。
  • 用于依赖管理的 Maven 或 Gradle。
  • 对 Java 语法有基本了解（无需深入的图像处理知识）。

设置 GroupDocs.Merger for Java

使用 Maven

将依赖添加到您的 pom.xml 文件中：

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

使用 Gradle

在您的 build.gradle 文件中包含该库：

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

直接下载

或者，您可以从 GroupDocs.Merger for Java releases 下载最新版本。

许可证获取步骤

  1. 免费试用 – 免费探索所有功能。
  2. 临时许可证 – 获取短期密钥以进行扩展测试。
  3. 购买 – 购买永久许可证用于生产环境。

库添加后，在您的 Java 文件中导入主类：

import com.groupdocs.merger.Merger;

如何垂直合并图像

加载源图片，告诉 API 使用垂直布局，逐个添加图片并保存结果。此四步模式可让您以最少的代码和最佳性能 创建垂直照片拼贴。

步骤 1：定义路径并初始化合并器

首先，将库指向您的源图像，并决定合并结果的保存位置。

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

步骤 2：配置合并选项

告诉 GroupDocs.Merger 您想要 垂直 布局。

ImageJoinOptions imageJoinOptions = new ImageJoinOptions(ImageJoinMode.Vertical);

步骤 3：添加额外图像

对每个想要堆叠在前一张下方的额外图片使用 join 方法。

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

您可以根据需要多次重复此调用，以 将图像添加到文件 并创建长垂直拼贴。

步骤 4：保存合并后的图像

最后，将合并后的图片写入磁盘。

merger.save(filePathOut);

预期结果

输出文件将包含所有提供的图像，从上到下依次对齐，形成一张可用于报告、演示或网页画廊的单一高图像。

常见问题及解决方案

  • 文件路径不正确 – 再次确认每个路径指向现有图像且您的应用具有读写权限。
  • 不支持的格式 – 确保图像类型属于支持的静态格式（PNG、BMP、JPG）。此功能不处理动画 GIF。
  • 内存不足错误 – 合并大量高分辨率图像时，考虑在合并前调整大小或增大 JVM 堆大小（-Xmx 参数）。

实际应用

使用场景帮助方式
创建垂直照片拼贴将度假快照合并为单个可滚动的图像。
组装可视化报告章节合并图表、示意图和截图，以实现统一的 PDF 导出。
准备营销素材堆叠产品图像，打造流畅、可滚动的网页横幅。

性能提示

  • 每次仅加载所需的图像；在 save 后释放引用，让垃圾回收器回收内存。
  • 为源文件夹和目标文件夹使用 SSD 存储，以加快 I/O 速度。
  • 处理大批量时，在后台线程中运行合并，以保持 UI 响应。

结论

现在，您已经拥有使用 GroupDocs.Merger for Java 垂直 合并图像 的完整分步解决方案。尝试不同的图像集，尝试其他合并模式（水平、网格），并将此逻辑集成到更大的自动化流水线中。

后续步骤

  • 探索 ImageJoinMode.Horizontal 选项，以实现并排拼贴。
  • 使用 GroupDocs.PDF 将合并的图像与 PDF 生成相结合，实现端到端的文档创建。

常见问题

Q: 使用此方法可以合并哪些图像格式？
A: 支持 PNG、BMP、JPG 以及其他常见的静态格式。

Q: 合并的图像数量是否有限制？
A: 没有硬性限制；实际限制取决于内存可用性。使用 join 按顺序添加图像。

Q: 输出文件太大——我该怎么办？
A: 在合并前调整或压缩源图像，或使用 Java 的 ImageIO 降低质量。

Q: 能否垂直合并动画 GIF？
A: 当前 API 侧重于静态图像，动画 GIF 不支持垂直合并。

Q: 如何获取生产许可证？
A: 通过 GroupDocs 门户购买许可证；临时许可证可用于测试。

最后更新： 2026-08-15
测试环境： GroupDocs.Merger 最新版本（截至 2026 年）
作者： GroupDocs

资源

相关教程