Class QualitySettings

Namespace: Aspose.BarCode.BarCodeRecognition
Assembly: Aspose.BarCode.dll (25.2.0)

QualitySettings allows to configure recognition quality and speed manually. You can quickly set up QualitySettings with embedded presets: HighPerformance, NormalQuality, HighQuality, MaxQuality or you can manually configure separate options. Default value of QualitySettings is NormalQuality.

[XmlSerialization(Name = "Aspose.BarCode.Reader.Properties.QualitySettings")]
public sealed class QualitySettings

Inheritance

object ← QualitySettings

Inherited Members

object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Examples

This sample shows how to use QualitySettings with BarCodeReader

//set HighPerformance recogition mode
using (BarCodeReader reader = new BarCodeReader(@"c:\test.png", DecodeType.Code39Extended, DecodeType.Code128))
{
    reader.QualitySettings = QualitySettings.HighPerformance;
    foreach (BarCodeResult result in reader.ReadBarCodes())
        Console.WriteLine(result.CodeText);
}

//set HighQuality recognition mode
using (BarCodeReader reader = new BarCodeReader(@"c:\test.png", DecodeType.Code39Extended, DecodeType.Code128))
{
    reader.QualitySettings = QualitySettings.HighQuality;
    foreach (BarCodeResult result in reader.ReadBarCodes())
        Console.WriteLine(result.CodeText);
}

//set HighPerformance recogition mode for low sized barcodes
using (BarCodeReader reader = new BarCodeReader(@"c:\test.png", DecodeType.Code39Extended, DecodeType.Code128))
{
    reader.QualitySettings = QualitySettings.HighPerformance;
    reader.QualitySettings.XDimension = XDimensionMode.Small;
    foreach (BarCodeResult result in reader.ReadBarCodes())
        Console.WriteLine(result.CodeText);
}

//set HighPerformance recogition mode for low quality barcodes
using (BarCodeReader reader = new BarCodeReader(@"c:\test.png", DecodeType.Code39Extended, DecodeType.Code128))
{
    reader.QualitySettings = QualitySettings.HighPerformance;
    reader.QualitySettings.BarcodeQuality = BarcodeQualityMode.Low;
    foreach (BarCodeResult result in reader.ReadBarCodes())
        Console.WriteLine(result.CodeText);
}

Properties

AllowIncorrectBarcodes

Allows engine to recognize barcodes which has incorrect checksumm or incorrect values. Mode can be used to recognize damaged barcodes with incorrect text.

[XmlSerialization(Type = XmlSerializationType.Element)]
public bool AllowIncorrectBarcodes { get; set; }

Property Value

bool

BarcodeQuality

Mode which enables methods to recognize barcode elements with the selected quality. Barcode element with lower quality requires more hard methods which slows the recognition.

[XmlSerialization(Type = XmlSerializationType.Element)]
public BarcodeQualityMode BarcodeQuality { get; set; }

Property Value

BarcodeQualityMode

ComplexBackground

Mode which enables or disables additional recognition of color barcodes on color images.

[XmlSerialization(Type = XmlSerializationType.Element)]
public ComplexBackgroundMode ComplexBackground { get; set; }

Property Value

ComplexBackgroundMode

Deconvolution

Deconvolution (image restorations) mode which defines level of image degradation. Originally deconvolution is a function which can restore image degraded (convoluted) by any natural function like blur, during obtaining image by camera. Because we cannot detect image function which corrupt the image, we have to check most well know functions like sharp or mathematical morphology.

[XmlSerialization(Type = XmlSerializationType.Element)]
public DeconvolutionMode Deconvolution { get; set; }

Property Value

DeconvolutionMode

HighPerformance

HighPerformance recognition quality preset. High quality barcodes are recognized well in this mode.

public static QualitySettings HighPerformance { get; }

Property Value

QualitySettings

Examples

This sample shows how to use HighPerformance mode

using (BarCodeReader reader = new BarCodeReader(@"c:\test.png", DecodeType.Code39Extended, DecodeType.Code128))
{
    reader.QualitySettings = QualitySettings.HighPerformance;
    foreach (BarCodeResult result in reader.ReadBarCodes())
        Console.WriteLine(result.CodeText);
}

HighQuality

HighQuality recognition quality preset. This preset is developed for low quality barcodes. Allows to detect highly damaged barcodes.

public static QualitySettings HighQuality { get; }

Property Value

QualitySettings

Examples

This sample shows how to use HighQuality mode

using (BarCodeReader reader = new BarCodeReader(@"c:\test.png", DecodeType.Code39Extended, DecodeType.Code128))
{
    reader.QualitySettings = QualitySettings.HighQuality;
    foreach (BarCodeResult result in reader.ReadBarCodes())
        Console.WriteLine(result.CodeText);
}

InverseImage

Mode which enables or disables additional recognition of barcodes on images with inverted colors (luminance).

[XmlSerialization(Type = XmlSerializationType.Element)]
public InverseImageMode InverseImage { get; set; }

Property Value

InverseImageMode

MaxQuality

MaxQuality recognition quality preset. This preset is developed to recognize all possible barcodes, even incorrect barcodes.

public static QualitySettings MaxQuality { get; }

Property Value

QualitySettings

Examples

This sample shows how to use MaxQuality mode

using (BarCodeReader reader = new BarCodeReader(@"c:\test.png", DecodeType.Code39Extended, DecodeType.Code128))
{
    reader.QualitySettings = QualitySettings.MaxQuality;
    foreach (BarCodeResult result in reader.ReadBarCodes())
        Console.WriteLine(result.CodeText);
}

MinimalXDimension

Minimal size of XDimension in pixels which is used with UseMinimalXDimension.

[XmlSerialization(Type = XmlSerializationType.Element)]
public float MinimalXDimension { get; set; }

Property Value

float

NormalQuality

NormalQuality recognition quality preset. Suitable for the most of barcodes

public static QualitySettings NormalQuality { get; }

Property Value

QualitySettings

Examples

This sample shows how to use NormalQuality mode

using (BarCodeReader reader = new BarCodeReader(@"c:\test.png", DecodeType.Code39Extended, DecodeType.Code128))
{
    reader.QualitySettings = QualitySettings.NormalQuality;
    foreach (BarCodeResult result in reader.ReadBarCodes())
        Console.WriteLine(result.CodeText);
}

XDimension

Recognition mode which sets size (from 1 to infinity) of barcode minimal element: matrix cell or bar.

[XmlSerialization(Type = XmlSerializationType.Element)]
public XDimensionMode XDimension { get; set; }

Property Value

XDimensionMode