如何使用 GroupDocs.Merger for Java 垂直合併圖像

在本分步指南中，您將透過使用 GroupDocs.Merger for Java 合併多張圖像為一張長圖，建立垂直相片拼貼。無論您需要可捲動的橫幅、報告附件，或是簡單的拼貼，本教學都會說明垂直合併的重要性、展示精確的 API 呼叫，並提供實用技巧以降低記憶體使用量。

快速回答

我可以使用哪個函式庫？ GroupDocs.Merger for Java.
我可以合併超過三張圖像嗎？ 是 — 依需求加入任意多張。
支援哪些圖像格式？ PNG, BMP, JPG, and other common static formats.
開發時需要授權嗎？ A free trial works for testing; a paid license is required for production.
此過程記憶體效能高嗎？ Load only required images and save promptly to keep memory usage low.

什麼是圖像合併？

圖像合併是將兩張或多張獨立圖像檔案結合成單一合成圖的技術。當圖像以垂直方式堆疊時，結果會呈現一條長條形相片——非常適合用於 垂直相片拼貼 或組合報告的視覺區段。

為何使用 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 下載最新版本。

取得授權步驟

免費試用 – 無需付費即可探索所有功能。
臨時授權 – 取得短期金鑰以延長測試。
購買 – 為正式環境購買永久授權。

加入函式庫後，於您的 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, and other common static formats are supported.

Q: 合併的圖像數量有上限嗎？
A: No hard limit; the practical limit is memory availability. Add images sequentially with join.

Q: 我的輸出檔案太大——該怎麼辦？
A: Resize or compress the source images before merging, or use Java’s ImageIO to reduce quality.

Q: 能垂直合併動畫 GIF 嗎？
A: The current API focuses on static images; animated GIFs are not supported for vertical joining.

Q: 如何取得正式授權？
A: Purchase a license through the GroupDocs portal; a temporary license is available for testing.

最後更新： 2026-08-15
測試環境： GroupDocs.Merger latest version (as of 2026)
作者： GroupDocs

資源