Класс ISO15415QualityTest
В этом разделе
Тест качества печати штрих-кодов ISO/IEC 15415:2024 для двумерных штрих-кодов.
Объектная модель
Синтаксис
'Declaration
Public Class ISO15415QualityTest
public class ISO15415QualityTest
public __gc class ISO15415QualityTest
public ref class ISO15415QualityTest
Ремарки
Мы рекомендуем использовать класс QualityTestManager для тестирования качества печати двумерных штрих-кодов.
Тест можно использовать для проверки качества печати двумерных матричных штрих-кодов (Aztec, DataMatrix, QR Code, Micro QR Code, Han Xin Code). Алгоритм теста основан на ISO/IEC 15415:2024 (третье издание). Тест позволяет оценить качество печати штрих-кода, используя следующие параметры:
Также тест можно использовать для проверки качества печати двумерных многострочных штрих-кодов с возможностью сканирования между строками (PDF417, PDF417Compact, MicroPDF417). Алгоритм тестирования основан на стандарте ISO/IEC 15415. Тест позволяет оценить качество печати штрих-кода, используя следующие параметры:
Пример
Вот пример, который демонстрирует как выполнить проверку качества печати матричных 2D штрих-кодов (Aztec, DataMatrix, QR, MicroQR и Han Xin Code) и многострочных 2D штрих-кодов (PDF417, PDF417Compact и MicroPDF417):
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 ISO15415QualityTestMatrixExample
''' <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
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 ISO15415QualityTestMultiRowExample
{
/// <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();
}
}
}
}
Иерархия наследования
System.Object
 Vintasoft.Barcode.QualityTests.ISO15415QualityTest
Требования
Целевые платформы: .NET 10; .NET 9; .NET 8; .NET 7; .NET 6; .NET Framework 4.8, 4.7, 4.6, 4.5, 4.0, 3.5
Смотрите также