Class QualitySettings

QualitySettings class

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.

public sealed class QualitySettings

Properties

NameDescription
static HighPerformance { get; }HighPerformance recognition quality preset. High quality barcodes are recognized well in this mode.
static HighQuality { get; }HighQuality recognition quality preset. This preset is developed for low quality barcodes. Allows to detect highly damaged barcodes.
static MaxQuality { get; }MaxQuality recognition quality preset. This preset is developed to recognize all possible barcodes, even incorrect barcodes.
static NormalQuality { get; }NormalQuality recognition quality preset. Suitable for the most of barcodes
AllowIncorrectBarcodes { get; set; }Allows engine to recognize barcodes which has incorrect checksumm or incorrect values. Mode can be used to recognize damaged barcodes with incorrect text.
BarcodeQuality { get; set; }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.
ComplexBackground { get; set; }Mode which enables or disables additional recognition of color barcodes on color images.
Deconvolution { get; set; }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.
InverseImage { get; set; }Mode which enables or disables additional recognition of barcodes on images with inverted colors (luminance).
MinimalXDimension { get; set; }Minimal size of XDimension in pixels which is used with UseMinimalXDimension.
XDimension { get; set; }Recognition mode which sets size (from 1 to infinity) of barcode minimal element: matrix cell or bar.

Examples

This sample shows how to use QualitySettings with BarCodeReader

[C#]
//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);
}

See Also

Class Quadrangle Class RecognitionAbortedException