VintaSoft Barcode .NET SDK 16.0: Documentation for .NET developer
In This Topic
Barcode print quality tests
In This Topic
The SDK contains tests which allow to determine the print quality of 1D linear barcodes, 2D matrix barcodes (Aztec, DataMatrix, Han Xin Code, QR Code, Micro QR Code) and 2D multi-row barcodes with cross-row scanning ability (PDF417, PDF417Compact, MicroPDF417).


For testing the print quality of 1D linear barcodes, it is necessary to use the ISO15416QualityTest class.
The algorithm of test is based on ISO/IEC 15416 (Third edition). The test allows to evaluate the print quality of barcode using the following parameters:
Here is an example that shows how to test print quality of 1D barcodes:
using System;

using Vintasoft.Imaging;

using Vintasoft.Barcode;
using Vintasoft.Barcode.BarcodeInfo;
using Vintasoft.Barcode.QualityTests;

/// <summary>
/// Test that shows how to test the print quality of 1D barcodes.
/// </summary>
class ISO15416QualityTestExample
{

    /// <summary>
    /// Runs the test.
    /// </summary>
    public static void Test(string filename)
    {
        // load image with barcode from file
        using (VintasoftBitmap barcodeImage = ImageCodecs.Default.Decode(filename))
        {
            // read barcodes from image and test the print quality of 1D barcodes
            ReadBarcodesAndTestBarcodePrintQuality(barcodeImage);
        }
    }
    
    /// <summary>
    /// Reads barcodes from image and tests the print quality of 1D barcodes.
    /// </summary>
    static void ReadBarcodesAndTestBarcodePrintQuality(VintasoftBitmap imageWithBarcodes)
    {
        // create the barcode reader
        using (BarcodeReader reader = new BarcodeReader())
        {
            // specify that reader must collect information for quality test
            reader.Settings.CollectTestInformation = true;

            // specify that reader must search for Code39 and Code128 barcodes only
            reader.Settings.ScanBarcodeTypes = BarcodeType.Code39 | BarcodeType.Code128;

            // read barcodes
            IBarcodeInfo[] barcodeInfos = reader.ReadBarcodes(imageWithBarcodes);

            // for each found barcode
            for (int i = 0; i < barcodeInfos.Length; i++)
            {
                // test print quality of barcode using ISO 15416 test
                ISO15416QualityTest test =
                    new ISO15416QualityTest((BarcodeInfo1D)barcodeInfos[i], imageWithBarcodes);

                // print results of ISO 15416 test

                Console.WriteLine(string.Format("[{0}] {1}",
                    barcodeInfos[i].BarcodeType, barcodeInfos[i].Value));
                Console.WriteLine(string.Format("Overall symbol grade:            {0}", test.OverallSymbolGrade));
                if (test.DifferentDecodedValues)
                    Console.WriteLine("Scan profiles has different barcode decode values!");
                if (test.SymbolComponentQualityTests.Length == 1)
                {
                    ISO15416SymbolComponentQualityTest qualityTest = test.SymbolComponentQualityTests[0];
                    Console.WriteLine(string.Format("Scan reflectance profiles:       {0}",
                        qualityTest.ScanReflectanceProfiles.Length));
                    Console.WriteLine("Scan reflectance profile grades:");
                    for (int j = 0; j < qualityTest.ScanReflectanceProfiles.Length; j++)
                        Console.Write(qualityTest.ScanReflectanceProfiles[j].ScanGrade.AlphabeticGrade);
                }
                else
                {
                    for (int k = 0; k < test.SymbolComponentQualityTests.Length; k++)
                    {
                        Console.WriteLine(string.Format("Symbol component:                {0}", k + 1));
                        ISO15416SymbolComponentQualityTest qualityTest = test.SymbolComponentQualityTests[k];
                        Console.WriteLine(string.Format("Scan reflectance profiles:       {0}",
                            qualityTest.ScanReflectanceProfiles.Length));
                        Console.WriteLine("Scan reflectance profile grades:");
                        for (int j = 0; j < qualityTest.ScanReflectanceProfiles.Length; j++)
                            Console.Write(qualityTest.ScanReflectanceProfiles[j].ScanGrade.AlphabeticGrade);
                    }
                }
                Console.WriteLine();
                Console.WriteLine();
            }
        }
    }

}


