Reference Guide
GdPicture14 Namespace / GdPictureImaging Class / BarcodePDF417ReaderDoScan Method / BarcodePDF417ReaderDoScan(Int32) Method
A unique image identifier of the GdPicture image representing the image in use.
Example





In This Topic
    BarcodePDF417ReaderDoScan(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 SetROI method.
    Syntax
    'Declaration
     
    
    Public Overloads Function BarcodePDF417ReaderDoScan( _
       ByVal ImageID As Integer _
    ) As GdPictureStatus
    public GdPictureStatus BarcodePDF417ReaderDoScan( 
       int ImageID
    )
    public function BarcodePDF417ReaderDoScan( 
        ImageID: Integer
    ): GdPictureStatus; 
    public function BarcodePDF417ReaderDoScan( 
       ImageID : int
    ) : GdPictureStatus;
    public: GdPictureStatus BarcodePDF417ReaderDoScan( 
       int ImageID
    ) 
    public:
    GdPictureStatus BarcodePDF417ReaderDoScan( 
       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
    Please note that this method uses the best quality mode for scanning and it finishes after the first barcode has been found. You can use the BarcodePDF417ReaderDoScan(Int32,BarcodePDF417ReaderScanMode,Int32) method and set the ExpectedCount parameter to 0 to find all available barcodes at once.

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

    Example
    Finding PDF417 barcodes in an image and writing complete barcodes info into a file.
    using (GdPictureImaging gdpictureImaging = new GdPictureImaging())
    {
        int imageID = gdpictureImaging.CreateGdPictureImageFromFile("image.jpg", false);
        
        // Start the PDF417 barcode scanning process using the best quality mode and stop the process after the first PDF417 barcode is found.
        gdpictureImaging.BarcodePDF417ReaderDoScan(imageID);
     
        // Write all available info into a text file.
        using (System.IO.StreamWriter file = new System.IO.StreamWriter("PDF417.txt"))
        {
            int barcodesFound = gdpictureImaging.BarcodePDF417ReaderGetBarcodeCount();
     
            for (int i = 1; i <= barcodesFound; i++)
            {
                // Decoded information.
                file.WriteLine("Decoded info = " + gdpictureImaging.BarcodePDF417ReaderGetBarcodeValue(i));
     
                // The raw bytes decoded. It was post-processed to find the correct decoded info based on detected Encoding.
                file.WriteLine("Raw bytes = " + gdpictureImaging.BarcodePDF417ReaderGetBarcodeValueRAW(i));
     
                // The number of rows of the barcode.
                file.WriteLine("Rows = " + gdpictureImaging.BarcodePDF417ReaderGetBarcodeRows(i));
     
                // The number of columns of the barcode.
                file.WriteLine("Columns = " + gdpictureImaging.BarcodePDF417ReaderGetBarcodeColumns(i));
     
                // The skew angle of the barcode, in degrees.
                file.WriteLine("Skew angle = " + gdpictureImaging.BarcodePDF417ReaderGetBarcodeSkewAngle(i));
     
                // Confidence in result, in percentage (values from 0 to 100).
                file.WriteLine("Confidence = " + gdpictureImaging.BarcodePDF417ReaderGetBarcodeConfidence(i));
     
                // The barcode position, given by the coordinates of the corners.
                file.WriteLine("Position =  Top-Left=["
                    + gdpictureImaging.BarcodePDF417ReaderGetBarcodeX1(i) + ", " + gdpictureImaging.BarcodePDF417ReaderGetBarcodeY1(i)
                    + "] Top-Right=[" + gdpictureImaging.BarcodePDF417ReaderGetBarcodeX2(i) + ", " + gdpictureImaging.BarcodePDF417ReaderGetBarcodeY2(i)
                    + "] Bottom-Right=[" + gdpictureImaging.BarcodePDF417ReaderGetBarcodeX3(i) + ", " + gdpictureImaging.BarcodePDF417ReaderGetBarcodeY3(i)
                    + "] Bottom-Left=[" + gdpictureImaging.BarcodePDF417ReaderGetBarcodeX4(i) + ", " + gdpictureImaging.BarcodePDF417ReaderGetBarcodeY4(i) + "]");
            }
        }
     
        // Release used resources.
        gdpictureImaging.BarcodePDF417ReaderClear();
        gdpictureImaging.ReleaseGdPictureImage(imageID);
    }
    See Also