Barcode1DReaderDoScan(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

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

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

public GdPictureStatus Barcode1DReaderDoScan( 
   int ImageID
)

public function Barcode1DReaderDoScan( 
    ImageID: Integer
): GdPictureStatus;

public function Barcode1DReaderDoScan( 
   ImageID : int
) : GdPictureStatus;

public: GdPictureStatus Barcode1DReaderDoScan( 
   int ImageID
)

public:
GdPictureStatus Barcode1DReaderDoScan( 
   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 Barcode1DReaderDoScan(Int32,Barcode1DReaderScanMode,Barcode1DReaderType,Boolean,Int32,Boolean) method and set the ExpectedCount parameter to 1 and 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 all 1D barcodes in a given image and saving their information to a file.

using (GdPictureImaging gdpictureImaging = new GdPictureImaging())
{
    int imageID = gdpictureImaging.CreateGdPictureImageFromFile("image.jpg");
 
    // Start the barcode scanning process at the best quality to find all available 1D barcode symbols.
    gdpictureImaging.Barcode1DReaderDoScan(imageID);
 
    using (System.IO.StreamWriter file = new System.IO.StreamWriter("barcodes.txt"))
    {
        int barcodesFound = gdpictureImaging.Barcode1DReaderGetBarcodeCount();
        for (int i = 1; i <= barcodesFound; i++)
        {
            file.WriteLine(gdpictureImaging.Barcode1DReaderGetBarcodeValue(i));
        }
    }
 
    // Release used resources.
    gdpictureImaging.Barcode1DReaderClear();
    gdpictureImaging.ReleaseGdPictureImage(imageID);
}

Reference

GdPictureImaging Class
GdPictureImaging Members
Overload List
SetROI Method
GetStat Method
CreateGdPictureImageFromFile(String) Method
Barcode1DReaderGetBarcodeCount Method
Barcode1DReaderGetBarcodeValue(Int32) Method
Barcode1DReaderClear Method
ReleaseGdPictureImage Method