如何在 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，這些文件通常包含內嵌條碼的多頁。

何時應使用多框架影像進行條碼掃描？

多框架影像是多種商業情境的理想選擇。 文件管理系統使用多頁 TIFF 檔案作為儲存掃描發票、出貨文件或表格的標準，其中每頁可能包含不同的 BarCode。 製造和物流作業通常會使用 GIF 動畫來建立可視化的工作流程，顯示多種條碼狀態或順序掃描指令。 批次處理應用程式可從多畫面格式中獲益，因為它們可減少檔案管理開銷 - 您無需處理數百個獨立的影像檔案，只需處理單個多畫面檔案即可。此外，在實作 從串流讀取 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 物件時，請使用此清單做為參數。

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

多頁 GIF 和 TIFF 都提供將影像組合成單一檔案的方式，但兩者有顯著的差異：

多頁條碼影像應選擇何種格式？

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

當檔案大小是一個考量，且您的條碼是簡單的線性格式，如 Code 39 或 Code 128 時，請選擇 GIF。GIF 廣泛的網路相容性使其適用於使用者可能會預覽條碼序列的線上應用程式。 不過，複雜的 QR 碼或有顏色漸層的 BarCode 應避免使用 GIF，因為 256 色的限制會影響可讀性。

檔案大小有哪些注意事項？

不同格式的檔案大小差異很大，會影響儲存、傳輸和處理速度。 無損壓縮的 TIFF 檔案在 300 DPI 下，每個 BarCode 影像的大小通常在 10-50KB 之間，適合存檔品質。 在 TIFF 中使用 JPEG 壓縮，尺寸可以減少 70-80%，同時維持可接受的 BarCode 可讀性。 GIF 檔一般較小，標準 BarCode 平均每格 5-15KB ，這是因為其調色板有限。 在執行具有特定效能需求的 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%。 其次，當條碼出現在不同畫格的一致位置時，請使用 裁剪區域，以縮小搜尋範圍。 第三，調整 MaxParallelThreads 屬性以符合您的 CPU 能力，以獲得最佳的平行處理畫格。 為了優化精確度，當框架可能包含數個條碼時，請啟用 ExpectMultipleBarcodes 並根據您的影像特性套用適當的影像篩選器。 ML 置信度閾值功能也有助於過濾複雜圖像中的誤判。

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

當遇到多框架檔案讀取失敗時，請遵循此系統方法。 首先，透過擷取和測試單一畫格來驗證單一畫格的品質 - 如果單一畫格失敗，則問題並非特定於多畫格。 檢查常見的識別問題，例如靜區不足、Barcode歪斜或符號損壞。 針對具有挑戰性的 BarCode，啟用 TryHarder 模式，儘管這會增加處理時間。對於持續性的問題，請執行 影像方向修正，因為旋轉的 BarCode 是常見的失敗原因。 考慮調整解析度 - BarCode 通常在 200-300 DPI 下讀取效果最佳，超過 400 DPI 則效果會逐漸降低。 如果特定 BarCode 類型仍有問題，請參閱 支援的格式說明文件，以確保相容性。

儘管設定 BarcodeReaderOptions 物件對於大多數使用情況而言是 可選的，但它有助於從多頁 GIF 和 TIFF 圖像檔案中讀取條碼時充分利用 IronBarcode。 對於生產環境，請從預設設定開始，並根據您特定的效能指標和精確度要求逐步進行最佳化。