BarcodeQRReaderDoScan(Int32) 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.

Syntax

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

'Declaration
 
Public Overloads Function BarcodeQRReaderDoScan( _
   ByVal ImageID As Integer _
) As GdPictureStatus

public GdPictureStatus BarcodeQRReaderDoScan( 
   int ImageID
)

public function BarcodeQRReaderDoScan( 
    ImageID: Integer
): GdPictureStatus;

public function BarcodeQRReaderDoScan( 
   ImageID : int
) : GdPictureStatus;

public: GdPictureStatus BarcodeQRReaderDoScan( 
   int ImageID
)

public:
GdPictureStatus BarcodeQRReaderDoScan( 
   int ImageID
)

Parameters

ImageID: A unique image identifier of the GdPicture image representing the image in use.

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 uses the best quality mode for scanning and will try to detect all available barcodes. You can use the GdPictureImaging.BarcodeQRReaderDoScan method and set the ExpectedCount parameter to 1 and StopOnExpectedCount to true, to stop the recognition process after one 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 QrCodes in an image and writeing complete barcodes info into a file.

using (GdPictureImaging gdpictureImaging = new GdPictureImaging())
{
    int imageID = gdpictureImaging.CreateGdPictureImageFromFile("image.jpg", false);
 
    // Start the QrCode barcode scanning process using the best quality mode and stop the process after the first QrCode barcode is found.
    gdpictureImaging.BarcodeQRReaderDoScan(imageID);
 
    // Write all available info into a text file.
    using (System.IO.StreamWriter file = new System.IO.StreamWriter("QrCodes.txt"))
    {
        int barcodesFound = gdpictureImaging.BarcodeQRReaderGetBarcodeCount();
 
        for (int i = 1; i <= barcodesFound; i++)
        {
            // Decoded information.
            file.WriteLine("Decoded info = " + gdpictureImaging.BarcodeQRReaderGetBarcodeValue(i));
 
            // Confidence in result, in percentage (values from 0 to 100).
            file.WriteLine("Confidence = " + gdpictureImaging.BarcodeQRReaderGetBarcodeConfidence(i));
 
            // The version of a Qr Code, in range 0-40. The higher the version, the larger the barcode is.
            file.WriteLine("Version = " + gdpictureImaging.BarcodeQRReaderGetVersion(i));
 
            // The skew angle of the barcode, in degrees.
            file.WriteLine("Skew angle = " + gdpictureImaging.BarcodeQRReaderGetBarcodeSkewAngle(i));
 
            // The raw bytes decoded. It was post-processed to find the correct decoded info based on detected Encoding.
            file.WriteLine("Raw bytes = " + gdpictureImaging.BarcodeQRReaderGetBarcodeValueRAW(i));
 
            // The barcode position, given by the coordinates of the corners.
            file.WriteLine("Position =  Top-Left=["
                + gdpictureImaging.BarcodeQRReaderGetBarcodeX1(i) + ", " + gdpictureImaging.BarcodeQRReaderGetBarcodeY1(i)
                + "] Top-Right=[" + gdpictureImaging.BarcodeQRReaderGetBarcodeX2(i) + ", " + gdpictureImaging.BarcodeQRReaderGetBarcodeY2(i)
                + "] Bottom-Right=[" + gdpictureImaging.BarcodeQRReaderGetBarcodeX3(i) + ", " + gdpictureImaging.BarcodeQRReaderGetBarcodeY3(i)
                + "] Bottom-Left=[" + gdpictureImaging.BarcodeQRReaderGetBarcodeX4(i) + ", " + gdpictureImaging.BarcodeQRReaderGetBarcodeY4(i) + "]");
        }
    }
 
    // Release used resources.
    gdpictureImaging.BarcodeQRReaderClear();
    gdpictureImaging.ReleaseGdPictureImage(imageID);
}

Reference

GdPictureImaging Class
GdPictureImaging Members
Overload List
SetROI Method