如何在 C# 中讀取多頁 GIF 和 TIFF 檔案中的條碼

IronBarcode為何能自動處理多幀影像？

IronBarcode可自動處理多幀影像，簡化您的工作流程。 傳統的條碼讀取庫通常需要在處理之前從 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);
}

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

IronBarcode 的多頁讀取功能不僅限於 GIF 和 TIFF 格式。 該庫支援所有標準圖像格式，包括 JPEG、PNG、BMP 和 SVG(用於單頁圖像)。 對於多頁支持，TIFF 和動畫 GIF 是主要格式。 TIFF 格式用途非常廣泛，因為它能夠以各種壓縮方法儲存多個全解析度影像，使其成為文件掃描場景的理想選擇。 動畫 GIF 雖然僅限於 256 種顏色，但它擅長以緊湊、適合網絡的格式儲存多個條碼幀。 對於特殊需求，您還可以讀取 PDF 文件中的條碼，PDF 文件通常包含多個嵌入條碼的頁面。

何時應該使用多幀影像進行條碼掃描？

多幀影像非常適合多種商業場景。 文件管理系統通常使用多頁 TIFF 檔案來儲存掃描的發票、運送單據或表格，其中每一頁可能包含不同的條碼。 製造和物流作業經常使用動畫 GIF 來建立視覺化工作流程，顯示多個條碼狀態或順序掃描說明。 批次處理應用程式受益於多幀格式，因為它可以減少文件管理開銷——無需處理數百個單獨的圖像文件，只需處理單個多幀文件即可。此外，在實現從資料流讀取條碼時，多幀格式可以顯著減少記憶體分配並提高效能。

創建多幀 TIFF 檔案的步驟是什麼？

建立多幀 TIFF 檔案涉及將多個影像來源合併到單一 TIFF 容器中。 首先將單一圖像作為點陣圖物件載入到記憶體中。 IronDrawing 的 AnyBitmap 類別提供了一個統一的介面來處理各種映像格式，自動管理格式轉換並確保相容性。 在建立多幀 TIFF 時，此程式庫會優化壓縮設置，以平衡檔案大小和影像質量，這對於保持條碼可讀性至關重要。

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

從上面的程式碼片段中，我們首先將圖像檔案匯入 AnyBitmap 物件清單中，從而將圖像檔案分組。 當呼叫 AnyBitmap.CreateMultiFrameTiff 和 AnyBitmap.CreateMultiFrameGif 方法時，請使用此清單作為參數，分別取得多頁 TIFF 和多頁 GIF 物件。

GIF 和 TIFF 格式在條碼儲存上有何不同？

多頁 GIF 和 TIFF 都提供了將影像分組到單一檔案中的方法，但它們之間存在顯著差異：

多頁條碼圖像應該選擇哪種格式？

根據您的特定使用場景，選擇 GIF 或 TIFF 格式。 在處理需要精確保留細節的高解析度條碼影像時，例如在文件歸檔或專業掃描應用中，請選擇 TIFF 格式。 TIFF 支援各種壓縮方法和顏色深度，因此非常適合在不同類型的條碼(包括具有精細細節的條碼，如2D 資料矩陣碼)上保持條碼品質。

如果檔案大小是主要考慮因素，且您的條碼是簡單的線性格式(例如Code 39或 Code 128)，則應選擇 GIF 格式。 GIF 格式廣泛的網路相容性使其適用於使用者可能需要預覽條碼序列的線上應用程式。 但是，對於複雜的二維碼或帶有顏色漸變的條碼，應避免使用 GIF 格式，因為 256 色的限制會影響可讀性。

文件大小需要考慮哪些因素？

檔案大小因格式而異，會影響儲存、傳輸和處理速度。 採用無損壓縮的 TIFF 文件，每個條碼影像在 300 DPI 下通常為 10-50KB，適合存檔品質。 在 TIFF 中使用 JPEG 壓縮，可以在保持可接受的條碼可讀性的同時，將檔案大小減少 70-80%。 由於顏色範圍有限，GIF 檔案通常較小，標準條碼每幀平均大小為 5-15KB。 在實現具有特定效能要求的條碼讀取時，請考慮較小的檔案處理速度更快，但可能會在極端情況下犧牲準確性。

何時應該使用影像濾波器以提高精度？

當影像品質欠佳時，影像濾波器就顯得至關重要——這種情況在多幀檔案中很常見，因為不同幀之間的影像品質可能有所不同。 當條碼因掃描器限製而顯得模糊、因光線不足而對比度低，或因壓縮偽影而含有雜訊時，請套用濾鏡。 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);
}

對於多頁文件，我應該使用什麼樣的效能設定？

多頁文件的效能優化需要根據您的需求平衡速度和準確性。 對於速度至關重要的大批量處理，請使用 ReadingSpeed.Faster 或 ReadingSpeed.Fastest，雖然會降低掃描的徹底性，但會顯著提高吞吐量——非常適合在受控環境中打印良好的條碼。 對於精確度至關重要的關鍵任務應用，ReadingSpeed.Detailed 設定可確保最大偵測率，但會佔用一定的處理時間。 ReadingSpeed.Balanced 設定則為大多數業務應用提供了一個最佳的折中方案。 處理多頁檔案時，可考慮採用非同步讀取模式並行處理幀，從而顯著提高整體吞吐量。

如何平衡閱讀速度和準確率？

優化速度與精度之間的權衡涉及多種戰略配置。 首先，使用 ExpectBarcodeTypes 指定預期的條碼類型，以消除不必要的格式檢查－僅此一項就能提高 40-60% 的速度。 第二，當條碼在影格中以一致的位置出現時，使用裁切區域，從而縮小搜尋範圍。 第三，調整 MaxParallelThreads 屬性以符合您的 CPU 功能，從而實現幀的最佳並行處理。 為了優化準確性，當幀可能包含多個條碼時，請啟用 ExpectMultipleBarcodes，並根據影像特徵套用適當的影像濾鏡。 ML置信度閾值功能也有助於過濾複雜影像中的誤報。

讀取失敗的常見故障排除步驟有哪些？

當遇到多幀檔案讀取失敗的情況時，請按照以下系統方法進行操作。 首先，透過提取和測試單個幀來驗證單個幀的品質——如果單個幀失敗，則問題並非多幀特有的。 檢查是否有常見的識別問題，例如靜區不足、條碼傾斜或符號損壞。 啟用 TryHarder 模式可處理複雜條碼，但這會增加處理時間。對於持續存在的問題，請實施影像方向校正，因為條碼旋轉是導致辨識失敗的常見原因。 考慮調整解析度－條碼通常在 200-300 DPI 時讀取效果最佳，超過 400 DPI 後收益遞減。 如果特定條碼類型仍有問題，請查閱支援的格式文件以確保相容性。

雖然對於大多數使用情況來說，設定 BarcodeReaderOptions 物件是可選的，但當從多頁 GIF 和 TIFF 影像檔案中讀取條碼時，它有助於最大限度地發揮IronBarcode的功能。 對於生產環境，請從預設設定開始，並根據特定的效能指標和精確度要求逐步最佳化。