LEADTOOLS使用教程：LEADTOOLS Barcode用法

---

LEADTOOLS可以準確而快速地讀取各種一維和二維條碼（類型）及其子類型。LEADTOOLS Barcode支持100多種條形碼的讀寫，其中包括所有主要的1D和2D條形碼。

LEADTOOLS Barcode SDK技術亮點：

• 可用于開發Windows應用程序，并包含本地的32位和64位2D條形碼二進制文件；
• 包含許多有源代碼的演示項目，這些源代碼包含C, Visual C++ (MFC), VB.NET 和C#的版本；
• 支持多線程；
• 支持廣泛的1D條碼，包括UPC/EAN, Codabar, GS1 Databa和USPS 4-State；
• 支持廣泛的2D條碼，包括PDF417, MicroPDF417, Datamatrix和QR
• 快速條形碼檢測和解碼；
• 查找整個圖像區域或特定區域的條形碼；
• 每頁閱讀條形碼的數量不受限；
• 任何方向和旋轉角度檢測條形碼；
• 讀寫黑白區域或者彩色圖像中的條碼；

使用LEADTOOLS Barcode

LEADTOOLS Barcode支持可以通過Leadtools.Barcode.dll程序集來訪問。實際讀/寫的條形碼包含在動態加載和運行時訪問的單獨程序集中。這些組件是原生.NET和Silverlight二進制文件，可以直接添加到您的項目作為部署的參考。下表列出來條碼支持的程序集以及功能：

讀取條形碼

要讀取條碼，首選需要獲取存儲在BarcodeEngine.Reader屬性中的Leadtools.Barcode.BarcodeReader對象實例。然后調用BarcodeReader.ReadBarcode 或BarcodeReader.ReadBarcodes方法以傳遞Leadtools.RasterImage對象。這些方法會返回一個或一個包含了條形碼數據的Leadtools.Barcode.BarcodeData對象的數組。

// Read all barcodes in the image
BarcodeData[] dataArray = barcodeEngineInstance.Reader.ReadBarcodes(
theImage, \\ The RasterImage object
LogicalRectangle.Empty, \\ Search rectangle, Empty means all image
0, \\ Maximum number of barcodes to return, 0 means all barcodes found
null); \\ Array of BarcodeSymbology we are interested in, null means all

當找到條形碼或發生錯誤時，BarcodeReader.ReadSymbology事件被激活。 Leadtools.Barcode.BarcodeSymbology枚舉中定義了所支持的條形碼枚舉類型。 下列代碼片段可搜索并試圖從圖像中讀取單個QR碼：

BarcodeData data = barcodeEngineInstance.Reader.ReadBarcode(
theImage, \\ The RasterImage object
LogicalRectangle.Empty, \\ Search rectangle, Empty means all image
BarcodeSymbology.QR); \\ Symbology, only QR

通過傳遞Leadtools.Barcode.BarcodeReadOptions中的一個或者多個對象，微調條形碼讀取。例如，改變條形碼閱讀器的默認選項，將搜索方向改為水平方向和垂直于條形碼PDF417，示例如下：

// Get the default PDF417 read options
PDF417BarcodeReadOptions options = barcodeEngineInstance.Reader.GetDefaultOptions(BarcodeSymbology.PDF417);
// Change the search direction
options.SearchDirection = BarcodeSearchDirection.HorizontalAndVertical;
// Read a PDF417 barcode from the image
BarcodeData data = barcodeEngineInstance.Reader.ReadBarcode(theImage, LogicalRectangle.Empty, BarcodeSymbology.PDF417);

編寫條形碼

要將條形碼寫入圖像中，首先需要獲取儲存在BarcodeEngine.Writer屬性中的Leadtools.Barcode.BarcodeWriter對象實例。然后傳遞 Leadtools.RasterImage對象以調用BarcodeWriter.WriterBarcode，代碼如下：

// Create a UPC A barcode
BarcodeData data = new BarcodeData();
data.Symbology = BarcodeSymbology.UPCA;
data.Value = "01234567890";
data.Bounds = new LogicalRectangle(10, 10, 600, 200, LogicalUnit.Pixel);
// Write it with default options
barcodeEngineInstance.Writer.WriteBarcode(theImage, data, null);

使用一個或多個Leadtools.Barcode.BarcodeWriteOptions衍生類添加額外功能至編寫操作中。下列代碼可使后續的所有編寫操作能顯示出條形碼文本：

OneDBarcodeWriteOptions options = barcodeEngineInstance.Writer.GetDefaultOptions(BarcodeSymbology.UPCA) as OneDBarcodeWriteOptions;
options.TextPosition = OneDBarcodeTextPosition.Default;
// Write it with default options
barcodeEngineInstance.Writer.WriteBarcode(theImage, data, null);

編寫條碼時，你可能想要計算條形碼的像素尺寸，并在提交前進行微調。可使用BarcodeWriter.CalculateBarcodeDataBounds方法來實現這一點。

條碼類型

LEADTOOLS支持讀寫以下條碼類型：

• Linear barcodes (1D)
• PDF417 (2D)
• MicroPDF417 (2D)
• Datamatrix (2D)
• QR (2D)

每個主要條碼類型下包含一個或者多個條碼分類，如：

線性（1D）條碼：

• EAN 13
• EAN 8
• UPC A
• UPC E
• Code 3 of 9
• Code 128
• Code 93
• Interleaved 2 of 5
• CODABAR
• UCCEAN 128
• EAN EXT 5
• EAN EXT 2
• MSI
• Code 11
• Standard 2 Of 5
• GS1 Databar (formerly RSS14) Omnidirectional
• GS1 Databar (formerly RSS14) Truncated
• GS1 Databar (formerly RSS14) Limited
• GS1 Databar (formerly RSS14) Expanded
• Patch Code
• Postnet
• Planet
• Australian Post - 4 State
• Royal Mail (RM4SCC)
• GS1 Databar (formerly RSS14) Stacked
• GS1 Databar (formerly RSS14) Stacked Omnidirectional
• GS1 Databar (formerly RSS14) Expanded Stacked

2D：

• PDF417
• MicroPDF417
• Datamatrix (with multiple symbol sizes)
• QR (with multiple symbol models)