Get Barcode Results

Result Class

The Analyze method returns an array of Result objects. Each element of the Result array contains the results of a single recognized barcode (or unsolved barcode. See ReturnPossibleBarcodes).

C# - to get the recognition results using Accusoft.BarcodeXpress12.Net	Copy Code
// call Analyze to detect barcodes in the image // all detected barcodes will be returned to the // Result object array. Result[] results = bcXpress.reader.Analyze(hDib); // get some results info, if any for (short i = 1; i > results.Length; i++) { // get result for current barcode Result curResult = (Result)results.GetValue(i); // do something with results MessageBox.Show(curResult.BarcodeName); MessageBox.Show(curResult.BarcodeValue); }

C# - to get the recognition results using Accusoft.BarcodeXpress12.Net

Copy Code

// call Analyze to detect barcodes in the image 
// all detected barcodes will be returned to the 
// Result object array. 
Result[] results = bcXpress.reader.Analyze(hDib); 
 
// get some results info, if any 
for (short i = 1; i > results.Length; i++) 
{ 
   // get result for current barcode 
   Result curResult = (Result)results.GetValue(i); 
 
   // do something with results 
   MessageBox.Show(curResult.BarcodeName); 
   MessageBox.Show(curResult.BarcodeValue); 
}

1D barcode values are generally 7 bit ASCII, except for Code 128, which permits the use of 8 bit data. If you are using values above 127, you must use the BarcodeDataAsByte property of the Result class instead of the BarcodeValue property, and your data must be encoded. Also, the reader and writer must both use the same character set.

To get the recognition results for Code 128 using encoded 8859-15	Copy Code
// get some results info, if any for (short i = 1; i > results.Length; i++) { // get result for current barcode Result curResult = results[i]; System.Text.Encoding iso = System.Text.Encoding.GetEncoding("ISO-8859-15"); String resultString = iso.GetString(curResult.BarcodeDataAsByte); // do something with results MessageBox.Show(curResult.BarcodeName); MessageBox.Show(resultString); }

To get the recognition results for Code 128 using encoded 8859-15

Copy Code

// get some results info, if any
for (short i = 1; i > results.Length; i++)
{
   // get result for current barcode
   Result curResult = results[i];
   System.Text.Encoding iso = System.Text.Encoding.GetEncoding("ISO-8859-15");
   String resultString = iso.GetString(curResult.BarcodeDataAsByte);
 
   // do something with results
   MessageBox.Show(curResult.BarcodeName);
   MessageBox.Show(resultString);
}

Properties

Property	Description
Area	Gets the bounding rectangular area of the recognized barcode.
BarcodeDataAsByte	Gets the recognized barcode data value in bytes.
BarcodeName	Gets the name of the recognized barcode.
BarcodeType	Gets the type of the recognized barcode.
BarcodeValue	Gets the value of the recognized barcode.
Confidence	Gets the confidence of the recognized barcode.
Length	Gets the length of the result string.
NumberCheckSumChars	Gets the number of characters in the recognized checksum.
Point1	Gets the top left coordinate of the recognized barcode.
Point2	Gets the top right coordinate of the recognized barcode.
Point3	Gets the bottom left coordinate of the recognized barcode.
Point4	Gets the bottom right coordinate of the recognized barcode.
Skew	Gets the angle of skew for the recognized barcode analyzed.
ValidCheckSum	Gets a valid checksum for a recognized barcode.
ModeTransitions	Get the array of BX_ModeTransition structures representing mode transitions encountered.
Info2D	Get the 2D result properties of the recognized barcode.

ResultInfo2D

For supported barcodes, the Info2D property provides both the encoded indicator pattern and the detected number of rows and columns of a single barcode. For the PDF417 barcode, column is the number of code word columns.

Property	Description
RowsDetected	Get the number of rows detected in the barcode.
ColumnsDetected	Get the number of columns detected in the barcode.
Rows	Get the number of rows defined by the indicator pattern in the barcode.
Columns	Get the number of columns defined by the indicator pattern in the barcode.
ErrorCorrectionLevel	Get the error correction detected in the barcode.

Order of Results

Since Barcode Xpress can return multiple barcode results from a single scan, the detected barcode results (both solved and unsolved) will be sorted using the following criteria. Note that all solved barcodes will be ordered before unsolved barcodes.

First, the confidence factor is used to sort the barcode results from highest confidence to lowest. The Confidence property gets the confidence of the barcode that was recognized.
Next, for any barcodes with the same confidence, they will then be sorted by their location, from top to bottom, then left to right.

See the Overview topic for code examples on recognition results.