GdPicture.NET.14
GdPicture14 Namespace / GdPictureImaging Class / BarcodeDataMatrixReaderGetBarcodeX1 Method
Barcode index. Must be between 1 and BarcodeDataMatrixReaderGetBarcodeCount returned value.
Example





In This Topic
BarcodeDataMatrixReaderGetBarcodeX1 Method (GdPictureImaging)
In This Topic
Returns the X position (in pixels) of the top-left corner of a barcode detected by the BarcodeDataMatrixReaderDoScan method. If ROI has been set, this coordinate is relative to the used ROI.
Syntax
'Declaration
 
Public Function BarcodeDataMatrixReaderGetBarcodeX1( _
   ByVal BarcodeNo As Integer _
) As Integer
public int BarcodeDataMatrixReaderGetBarcodeX1( 
   int BarcodeNo
)
public function BarcodeDataMatrixReaderGetBarcodeX1( 
    BarcodeNo: Integer
): Integer; 
public function BarcodeDataMatrixReaderGetBarcodeX1( 
   BarcodeNo : int
) : int;
public: int BarcodeDataMatrixReaderGetBarcodeX1( 
   int BarcodeNo
) 
public:
int BarcodeDataMatrixReaderGetBarcodeX1( 
   int BarcodeNo
) 

Parameters

BarcodeNo
Barcode index. Must be between 1 and BarcodeDataMatrixReaderGetBarcodeCount returned value.

Return Value

The barcode X position of the top-left corner; relative to the ROI, if any is defined.
Remarks

This method is used in the "Barcode Recognition" Demo.

Example
Finding DataMatrix barcodes in an image and writes complete barcodes info into a file.
using (GdPictureImaging gdpictureImaging = new GdPictureImaging())
{
    int imageID = gdpictureImaging.CreateGdPictureImageFromFile("image.jpg", false);
 
    // Set to 0, so all the DataMatrix barcodes in the image should be found.
    int expectedBarcodes = 0;
 
    // Perform scanning at best speed, ignoring very damaged barcodes.
    BarcodeDataMatrixReaderScanMode mode = BarcodeDataMatrixReaderScanMode.BestSpeed;
 
    // Start the DataMatrix scanning process and write info into a text file.
    gdpictureImaging.BarcodeDataMatrixReaderDoScan(imageID, mode, expectedBarcodes);
 
    using (System.IO.StreamWriter file = new System.IO.StreamWriter("DataMatrix.txt"))
    {
        int barcodesFound = gdpictureImaging.BarcodeDataMatrixReaderGetBarcodeCount();
 
        for (int i = 1; i <= barcodesFound; i++)
        {
            // Decoded information.
            file.WriteLine("Decoded info = " + gdpictureImaging.BarcodeDataMatrixReaderGetBarcodeValue(i));
 
            // The skew angle of the barcode, in degrees.
            file.WriteLine("Skew angle = " + gdpictureImaging.BarcodeDataMatrixReaderGetBarcodeSkewAngle(i));
 
            // The number of rows of the barcode.
            file.WriteLine("Rows = " + gdpictureImaging.BarcodeDataMatrixReaderGetBarcodeRows(i));
 
            // The number of columns of the barcode.
            file.WriteLine("Columns = " + gdpictureImaging.BarcodeDataMatrixReaderGetBarcodeColumns(i));
 
            // The raw bytes decoded. It was post-processed to find the correct decoded info based on detected Encoding.
            file.WriteLine("Raw bytes = " + gdpictureImaging.BarcodeDataMatrixReaderGetBarcodeValueRAW(i));
 
            // The barcode position, given by the coordinates of the corners.
            file.WriteLine("Position =  Top-Left=["
                + gdpictureImaging.BarcodeDataMatrixReaderGetBarcodeX1(i) + ", " + gdpictureImaging.BarcodeDataMatrixReaderGetBarcodeY1(i)
                + "] Top-Right=[" + gdpictureImaging.BarcodeDataMatrixReaderGetBarcodeX2(i) + ", " + gdpictureImaging.BarcodeDataMatrixReaderGetBarcodeY2(i)
                + "] Bottom-Right=[" + gdpictureImaging.BarcodeDataMatrixReaderGetBarcodeX3(i) + ", " + gdpictureImaging.BarcodeDataMatrixReaderGetBarcodeY3(i)
                + "] Bottom-Left=[" + gdpictureImaging.BarcodeDataMatrixReaderGetBarcodeX4(i) + ", " + gdpictureImaging.BarcodeDataMatrixReaderGetBarcodeY4(i) + "]");
        }
    }
 
    // Release used resources.
    gdpictureImaging.BarcodeDataMatrixReaderClear();
    gdpictureImaging.ReleaseGdPictureImage(imageID);
}
See Also