如何在 C# 中讀取多頁 GIF 與 TIFF 檔案中的 BarCode

為什麼 IronBarcode 會自動處理多幀圖像？

IronBarcode 能自動處理多幀圖像，以簡化您的工作流程。 傳統的 BarCode 讀取函式庫通常需要在處理前，從 GIF 動畫中擷取單一幀，或從 TIFF 檔案中分離頁面。 這會增加不必要的複雜性，並可能導致系統故障。 IronBarcode 的智慧型幀檢測功能透過內部解析影像結構，並自動遍歷每個幀或頁面，從而消除這項負擔。 此方法可確保無論幀數多少皆能維持一致的結果，同時透過優化的記憶體管理來維持高效能。

以下程式碼範例示範如何讀取多頁面的 GIF 和 TIFF 檔案：

:path=/static-assets/barcode/content-code-examples/how-to/read-barcodes-from-multi-page-frame-tiff-gif-read-tif.cs

using IronBarCode;
using System;

// Read barcode from TIF image
BarcodeResults results = BarcodeReader.Read("sample.tif");

// Output the barcodes value to console
foreach (var result in results)
{
    Console.WriteLine(result.Value);
}

Imports IronBarCode
Imports System

' Read barcode from TIF image
Private results As BarcodeResults = BarcodeReader.Read("sample.tif")

' Output the barcodes value to console
For Each result In results
	Console.WriteLine(result.Value)
Next result

多頁閱讀支援哪些圖像格式？

IronBarcode 的多頁讀取功能不僅限於 GIF 和 TIFF 格式。 此函式庫支援所有標準圖像格式，包括 JPEG、PNG、BMP 以及單頁圖像的 SVG 格式。 針對多頁面的支援，主要支援的格式為 TIFF 和動畫 GIF。 TIFF 格式具有極高的多功能性，因其能以多種壓縮方式儲存多張全解析度影像，因此非常適合用於文件掃描情境。 動畫 GIF 雖然僅限於 256 色，但擅長以緊湊且適合網頁的格式儲存多個 BARCODE 幀。 針對特殊需求，您亦可讀取 PDF 文件中的 BARCODE，此類文件通常包含多頁且內嵌 BARCODE。

何時應使用多幀圖像進行BarCode掃描？

多幀圖像非常適合多種商業情境。 文件管理系統採用多頁 TIFF 檔案作為標準格式，用於儲存掃描後的發票、運送文件或表單，其中每頁可能包含不同的 BARCODE。 製造與物流作業常使用動態 GIF 圖像，以視覺化工作流程呈現多種 BarCode 狀態或序列掃描指示。 批次處理應用程式能從多幀格式中獲益，因為這能降低檔案管理的開銷——您無需處理數百個獨立的影像檔案，而是僅需處理單一的多幀檔案。此外，在從資料流中讀取BarCode時，多幀格式能顯著減少記憶體分配並提升效能。

建立多幀 TIFF 檔案的流程為何？

建立多幀 TIFF 檔案，是指將多個影像來源整合至單一 TIFF 容器中。 首先將個別圖像載入記憶體中，作為位圖物件。 IronDrawing 的 AnyBitmap 類別提供了一個統一的介面，用於處理各種圖像格式，自動管理格式轉換並確保相容性。 在建立多幀 TIFF 檔案時，此函式庫會優化壓縮設定以平衡檔案大小與影像品質，這對於維持 BarCode 可讀性至關重要。

:path=/static-assets/barcode/content-code-examples/how-to/read-barcodes-from-multi-page-frame-tiff-gif-create-tiff-gif.cs

using IronBarCode;
using IronSoftware.Drawing;
using System.Collections.Generic;

// Import images
List<AnyBitmap> images = new List<AnyBitmap>()
{
    AnyBitmap.FromFile("image1.png"),
    AnyBitmap.FromFile("image2.png"),
    AnyBitmap.FromFile("image3.png"),
    AnyBitmap.FromFile("image4.jpg"),
    AnyBitmap.FromFile("image5.jpg")
};

// Convert TIFF from images
AnyBitmap tiffImage = AnyBitmap.CreateMultiFrameTiff(images);

