DSSimplifiedBarcodeReaderSettings

The DSSimplifiedBarcodeReaderSettings class comes from the DSSimplifiedCaptureVisionSettings class and contains settings specific to barcode decoding.

Definition

Assembly: DynamsoftBarcodeReader.xcframework

• Objective-C
• Swift

1. NS_SWIFT_NAME(SimplifiedBarcodeReaderSettings)
   @interface DSSimplifiedBarcodeReaderSettings : NSObject
   

2. class SimplifiedBarcodeReaderSettings : NSObject
   

Attributes

barcodeFormatIds

Defines a combined value of enumeration BarcodeFormat to specify which barcode format(s) the library should target.

• Objective-C
• Swift

1. @property(nonatomic, assign) DSBarcodeFormat barcodeFormatIds;
   

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

1. @property(nonatomic, assign) NSInteger expectedBarcodesCount;
   

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

1. @property(nonatomic, nullable, copy) NSArray *localizationModes;
   

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

1. @property(nonatomic, nullable, copy) NSArray *deblurModes;
   

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

1. @property(nonatomic, assign) NSInteger minResultConfidence;
   

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

1. @property(nonatomic, assign) NSInteger minBarcodeTextLength;
   

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

1. @property(nonatomic, nullable, copy) NSString *barcodeTextRegExPattern;
   

2. var barcodeTextRegExPattern: String? { get set }
   

maxThreadsInOneTask

Set the maximum available threads for a single task.

• Objective-C
• Swift

1. @property(nonatomic, assign) NSInteger maxThreadsInOneTask;
   

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

1. @property(nonatomic, nullable, copy) NSArray *grayscaleTransformationModes;
   

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

1. @property(nonatomic, nullable, copy) NSArray *grayscaleEnhancementModes;
   

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

1. @property(nonatomic, assign) NSInteger scaleDownThreshold;
   

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