Aspose::BarCode::BarCodeRecognition::QualitySettings Class Referencefinal

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. More...

Inherits System::Object.

Public Member Functions

XDimensionMode get_XDimension () const
 Recognition mode which sets size (from 1 to infinity) of barcode minimal element: matrix cell or bar. More...
 
void set_XDimension (XDimensionMode value)
 Recognition mode which sets size (from 1 to infinity) of barcode minimal element: matrix cell or bar. More...
 
float get_MinimalXDimension () const
 Minimal size of XDimension in pixels which is used with UseMinimalXDimension. More...
 
void set_MinimalXDimension (float value)
 Minimal size of XDimension in pixels which is used with UseMinimalXDimension. More...
 
BarcodeQualityMode get_BarcodeQuality () const
 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.
More...
 
void set_BarcodeQuality (BarcodeQualityMode value)
 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.
More...
 
DeconvolutionMode get_Deconvolution () const
 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. More...
 
void set_Deconvolution (DeconvolutionMode value)
 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. More...
 
InverseImageMode get_InverseImage () const
 Mode which enables or disables additional recognition of barcodes on images with inverted colors (luminance). More...
 
void set_InverseImage (InverseImageMode value)
 Mode which enables or disables additional recognition of barcodes on images with inverted colors (luminance). More...
 
ComplexBackgroundMode get_ComplexBackground () const
 Mode which enables or disables additional recognition of color barcodes on color images. More...
 
void set_ComplexBackground (ComplexBackgroundMode value)
 Mode which enables or disables additional recognition of color barcodes on color images. More...
 
bool get_AllowIncorrectBarcodes () const
 Allows engine to recognize barcodes which has incorrect checksumm or incorrect values. Mode can be used to recognize damaged barcodes with incorrect text. More...
 
void set_AllowIncorrectBarcodes (bool value)
 Allows engine to recognize barcodes which has incorrect checksumm or incorrect values. Mode can be used to recognize damaged barcodes with incorrect text. More...
 
- Public Member Functions inherited from System::Object
ASPOSECPP_SHARED_API Object ()
 Creates object. Initializes all internal data structures. More...
 
virtual ASPOSECPP_SHARED_API ~Object ()
 Destroys object. Frees all internal data structures. More...
 
ASPOSECPP_SHARED_API Object (Object const &x)
 Copy constructor. Doesn't copy anything, really, just initializes new object and enables copy constructing subclasses. More...
 
Objectoperator= (Object const &x)
 Assignment operator. Doesn't copy anything, really, just initializes new object and enables copy constructing subclasses. More...
 
ObjectSharedRefAdded ()
 Increments shared reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
int SharedRefRemovedSafe ()
 Decrements and returns shared reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
int RemovedSharedRefs (int count)
 Decreases shared reference count by specified value. More...
 
Detail::SmartPtrCounter * WeakRefAdded ()
 Increments weak reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
void WeakRefRemoved ()
 Decrements weak reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
Detail::SmartPtrCounter * GetCounter ()
 Gets reference counter data structure associated with the object. More...
 
int SharedCount () const
 Gets current value of shared reference counter. More...
 
ASPOSECPP_SHARED_API void Lock ()
 Implements C# lock() statement locking. Call directly or use LockContext sentry object. More...
 
ASPOSECPP_SHARED_API void Unlock ()
 Implements C# lock() statement unlocking. Call directly or use LockContext sentry object. More...
 
virtual ASPOSECPP_SHARED_API bool Equals (ptr obj)
 Compares objects using C# Object.Equals semantics. More...
 
virtual ASPOSECPP_SHARED_API int32_t GetHashCode () const
 Analog of C# Object.GetHashCode() method. Enables hashing of custom objects. More...
 
virtual ASPOSECPP_SHARED_API String ToString () const
 Analog of C# Object.ToString() method. Enables converting custom objects to string. More...
 
virtual ASPOSECPP_SHARED_API ptr MemberwiseClone () const
 Analog of C# Object.MemberwiseClone() method. Enables cloning custom types. More...
 
virtual ASPOSECPP_SHARED_API const TypeInfoGetType () const
 Gets actual type of object. Analog of C# System.Object.GetType() call. More...
 
virtual ASPOSECPP_SHARED_API bool Is (const TypeInfo &targetType) const
 Check if object represents an instance of type described by targetType. Analog of C# 'is' operator. More...
 
virtual ASPOSECPP_SHARED_API void SetTemplateWeakPtr (uint32_t argument)
 Set n'th template argument a weak pointer (rather than shared). Allows switching pointers in containers to weak mode. More...
 
virtual ASPOSECPP_SHARED_API bool FastCast (const Details::FastRttiBase &helper, void **out_ptr) const
 For internal purposes only. More...
 
template<>
bool Equals (float const &objA, float const &objB)
 
template<>
bool Equals (double const &objA, double const &objB)
 
template<>
bool ReferenceEquals (String const &str, std::nullptr_t)
 
template<>
bool ReferenceEquals (String const &str1, String const &str2)
 

Static Public Member Functions

static System::SharedPtr< QualitySettingsget_HighPerformance ()
 HighPerformance recognition quality preset. High quality barcodes are recognized well in this mode. More...
 
static System::SharedPtr< QualitySettingsget_NormalQuality ()
 NormalQuality recognition quality preset. Suitable for the most of barcodes More...
 
static System::SharedPtr< QualitySettingsget_HighQuality ()
 HighQuality recognition quality preset. This preset is developed for low quality barcodes. Allows to detect highly damaged barcodes. More...
 