// Export TIFF
tiffImage.SaveAs("multiframetiff.tiff");

// Convert GIF from images
AnyBitmap gifImage = AnyBitmap.CreateMultiFrameGif(images);

// Export GIF
gifImage.SaveAs("multiframegif1.gif");

Imports IronBarCode
Imports IronSoftware.Drawing
Imports System.Collections.Generic

' Import images
Private images As New List(Of AnyBitmap)() From {AnyBitmap.FromFile("image1.png"), AnyBitmap.FromFile("image2.png"), AnyBitmap.FromFile("image3.png"), AnyBitmap.FromFile("image4.jpg"), AnyBitmap.FromFile("image5.jpg")}

' Convert TIFF from images
Private tiffImage As AnyBitmap = AnyBitmap.CreateMultiFrameTiff(images)

' Export TIFF
tiffImage.SaveAs("multiframetiff.tiff")

' Convert GIF from images
Dim gifImage As AnyBitmap = AnyBitmap.CreateMultiFrameGif(images)

' Export GIF
gifImage.SaveAs("multiframegif1.gif")

根據上方的程式碼片段，我們首先將圖片檔案匯入 AnyBitmap 物件清單中，以此進行分組。 在呼叫 AnyBitmap.CreateMultiFrameTiff 和 AnyBitmap.CreateMultiFrameGif 方法時，請將此清單作為參數，以分別取得多頁 TIFF 和多頁 GIF 物件。

在 BARCODE 儲存方面，GIF 與 TIFF 格式有何差異？

多頁 GIF 和 TIFF 皆提供將圖片彙整為單一檔案的方法，但兩者存在顯著差異：

對於多頁BarCode圖像，我應該選擇哪種格式？

請根據您的具體使用情境，在 GIF 與 TIFF 格式之間進行選擇。 在處理需要精確保留細節的高解析度 BARCODE 影像時（例如文件歸檔或 Professional 掃描應用），請選擇 TIFF 格式。 TIFF 支援多種壓縮方式與色彩深度，使其成為維持各類 BARCODE 品質的理想選擇，包括具有細微細節的 BARCODE，例如 2D Data Matrix BARCODE。

當檔案大小是考量因素，且 BARCODE 為 Code 39 或 Code 128 等簡單的線性格式時，請選擇 GIF 格式。GIF 廣泛的網頁相容性使其適合用於使用者可能預覽 BARCODE 序列的線上應用程式。 然而，請避免使用 GIF 格式呈現複雜的 QR 碼或帶有色彩漸變的 BARCODE，因為 256 色的限制可能會影響可讀性。

關於檔案大小的考量有哪些？

檔案大小因格式而異，且會影響儲存、傳輸及處理速度。 採用無損壓縮的 TIFF 檔案，在 300 DPI 解析度下，每張 BarCode 圖像的檔案大小通常介於 10 至 50 KB 之間，適合用於檔案保存級別。 透過 TIFF 中的 JPEG 壓縮，檔案大小可減少 70-80%，同時仍能維持可接受的 BARCODE 可讀性。 由於色彩範圍有限，GIF 檔案通常較小，標準 BarCode 每幀平均僅需 5 至 15 KB。 在實施具有特定效能要求的BarCode讀取功能時，請注意：較小的檔案處理速度較快，但在邊緣案例中可能會犧牲準確性。

何時應使用影像濾鏡以提升準確度？

當處理畫質不佳的影像時，影像濾鏡便成為不可或缺的工具——這在多幀檔案中相當常見，此類檔案各幀的畫質可能參差不齊。 當BARCODE因掃描器限制而顯得模糊、因光線不足導致對比度低，或因壓縮失真而含有雜訊時，請套用濾鏡。 IronBarcode 的影像修正功能包含：針對不同光線條件的自適應閾值調整、用於處理動態模糊的銳化濾鏡，以及針對褪色印跡的對比度增強功能。 對於多幀檔案而言，濾鏡特別有用，因為它們能在無需人工干預的情況下，彌補各幀之間的畫質差異。

以下程式碼片段示範如何在 BarcodeReaderOptions 類別中設定屬性：