Imports Vintasoft.Imaging

Imports Vintasoft.Barcode
Imports Vintasoft.Barcode.BarcodeInfo
Imports Vintasoft.Barcode.QualityTests

''' <summary>
''' Test that shows how to test the print quality of 1D barcodes.
''' </summary>
Class ISO15416QualityTestExample

    ''' <summary>
    ''' Runs the test.
    ''' </summary>
    Public Shared Sub Test(filename As String)
        ' load image with barcode from file
        Using barcodeImage As VintasoftBitmap = ImageCodecs.[Default].Decode(filename)
            ' read barcodes from image and test the print quality of 1D barcodes
            ReadBarcodesAndTestBarcodePrintQuality(barcodeImage)
        End Using
    End Sub

    ''' <summary>
    ''' Reads barcodes from image and tests the print quality of 1D barcodes.
    ''' </summary>
    Private Shared Sub ReadBarcodesAndTestBarcodePrintQuality(imageWithBarcodes As VintasoftBitmap)
        ' create the barcode reader
        Using reader As New BarcodeReader()
            ' specify that reader must collect information for quality test
            reader.Settings.CollectTestInformation = True

            ' specify that reader must search for Code39 and Code128 barcodes only
            reader.Settings.ScanBarcodeTypes = BarcodeType.Code39 Or BarcodeType.Code128

            ' read barcodes
            Dim barcodeInfos As IBarcodeInfo() = reader.ReadBarcodes(imageWithBarcodes)

            ' for each found barcode
            For i As Integer = 0 To barcodeInfos.Length - 1
                ' test print quality of barcode using ISO 15416 test
                Dim test As New ISO15416QualityTest(DirectCast(barcodeInfos(i), BarcodeInfo1D), imageWithBarcodes)

                ' print results of ISO 15416 test

                Console.WriteLine(String.Format("[{0}] {1}", barcodeInfos(i).BarcodeType, barcodeInfos(i).Value))
                Console.WriteLine(String.Format("Overall symbol grade:            {0}", test.OverallSymbolGrade))
                If test.DifferentDecodedValues Then
                    Console.WriteLine("Scan profiles has different barcode decode values!")
                End If
                If test.SymbolComponentQualityTests.Length = 1 Then
                    Dim qualityTest As ISO15416SymbolComponentQualityTest = test.SymbolComponentQualityTests(0)
                    Console.WriteLine(String.Format("Scan reflectance profiles:       {0}", qualityTest.ScanReflectanceProfiles.Length))
                    Console.WriteLine("Scan reflectance profile grades:")
                    For j As Integer = 0 To qualityTest.ScanReflectanceProfiles.Length - 1
                        Console.Write(qualityTest.ScanReflectanceProfiles(j).ScanGrade.AlphabeticGrade)
                    Next
                Else
                    For k As Integer = 0 To test.SymbolComponentQualityTests.Length - 1
                        Console.WriteLine(String.Format("Symbol component:                {0}", k + 1))
                        Dim qualityTest As ISO15416SymbolComponentQualityTest = test.SymbolComponentQualityTests(k)
                        Console.WriteLine(String.Format("Scan reflectance profiles:       {0}", qualityTest.ScanReflectanceProfiles.Length))
                        Console.WriteLine("Scan reflectance profile grades:")
                        For j As Integer = 0 To qualityTest.ScanReflectanceProfiles.Length - 1
                            Console.Write(qualityTest.ScanReflectanceProfiles(j).ScanGrade.AlphabeticGrade)
                        Next
                    Next
                End If
                Console.WriteLine()
                Console.WriteLine()
            Next
        End Using
    End Sub

End Class




For testing the print quality of 2D matrix barcodes (Aztec, DataMatrix, Han Xin Code, QR Code, Micro QR Code), it is necessary to use the ISO15415QualityTest class.
The algorithm of test is based on ISO/IEC 15415 (Third edition). The test allows to evaluate the print quality of barcode using the following parameters:
Additional grades for Data Matrix barcode (defined in ISO 16022 Annex M):
Here is an example that shows how to test print quality of 2D matrix barcodes (Aztec, DataMatrix, Han Xin Code, QR Code, Micro QR Code):
using System;

using Vintasoft.Imaging;

using Vintasoft.Barcode;
using Vintasoft.Barcode.BarcodeInfo;
using Vintasoft.Barcode.QualityTests;

/// <summary>
/// Test that shows how to test the print quality of matrix 2D barcodes
/// (Aztec, DataMatrix, Han Xin Code, QR and MicroQR).
/// </summary>
class ISO15415QualityTestMatrixBarcodeExample
{

    /// <summary>
    /// Runs the test.
    /// </summary>
    public static void Test(string filename)
    {
        // load image with barcode from file
        using (VintasoftBitmap barcodeImage = ImageCodecs.Default.Decode(filename))
        {
            // read barcodes from image and test the print quality of 2D barcodes
            ReadBarcodesAndTestBarcodePrintQuality(barcodeImage);
        }
    }

    /// <summary>
    /// Reads barcodes from image and tests the print quality of 2D barcodes.
    /// </summary>
    public static void ReadBarcodesAndTestBarcodePrintQuality(VintasoftBitmap imageWithBarcodes)
    {
        // create the barcode reader
        using (BarcodeReader reader = new BarcodeReader())
        {
            // specify that reader must collect information for quality test
            reader.Settings.CollectTestInformation = true;

            // specify that reader must search for Aztec, DataMatrix, Han Xin Code, QR and MicroQR barcodes only
            reader.Settings.ScanBarcodeTypes =
                BarcodeType.Aztec | BarcodeType.DataMatrix |
                BarcodeType.QR | BarcodeType.MicroQR | BarcodeType.HanXinCode;

            // read barcodes
            IBarcodeInfo[] barcodeInfos = reader.ReadBarcodes(imageWithBarcodes);

            // for each found barcode
            for (int i = 0; i < barcodeInfos.Length; i++)
            {
                // test print quality of barcode using ISO 15415 test
                ISO15415QualityTest test = new ISO15415QualityTest();
                test.CalculateGrades((BarcodeInfo2D)barcodeInfos[i], imageWithBarcodes);

                // print results of ISO 15415 test

                Console.WriteLine(string.Format("[{0}] {1}",
                    barcodeInfos[i].BarcodeType, barcodeInfos[i].Value));
                Console.WriteLine(string.Format("Decode                                  : {0}", test.Decode));
                Console.WriteLine(string.Format("Unused error correction                 : {0} ({1})", test.UnusedErrorCorrection, test.UnusedErrorCorrection.ValueText));
                Console.WriteLine(string.Format("Symbol contrast                         : {0} ({1})", test.SymbolContrast, test.SymbolContrast.ValueText));
                Console.WriteLine(string.Format("Axial nonuniformity                     : {0} ({1})", test.AxialNonuniformity, test.AxialNonuniformity.ValueText));
                Console.WriteLine(string.Format("Grid nonuniformity                      : {0} ({1})", test.GridNonuniformity, test.GridNonuniformity.ValueText));
                Console.WriteLine(string.Format("Modulation                              : {0}", test.Modulation));
                Console.WriteLine(string.Format("Fixed pattern damage                    : {0}", test.FixedPatternDamage));
                foreach (string name in test.AdditionalGrades.Keys)
                    Console.WriteLine(string.Format("{0}: {1}", name.PadRight(40, ' '), test.AdditionalGrades[name]));
                if (test.QuietZone != null)
                    Console.WriteLine(string.Format("Quiet zone                              : {0} ({1})", test.QuietZone.GradeText, test.QuietZone.ValueText));
                Console.WriteLine(string.Format("Distortion angle (informative)          : {0}", test.DistortionAngle.ValueText));
                Console.WriteLine(string.Format("-------------Scan grade                 : {0}", test.OverallSymbolGrade));
                Console.WriteLine();
            }
        }
    }
}


Imports Vintasoft.Imaging

Imports Vintasoft.Barcode
Imports Vintasoft.Barcode.BarcodeInfo
Imports Vintasoft.Barcode.QualityTests

''' <summary>
''' Test that shows how to test the print quality of matrix 2D barcodes
''' (Aztec, DataMatrix, Han Xin Code, QR and MicroQR).
''' </summary>
Class ISO15415QualityTestMatrixBarcodeExample

    ''' <summary>
    ''' Runs the test.
    ''' </summary>
    Public Shared Sub Test(filename As String)
        ' load image with barcode from file
        Using barcodeImage As VintasoftBitmap = ImageCodecs.[Default].Decode(filename)
            ' read barcodes from image and test the print quality of 2D barcodes
            ReadBarcodesAndTestBarcodePrintQuality(barcodeImage)
        End Using
    End Sub

    ''' <summary>
    ''' Reads barcodes from image and tests the print quality of 2D barcodes.
    ''' </summary>
    Public Shared Sub ReadBarcodesAndTestBarcodePrintQuality(imageWithBarcodes As VintasoftBitmap)
        ' create the barcode reader
        Using reader As New BarcodeReader()
            ' specify that reader must collect information for quality test
            reader.Settings.CollectTestInformation = True

            ' specify that reader must search for Aztec, DataMatrix, Han Xin Code, QR and MicroQR barcodes only
            reader.Settings.ScanBarcodeTypes = BarcodeType.Aztec Or BarcodeType.DataMatrix Or BarcodeType.QR Or BarcodeType.MicroQR Or BarcodeType.HanXinCode

            ' read barcodes
            Dim barcodeInfos As IBarcodeInfo() = reader.ReadBarcodes(imageWithBarcodes)

            ' for each found barcode
            For i As Integer = 0 To barcodeInfos.Length - 1
                ' test print quality of barcode using ISO 15415 test
                Dim test As New ISO15415QualityTest()
                test.CalculateGrades(DirectCast(barcodeInfos(i), BarcodeInfo2D), imageWithBarcodes)

                ' print results of ISO 15415 test

                Console.WriteLine(String.Format("[{0}] {1}", barcodeInfos(i).BarcodeType, barcodeInfos(i).Value))
                Console.WriteLine(String.Format("Decode                                  : {0}", test.Decode))
                Console.WriteLine(String.Format("Unused error correction                 : {0} ({1})", test.UnusedErrorCorrection, test.UnusedErrorCorrection.ValueText))
                Console.WriteLine(String.Format("Symbol contrast                         : {0} ({1})", test.SymbolContrast, test.SymbolContrast.ValueText))
                Console.WriteLine(String.Format("Axial nonuniformity                     : {0} ({1})", test.AxialNonuniformity, test.AxialNonuniformity.ValueText))
                Console.WriteLine(String.Format("Grid nonuniformity                      : {0} ({1})", test.GridNonuniformity, test.GridNonuniformity.ValueText))
                Console.WriteLine(String.Format("Modulation                              : {0}", test.Modulation))
                Console.WriteLine(String.Format("Fixed pattern damage                    : {0}", test.FixedPatternDamage))
                For Each name As String In test.AdditionalGrades.Keys
                    Console.WriteLine(String.Format("{0}: {1}", name.PadRight(40, " "c), test.AdditionalGrades(name)))
                Next
                If test.QuietZone IsNot Nothing Then
                    Console.WriteLine(String.Format("Quiet zone                              : {0} ({1})", test.QuietZone.GradeText, test.QuietZone.ValueText))
                End If
                Console.WriteLine(String.Format("Distortion angle (informative)          : {0}", test.DistortionAngle.ValueText))
                Console.WriteLine(String.Format("-------------Scan grade                 : {0}", test.OverallSymbolGrade))
                Console.WriteLine()
            Next
        End Using
    End Sub
End Class




For testing the print quality of 2D multi-row barcodes with cross-row scanning ability (PDF417, PDF417Compact, MicroPDF417), it is necessary to use the ISO15415QualityTest class.
The algorithm of test is based on ISO/IEC 15415 (Third edition). The test allows to evaluate the print quality of barcode using the following parameters:
Here is an example that shows how to test print quality of 2D multi-row barcodes with cross-row scanning ability (PDF417, PDF417Compact, MicroPDF417):
using System;

using Vintasoft.Imaging;

using Vintasoft.Barcode;
using Vintasoft.Barcode.BarcodeInfo;
using Vintasoft.Barcode.QualityTests;

/// <summary>
/// Test that shows how to test the print quality of multi-row 2D barcodes
/// (PDF417, PDF417Compact and MicroPDF417).
/// </summary>
class ISO15415QualityTestMultiRowBarcodeExample
{

    /// <summary>
    /// Runs the test.
    /// </summary>
    public static void Test()
    {
        // load image with barcode from file
        using (VintasoftBitmap barcodeImage = ImageCodecs.Default.Decode("test1.jpg"))
        {
            // read barcodes from image and test the print quality of 2D barcodes
            ReadBarcodesAndTestBarcodePrintQuality(barcodeImage);
        }
    }

    /// <summary>
    /// Reads barcodes from image and tests the print quality of 2D barcodes.
    /// </summary>
    /// <param name="imageWithBarcodes"></param>
    public static void ReadBarcodesAndTestBarcodePrintQuality(VintasoftBitmap imageWithBarcodes)
    {
        // create the barcode reader
        using (BarcodeReader reader = new BarcodeReader())
        {
            // specify that reader must collect information for quality test
            reader.Settings.CollectTestInformation = true;

            // specify that reader must search for PDF417, PDF417Compact and MicroPDF417 barcodes only
            reader.Settings.ScanBarcodeTypes =
                BarcodeType.PDF417 | BarcodeType.PDF417Compact | BarcodeType.MicroPDF417;

            // read barcodes
            IBarcodeInfo[] barcodeInfos = reader.ReadBarcodes(imageWithBarcodes);

            // for each found barcode
            for (int i = 0; i < barcodeInfos.Length; i++)
            {
                // test print quality of barcode using ISO 15415 test
                ISO15415QualityTest test = new ISO15415QualityTest();
                test.CalculateGrades((BarcodeInfo2D)barcodeInfos[i], imageWithBarcodes);

                // print results of ISO 15415 test

                Console.WriteLine(string.Format("[{0}] {1}",
                    barcodeInfos[i].BarcodeType, barcodeInfos[i].Value));
                Console.WriteLine(string.Format("Decode                 : {0}", test.Decode));
                Console.WriteLine(string.Format("Unused error correction: {0} ({1})", test.UnusedErrorCorrection, test.UnusedErrorCorrection.ValueText));
                if (test.StartPatternTestGrade != null)
                    Console.WriteLine(string.Format("Start pattern test:      {0}", test.StartPatternTestGrade));
                if (test.CenterPatternTestGrade != null)
                    Console.WriteLine(string.Format("Center pattern test:     {0}", test.CenterPatternTestGrade));
                if (test.CenterPatternTestGrade != null)
                    Console.WriteLine(string.Format("Stop pattern test:       {0}", test.CenterPatternTestGrade));
                Console.WriteLine(string.Format("Codeword yield:          {0}", test.CodewordYield));
                Console.WriteLine(string.Format("Codeword print quality:  {0}", test.CodewordPrintQualityGrade));
                if (test.QuietZone >= 0)
                    Console.WriteLine(string.Format("Quiet zone:              {0} ({1})", test.QuietZone, test.QuietZone.ValueText));
                Console.WriteLine(string.Format("Distortion angle:        {0}", test.DistortionAngle.ValueText));
                Console.WriteLine(string.Format("-------------Scan grade: {0}", test.OverallSymbolGrade));
                Console.WriteLine();
            }
        }
    }
}


Imports Vintasoft.Imaging

Imports Vintasoft.Barcode
Imports Vintasoft.Barcode.BarcodeInfo
Imports Vintasoft.Barcode.QualityTests

''' <summary>
''' Test that shows how to test the print quality of multi-row 2D barcodes
''' (PDF417, PDF417Compact and MicroPDF417).
''' </summary>
Class ISO15415QualityTestMultiRowBarcodeExample

    ''' <summary>
    ''' Runs the test.
    ''' </summary>
    Public Shared Sub Test()
        ' load image with barcode from file
        Using barcodeImage As VintasoftBitmap = ImageCodecs.[Default].Decode("test1.jpg")
            ' read barcodes from image and test the print quality of 2D barcodes
            ReadBarcodesAndTestBarcodePrintQuality(barcodeImage)
        End Using
    End Sub

    ''' <summary>
    ''' Reads barcodes from image and tests the print quality of 2D barcodes.
    ''' </summary>
    ''' <param name="imageWithBarcodes"></param>
    Public Shared Sub ReadBarcodesAndTestBarcodePrintQuality(imageWithBarcodes As VintasoftBitmap)
        ' create the barcode reader
        Using reader As New BarcodeReader()
            ' specify that reader must collect information for quality test
            reader.Settings.CollectTestInformation = True

            ' specify that reader must search for PDF417, PDF417Compact and MicroPDF417 barcodes only
            reader.Settings.ScanBarcodeTypes = BarcodeType.PDF417 Or BarcodeType.PDF417Compact Or BarcodeType.MicroPDF417

            ' read barcodes
            Dim barcodeInfos As IBarcodeInfo() = reader.ReadBarcodes(imageWithBarcodes)

            ' for each found barcode
            For i As Integer = 0 To barcodeInfos.Length - 1
                ' test print quality of barcode using ISO 15415 test
                Dim test As New ISO15415QualityTest()
                test.CalculateGrades(DirectCast(barcodeInfos(i), BarcodeInfo2D), imageWithBarcodes)

                ' print results of ISO 15415 test

                Console.WriteLine(String.Format("[{0}] {1}", barcodeInfos(i).BarcodeType, barcodeInfos(i).Value))
                Console.WriteLine(String.Format("Decode                 : {0}", test.Decode))
                Console.WriteLine(String.Format("Unused error correction: {0} ({1})", test.UnusedErrorCorrection, test.UnusedErrorCorrection.ValueText))
                If test.StartPatternTestGrade IsNot Nothing Then
                    Console.WriteLine(String.Format("Start pattern test:      {0}", test.StartPatternTestGrade))
                End If
                If test.CenterPatternTestGrade IsNot Nothing Then
                    Console.WriteLine(String.Format("Center pattern test:     {0}", test.CenterPatternTestGrade))
                End If
                If test.CenterPatternTestGrade IsNot Nothing Then
                    Console.WriteLine(String.Format("Stop pattern test:       {0}", test.CenterPatternTestGrade))
                End If
                Console.WriteLine(String.Format("Codeword yield:          {0}", test.CodewordYield))
                Console.WriteLine(String.Format("Codeword print quality:  {0}", test.CodewordPrintQualityGrade))
                If test.QuietZone IsNot Nothing Then
                    Console.WriteLine(String.Format("Quiet zone:              {0} ({1})", test.QuietZone, test.QuietZone.ValueText))
                End If
                Console.WriteLine(String.Format("Distortion angle:        {0}", test.DistortionAngle.ValueText))
                Console.WriteLine(String.Format("-------------Scan grade: {0}", test.OverallSymbolGrade))
                Console.WriteLine()
            Next
        End Using
    End Sub
End Class