BarcodeAztecReaderDoScan(Int32,BarcodeAztecReaderScanMode,Int32,Boolean) Method

In This Topic

Starts a barcode recognition process on a specified GdPicture image or on an area of a specified GdPicture image defined by the GdPictureImaging.SetROI method. This method allows you to set the scanning mode parameter as well as to define the required number of barcodes the engine should detect.

Syntax

Visual Basic
C#
Delphi
JScript
Managed Extensions for C++
C++/CLI

'Declaration
 
Public Overloads Function BarcodeAztecReaderDoScan( _
   ByVal ImageID As Integer, _
   ByVal ScanMode As BarcodeAztecReaderScanMode, _
   ByVal ExpectedCount As Integer, _
   ByVal StopOnExpectedCount As Boolean _
) As GdPictureStatus

public GdPictureStatus BarcodeAztecReaderDoScan( 
   int ImageID,
   BarcodeAztecReaderScanMode ScanMode,
   int ExpectedCount,
   bool StopOnExpectedCount
)

public function BarcodeAztecReaderDoScan( 
    ImageID: Integer;
    ScanMode: BarcodeAztecReaderScanMode;
    ExpectedCount: Integer;
    StopOnExpectedCount: Boolean
): GdPictureStatus;

public function BarcodeAztecReaderDoScan( 
   ImageID : int,
   ScanMode : BarcodeAztecReaderScanMode,
   ExpectedCount : int,
   StopOnExpectedCount : boolean
) : GdPictureStatus;

public: GdPictureStatus BarcodeAztecReaderDoScan( 
   int ImageID,
   BarcodeAztecReaderScanMode ScanMode,
   int ExpectedCount,
   bool StopOnExpectedCount
)

public:
GdPictureStatus BarcodeAztecReaderDoScan( 
   int ImageID,
   BarcodeAztecReaderScanMode ScanMode,
   int ExpectedCount,
   bool StopOnExpectedCount
)

Parameters

ImageID: A unique image identifier of the GdPicture image representing the image in use.
ScanMode: A member of the BarcodeAztecReaderScanMode enumeration. The scan mode (speed or quality) used for scanning process.
ExpectedCount: Specifies the number of barcodes expected to be detected. Use 0 to find all available barcodes within an image.
StopOnExpectedCount: If this is set to true and ExpectedCount > 0, the recognition process stops after first ExpectedCount barcodes were found.

Return Value

A member of the GdPictureStatus enumeration. If the method has been successfully followed, then the return value is GdPictureStatus.OK. We strongly recommend always checking this status first.

Remarks

This method requires the Barcode Reading & Writing component to run.

Example

Finding Aztec barcodes in an image and writing complete barcodes info in a file.

using (GdPictureImaging gdpictureImaging = new GdPictureImaging())
{
    int imageID = gdpictureImaging.CreateGdPictureImageFromFile("image.jpg", false);
 
    // Perform scanning at best speed, ignoring very damaged barcodes.
    BarcodeAztecReaderScanMode mode = BarcodeAztecReaderScanMode.BestSpeed;
 
    // Start the Aztec barcode scanning process looking for exactly one single barcode and write info into a text file.
    gdpictureImaging.BarcodeAztecReaderDoScan(imageID, mode, 1, true);
 
    using (System.IO.StreamWriter file = new System.IO.StreamWriter("Aztec.txt"))
    {
        int barcodesFound = gdpictureImaging.BarcodeAztecReaderGetBarcodeCount();
 
        for (int i = 1; i <= barcodesFound; i++)
        {
            // Decoded information.
            file.WriteLine("Decoded info = " + gdpictureImaging.BarcodeAztecReaderGetBarcodeValue(i));
 
            // The raw bytes decoded. It was post-processed to find the correct decoded info based on detected Encoding.
            file.WriteLine("Raw bytes = " + gdpictureImaging.BarcodeAztecReaderGetBarcodeValueRAW(i));
 
            // The barcode position, given by the coordinates of the corners.
            file.WriteLine("Position =  Top-Left=["
                + gdpictureImaging.BarcodeAztecReaderGetBarcodeX1(i) + ", " + gdpictureImaging.BarcodeAztecReaderGetBarcodeY1(i)
                + "] Top-Right=[" + gdpictureImaging.BarcodeAztecReaderGetBarcodeX2(i) + ", " + gdpictureImaging.BarcodeAztecReaderGetBarcodeY2(i)
                + "] Bottom-Right=[" + gdpictureImaging.BarcodeAztecReaderGetBarcodeX3(i) + ", " + gdpictureImaging.BarcodeAztecReaderGetBarcodeY3(i)
                + "] Bottom-Left=[" + gdpictureImaging.BarcodeAztecReaderGetBarcodeX4(i) + ", " + gdpictureImaging.BarcodeAztecReaderGetBarcodeY4(i) + "]");
        }
    }
 
    // Release used resources.
    gdpictureImaging.BarcodeAztecReaderClear();
    gdpictureImaging.ReleaseGdPictureImage(imageID);
}

Reference

GdPictureImaging Class
GdPictureImaging Members
Overload List
SetROI Method