BarcodeMicroQRReaderDoScan(Int32,BarcodeQRReaderScanMode) 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 SetROI method. Starts a barcode recognition process on a GdPicture image or on an area of a GdPicture image using different parameters according to what you have specified. This method allows you to set the scanning mode parameter according to your preference.

Syntax

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

'Declaration
 
Public Overloads Function BarcodeMicroQRReaderDoScan( _
   ByVal ImageID As Integer, _
   ByVal ScanMode As BarcodeQRReaderScanMode _
) As GdPictureStatus

public GdPictureStatus BarcodeMicroQRReaderDoScan( 
   int ImageID,
   BarcodeQRReaderScanMode ScanMode
)

public function BarcodeMicroQRReaderDoScan( 
    ImageID: Integer;
    ScanMode: BarcodeQRReaderScanMode
): GdPictureStatus;

public function BarcodeMicroQRReaderDoScan( 
   ImageID : int,
   ScanMode : BarcodeQRReaderScanMode
) : GdPictureStatus;

public: GdPictureStatus BarcodeMicroQRReaderDoScan( 
   int ImageID,
   BarcodeQRReaderScanMode ScanMode
)

public:
GdPictureStatus BarcodeMicroQRReaderDoScan( 
   int ImageID,
   BarcodeQRReaderScanMode ScanMode
)

Parameters

ImageID: A unique image identifier of the GdPicture image representing the image in use.
ScanMode: A member of the BarcodeQRReaderScanMode enumeration. The scan mode (speed or quality) used for scanning process.

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 will try to detect all available barcodes. You can use the BarcodeMicroQRReaderDoScan(Int32,BarcodeQRReaderScanMode,Int32,Boolean) method and set the ExpectedCount parameter to 1 and bool StopOnExpectedCount to true, to stop the recognition process after the first barcode was found.

For more details, please refer to our Barcode Recognition Sample included in the installation folder that demonstrates the usage of this method.

Example

Finding Micro Qr Code barcodes in an image and writing complete barcodes info into a file.

using (GdPictureImaging gdpictureImaging = new GdPictureImaging())
{
    int imageID = gdpictureImaging.CreateGdPictureImageFromFile("image.jpg", false);
 
    // Perform scanning at best speed, ignoring very damaged barcodes.
    BarcodeQRReaderScanMode mode = BarcodeQRReaderScanMode.BestSpeed;
 
    // Start the Micro Qr Code barcode scanning process and stop the process after the first Micro Qr Code barcode is found.
    gdpictureImaging.BarcodeMicroQRReaderDoScan(imageID, mode);
 
    // Write all available info into a text file.
    using (System.IO.StreamWriter file = new System.IO.StreamWriter("MicroQrCodes.txt"))
    {
        int barcodesFound = gdpictureImaging.BarcodeMicroQRReaderGetBarcodeCount();
 
        for (int i = 1; i <= barcodesFound; i++)
        {
            // Decoded information.
            file.WriteLine("Decoded info = " + gdpictureImaging.BarcodeMicroQRReaderGetBarcodeValue(i));
 
            // The skew angle of the barcode, in degrees.
            file.WriteLine("Skew angle = " + gdpictureImaging.BarcodeMicroQRReaderGetBarcodeSkewAngle(i));
 
            // Confidence in result, in percentage (values from 0 to 100).
            file.WriteLine("Confidence = " + gdpictureImaging.BarcodeMicroQRReaderGetBarcodeConfidence(i));
 
            // The version of a Micro Qr Code, in range 1-4. The higher the version, the larger the barcode is.
            file.WriteLine("Version = " + gdpictureImaging.BarcodeMicroQRReaderGetVersion(i));
 
            // The barcode position, given by the coordinates of the corners.
            file.WriteLine("Position =  Top-Left=["
                + gdpictureImaging.BarcodeMicroQRReaderGetBarcodeX1(i) + ", " + gdpictureImaging.BarcodeMicroQRReaderGetBarcodeY1(i)
                + "] Top-Right=[" + gdpictureImaging.BarcodeMicroQRReaderGetBarcodeX2(i) + ", " + gdpictureImaging.BarcodeMicroQRReaderGetBarcodeY2(i)
                + "] Bottom-Right=[" + gdpictureImaging.BarcodeMicroQRReaderGetBarcodeX3(i) + ", " + gdpictureImaging.BarcodeMicroQRReaderGetBarcodeY3(i)
                + "] Bottom-Left=[" + gdpictureImaging.BarcodeMicroQRReaderGetBarcodeX4(i) + ", " + gdpictureImaging.BarcodeMicroQRReaderGetBarcodeY4(i) + "]");
        }
    }
 
    // Release used resources.
    gdpictureImaging.BarcodeMicroQRReaderClear();
    gdpictureImaging.ReleaseGdPictureImage(imageID);
}

Reference

GdPictureImaging Class
GdPictureImaging Members
Overload List
SetROI Method