:path=/static-assets/barcode/content-code-examples/how-to/read-barcodes-from-multi-page-frame-tiff-gif-advance.cs

using IronBarCode;
using System;

// Configure filters
ImageFilterCollection filters = new ImageFilterCollection()
{
    new SharpenFilter(3.5f),
    new ContrastFilter(2)
};

// Configure options
BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    ExpectBarcodeTypes = IronBarCode.BarcodeEncoding.QRCode,
    ImageFilters = filters,
    ExpectMultipleBarcodes = true,
    Speed = ReadingSpeed.Balanced
};

// Read barcode from TIF image
BarcodeResults results = BarcodeReader.Read("sample.tif", options);

// Output the barcodes value to console
foreach (var result in results)
{
    Console.WriteLine(result.Value);
}

Imports IronBarCode
Imports System

' Configure filters
Private filters As New ImageFilterCollection() From {
	New SharpenFilter(3.5F),
	New ContrastFilter(2)
}

' Configure options
Private options As New BarcodeReaderOptions() With {
	.ExpectBarcodeTypes = IronBarCode.BarcodeEncoding.QRCode,
	.ImageFilters = filters,
	.ExpectMultipleBarcodes = True,
	.Speed = ReadingSpeed.Balanced
}

' Read barcode from TIF image
Private results As BarcodeResults = BarcodeReader.Read("sample.tif", options)

' Output the barcodes value to console
For Each result In results
	Console.WriteLine(result.Value)
Next result

對於多頁文件，我應該使用哪些效能設定？

針對多頁文件的效能優化，需根據您的需求在速度與準確性之間取得平衡。 若需處理大量資料且速度至關重要，請使用 ReadingSpeed.Faster 或 ReadingSpeed.Fastest，此方式雖會降低掃描的徹底性，但能顯著提升處理量——非常適合在受控環境中掃描印刷清晰的BARCODE。 對於精確度至關重要的關鍵任務應用程式，ReadingSpeed.Detailed 能在犧牲處理時間的前提下確保最高的偵測率。ReadingSpeed.Balanced 設定則為大多數商業應用程式提供了最佳的折衷方案。 處理多頁文件時，建議採用非同步讀取模式以並行處理各頁，此舉可大幅提升整體處理效能。

如何在閱讀速度與準確性之間取得最佳平衡？

要優化速度與精準度的權衡，需進行多項策略性設定。 首先，請使用 ExpectBarcodeTypes 指定預期的 BARCODE 類型，以消除不必要的格式檢查——僅此一項即可提升 40-60% 的速度。 其次，當BarCode在各幀中出現在固定位置時，請使用裁切區域功能，以縮小搜尋範圍。 第三，請調整 MaxParallelThreads 屬性以配合您的 CPU 效能，以實現最佳的幀並行處理效果。 為優化準確度，當畫面可能包含多個BARCODE時，請啟用 ExpectMultipleBarcodes，並根據影像特性套用適當的影像濾鏡。 機器學習的信心閾值功能也有助於在複雜圖像中過濾出誤判結果。

讀取失敗時，常見的疑難排解步驟有哪些？

當處理多幀檔案時遇到讀取失敗的情況，請遵循此系統化方法。 首先，請透過擷取並測試單一幀來驗證各幀的品質——若單一幀出現問題，則該問題並非多幀處理所特有。 請檢查常見的辨識問題，例如靜區不足、BarCode傾斜或符號損壞。 對於難以辨識的 BARCODE，請啟用 TryHarder 模式，儘管這會增加處理時間。若問題持續存在，請實施影像方向校正，因為旋轉的 BARCODE 是導致失敗的常見原因。 請考慮調整解析度——BARCODE 通常在 200-300 DPI 時讀取效果最佳，超過 400 DPI 則效益遞減。 若特定BarCode類型仍出現問題，請參閱支援格式文件以確保相容性。

雖然在大多數使用情境下，設定 BarcodeReaderOptions 物件並非必要，但在從多頁 GIF 和 TIFF 影像檔案讀取 BARCODE 時，此設定有助於充分發揮 IronBarcode 的效能。 在生產環境中，請先採用預設設定，並根據您的具體效能指標與精確度要求逐步進行優化。