static System::SharedPtr< QualitySettingsget_MaxQuality ()
 MaxQuality recognition quality preset. This preset is developed to recognize all possible barcodes, even incorrect barcodes. More...
 
- Static Public Member Functions inherited from System::Object
static bool ReferenceEquals (ptr const &objA, ptr const &objB)
 Compares objects by reference. More...
 
template<typename T >
static std::enable_if<!IsSmartPtr< T >::value, bool >::type ReferenceEquals (T const &objA, T const &objB)
 Compares objects by reference. More...
 
template<typename T >
static std::enable_if<!IsSmartPtr< T >::value, bool >::type ReferenceEquals (T const &objA, std::nullptr_t)
 Reference-compares value type object with nullptr. More...
 
template<typename T1 , typename T2 >
static std::enable_if< IsSmartPtr< T1 >::value &&IsSmartPtr< T2 >::value, bool >::type Equals (T1 const &objA, T2 const &objB)
 Compares reference type objects in C# style. More...
 
template<typename T1 , typename T2 >
static std::enable_if<!IsSmartPtr< T1 >::value &&!IsSmartPtr< T2 >::value, bool >::type Equals (T1 const &objA, T2 const &objB)
 Compares value type objects in C# style. More...
 
static const TypeInfoType ()
 Implements C# typeof(System.Object) construct. More...
 

Additional Inherited Members

- Public Types inherited from System::Object
typedef SmartPtr< Objectptr
 Alias for smart pointer type. More...
 

Detailed Description

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.

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);
}
<br>

Member Function Documentation

◆ get_AllowIncorrectBarcodes()

bool Aspose::BarCode::BarCodeRecognition::QualitySettings::get_AllowIncorrectBarcodes ( ) const

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

Allows engine to recognize incorrect barcodes.

◆ get_BarcodeQuality()

BarcodeQualityMode Aspose::BarCode::BarCodeRecognition::QualitySettings::get_BarcodeQuality ( ) const

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.

Mode which enables methods to recognize barcode elements with the selected quality.

◆ get_ComplexBackground()

ComplexBackgroundMode Aspose::BarCode::BarCodeRecognition::QualitySettings::get_ComplexBackground ( ) const

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

Additional recognition of color barcodes on color images.

◆ get_Deconvolution()

DeconvolutionMode Aspose::BarCode::BarCodeRecognition::QualitySettings::get_Deconvolution ( ) const

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.

Deconvolution mode which defines level of image degradation.

◆ get_HighPerformance()

static System::SharedPtr<QualitySettings> Aspose::BarCode::BarCodeRecognition::QualitySettings::get_HighPerformance ( )
static

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

This sample shows how to use HighPerformance mode

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

HighPerformance recognition quality preset.

◆ get_HighQuality()

static System::SharedPtr<QualitySettings> Aspose::BarCode::BarCodeRecognition::QualitySettings::get_HighQuality ( )
static

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

This sample shows how to use HighQuality mode

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

HighQuality recognition quality preset.

◆ get_InverseImage()

InverseImageMode Aspose::BarCode::BarCodeRecognition::QualitySettings::get_InverseImage ( ) const

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

Additional recognition of barcodes on images with inverse colors

◆ get_MaxQuality()

static System::SharedPtr<QualitySettings> Aspose::BarCode::BarCodeRecognition::QualitySettings::get_MaxQuality ( )
static

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

This sample shows how to use MaxQuality mode

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

MaxQuality recognition quality preset.

◆ get_MinimalXDimension()

float Aspose::BarCode::BarCodeRecognition::QualitySettings::get_MinimalXDimension ( ) const

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

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

◆ get_NormalQuality()

static System::SharedPtr<QualitySettings> Aspose::BarCode::BarCodeRecognition::QualitySettings::get_NormalQuality ( )
static

NormalQuality recognition quality preset. Suitable for the most of barcodes

This sample shows how to use NormalQuality mode

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

NormalQuality recognition quality preset.

◆ get_XDimension()

XDimensionMode Aspose::BarCode::BarCodeRecognition::QualitySettings::get_XDimension ( ) const

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

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

◆ set_AllowIncorrectBarcodes()

void Aspose::BarCode::BarCodeRecognition::QualitySettings::set_AllowIncorrectBarcodes ( bool  value)

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

Allows engine to recognize incorrect barcodes.

◆ set_BarcodeQuality()

void Aspose::BarCode::BarCodeRecognition::QualitySettings::set_BarcodeQuality ( BarcodeQualityMode  value)

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.

Mode which enables methods to recognize barcode elements with the selected quality.

◆ set_ComplexBackground()

void Aspose::BarCode::BarCodeRecognition::QualitySettings::set_ComplexBackground ( ComplexBackgroundMode  value)

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

Additional recognition of color barcodes on color images.

◆ set_Deconvolution()

void Aspose::BarCode::BarCodeRecognition::QualitySettings::set_Deconvolution ( DeconvolutionMode  value)

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.

Deconvolution mode which defines level of image degradation.

◆ set_InverseImage()

void Aspose::BarCode::BarCodeRecognition::QualitySettings::set_InverseImage ( InverseImageMode  value)

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

Additional recognition of barcodes on images with inverse colors

◆ set_MinimalXDimension()

void Aspose::BarCode::BarCodeRecognition::QualitySettings::set_MinimalXDimension ( float  value)

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

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

◆ set_XDimension()

void Aspose::BarCode::BarCodeRecognition::QualitySettings::set_XDimension ( XDimensionMode  value)

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

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