DSSimplifiedBarcodeReaderSettings
The DSSimplifiedBarcodeReaderSettings
class comes from the DSSimplifiedCaptureVisionSettings
class and contains settings specific to barcode decoding.
Definition
Assembly: DynamsoftBarcodeReader.xcframework
- Objective-C
- Swift
NS_SWIFT_NAME(SimplifiedBarcodeReaderSettings) @interface DSSimplifiedBarcodeReaderSettings : NSObject
class SimplifiedBarcodeReaderSettings : NSObject
Attributes
Attributes | Type | Description |
---|---|---|
barcodeFormatIds |
DSBarcodeFormat | Defines a combined value of BarcodeFormat to specify which barcode format(s) the library should target. |
expectedBarcodesCount |
NSInteger | Sets the expected barcode count. |
localizationModes |
NSArray | Defines the localization algorithm(s) used to localize barcodes. |
deblurModes |
NSArray | Sets the priority for which deblurring algorithms the library will employ when dealing with blurry images. |
minResultConfidence |
NSInteger | Sets the minimum barcode result confidence to filter out the low confidence results. |
minBarcodeTextLength |
NSInteger | Sets the minimum barcode result text length. |
barcodeTextRegExPattern |
NSString | Sets a RegEx pattern for the barcode text. |
maxThreadsInOneTask |
NSInteger | Sets the max available threads for one task. |
grayscaleTransformationModes |
NSArray | Sets which grayscale transformation mode(s) the library will employ when reading barcodes. |
grayscaleEnhancementModes |
NSArray | Sets which grayscale enhancement mode(s) the library will use when reading barcodes. |
scaleDownThreshold |
NSInteger | Sets the threshold for image shrinking. |
barcodeFormatIds
Defines a combined value of enumeration BarcodeFormat
to specify which barcode format(s) the library should target.
- Objective-C
- Swift
@property(nonatomic, assign) DSBarcodeFormat barcodeFormatIds;
var barcodeFormatIds: DSBarcodeFormat { get set }
expectedBarcodesCount
Sets the expected barcode count. You can set it to 0 if the barcode count is unknown.
- Objective-C
- Swift
@property(nonatomic, assign) NSInteger expectedBarcodesCount;
var expectedBarcodesCount: Int { get set }
Remarks
- Set
expectedBarcodesCount
to 0 if the barcode count is unknown. The library will try to find at least 1 barcode. - Set
expectedBarcodesCount
to 1 to reach the highest speed for processing single barcode. - Set
expectedBarcodesCount
to “n” if there will be “n” barcodes to process from an image. - Set
expectedBarcodesCount
to the highest expected value if there exists multiple barcodes but the exact count is not confirmed.
localizationModes
Defines the localization algorithm(s) used to localize barcodes. The array consists of one or more modes, with each LocalizationMode representing a different localization process.
- Objective-C
- Swift
@property(nonatomic, nullable, copy) NSArray *localizationModes;
var localizationModes: [LocalizationMode]? { get set }
Remarks
If you would like to learn more about the localization modes and how they work, please read the parameter reference of LocalizationModes for more information.
deblurModes
Sets the priority for which deblurring algorithms the library will employ when dealing with blurry images. This array consists of DeblurMode
items.
- Objective-C
- Swift
@property(nonatomic, nullable, copy) NSArray *deblurModes;
var deblurModes: [DeblurMode]? { get set }
Remarks
If you would like to learn more about the deblur modes and how they work, please read the parameter reference of DeblurModes for more information.
minResultConfidence
Set the minimum barcode result confidence to filter out results that do not meet the required level of confidence/accuracy. The higher the value of this parameter, the more accurate the results will be. If the library is struggling to find a barcode, lowering the value of this parameter can help.
- Objective-C
- Swift
@property(nonatomic, assign) NSInteger minResultConfidence;
var minResultConfidence: Int { get set }
Remarks
The default minresultConfidence
value is 30. A typically accurate result that is returned by the library will be no less than 30, so that is why 30 is the default value for minResultConfidence
.
minBarcodeTextLength
Sets the minimum text length of the barcode results that the library will share. Any results that do not meet this text length will be discarded by the library.
- Objective-C
- Swift
@property(nonatomic, assign) NSInteger minBarcodeTextLength;
var minBarcodeTextLength: Int { get set }
barcodeTextRegExPattern
Sets a RegEx pattern for the barcode text. Any barcode results that don’t follow this RegEx pattern will be discarded by the library.
- Objective-C
- Swift
@property(nonatomic, nullable, copy) NSString *barcodeTextRegExPattern;
var barcodeTextRegExPattern: String? { get set }
maxThreadsInOneTask
Set the maximum available threads for a single task.
- Objective-C
- Swift
@property(nonatomic, assign) NSInteger maxThreadsInOneTask;
var maxThreadsInOneTask: Int { get set }
grayscaleTransformationModes
Sets which grayscale transformation mode(s) the library will employ when reading barcodes. This parameter controls the library’s ability to read inverted barcodes. The array consists of GrayscaleTransformationMode items.
- Objective-C
- Swift
@property(nonatomic, nullable, copy) NSArray *grayscaleTransformationModes;
var grayscaleTransformationModes: [DSGrayscaleTransformationMode]? { get set }
Remarks
To learn more about reading inverted barcodes, please view this article on how to read inverted barcodes.
grayscaleEnhancementModes
Sets which grayscale enhancement mode(s) the library will use when reading barcodes. The array consists of GrayscaleEnhancementModes.
- Objective-C
- Swift
@property(nonatomic, nullable, copy) NSArray *grayscaleEnhancementModes;
var grayscaleEnhancementModes: [DSGrayscaleEnhancementModes]? { get set }
Remarks
This parameter can be quite powerful if used properly. To learn more about this parameter and how it can be used, please see this page on how to preprocess images.
scaleDownThreshold
Set the threshold for image shrinking when dealing with large images to help with the memory overhead. If both the width and height are larger then the threshold, the image is shrinked by half.
- Objective-C
- Swift
@property(nonatomic, assign) NSInteger scaleDownThreshold;
var scaleDownThreshold: Int { get set }
Remarks
If you would like to learn more on how this parameter works, please see this page on how to read barcodes from large images.