Updating objc & swift code snippets

Author: Dynamsoft-Henry

programming/objectivec-swift/user-guide/capabilities/barcode-formats.md

@@ -49,8 +49,7 @@ barcodeSettings.barcodeFormatIds = DSBarcodeFormatQRCode | DSBarcodeFormatDataMa
 guard let settings = try? cvr.getSimplifiedSettings(PresetTemplate.readBarcodes.rawValue) else {
    return
 }
-settings.barcodeSettings?.barcodeFormatIds = BarcodeFormat.qrCode.rawValue | BarcodeFormat.dataMatrix.rawValue
-try cvr.updateSettings(PresetTemplate.readBarcodes.rawValue, settings: settings)
+settings.barcodeSettings?.barcodeFormatIds = [.dataMatrix, .qrCode]
 do {
    try cvr.updateSettings(PresetTemplate.readBarcodes.rawValue, settings:settings)
 } catch {

programming/objectivec-swift/user-guide/capabilities/config-simplified-settings.md

@@ -39,7 +39,7 @@ guard let captureVisionSettings = try? cvr.getSimplifiedSettings(PresetTemplate.
 }
 captureVisionSettings.minImageCaptureInterval = 200
 captureVisionSettings.timeout = 200
-captureVisionSettings.barcodeSettings?.barcodeFormatIds = BarcodeFormat.qrCode.rawValue | BarcodeFormat.dataMatrix.rawValue
+captureVisionSettings.barcodeSettings?.barcodeFormatIds = [.qrCode, .dataMatrix]
 captureVisionSettings.barcodeSettings?.expectedBarcodesCount = 1
 do {
    try cvr.updateSettings(PresetTemplate.readBarcodes.rawValue, settings: captureVisionSettings)

programming/objectivec-swift/user-guide/capabilities/multi-frame-cross-filter.md

@@ -34,7 +34,7 @@ Cross verification is one of the most commonly used techniques for improving sca
 >1. 
 ```objc
 DSMultiFrameResultCrossFilter *filter = [[DSMultiFrameResultCrossFilter alloc] init];
-[filter enableResultCrossVerification:DSCapturedResultItemTypeBarcode isEnabled:true];
+[filter enableResultCrossVerification:DSCapturedResultItemTypeBarcode isEnabled:YES];
 [self.cvr addResultFilter:filter];
 ```
 2. 
@@ -81,7 +81,7 @@ filter.setResultCrossVerificationCriteria(.barcode, criteria: criteria)
 >1. 
 ```objc
 DSMultiFrameResultCrossFilter *filter = [[DSMultiFrameResultCrossFilter alloc] init];
-[filter enableLatestOverlapping:DSCapturedResultItemTypeBarcode isEnabled:true];
+[filter enableLatestOverlapping:DSCapturedResultItemTypeBarcode isEnabled:YES];
 [self.cvr addResultFilter:filter];
 ```
 2. 
@@ -119,7 +119,7 @@ filter.setMaxOverlappingFrames(.barcode, frames: 10)
 >1. 
 ```objc
 DSMultiFrameResultCrossFilter *filter = [[DSMultiFrameResultCrossFilter alloc] init];
-[filter enableResultDeduplication:DSCapturedResultItemTypeBarcode isEnabled:true];
+[filter enableResultDeduplication:DSCapturedResultItemTypeBarcode isEnabled:YES];
 [self.cvr addResultFilter:filter];
 ```
 2. 

programming/objectivec-swift/user-guide/capabilities/read-from-an-image.md

@@ -53,7 +53,7 @@ When using a `capture` method, `templateName` is required. You can specify eithe
 ```objc
 @property (nonatomic, strong) DSCaptureVisionRouter *cvr;
 self.cvr = [[DSCaptureVisionRouter alloc] init];
-DSCapturedResult *capturedResult = [self.cvr captureFromFile:@"" templateName:DSPresetTemplateReadBarcodes];
+DSCapturedResult *capturedResult = [self.cvr captureFromFile:@"Your-file-path" templateName:DSPresetTemplateReadBarcodes];
 ```
 2. 
 ```swift
@@ -73,7 +73,7 @@ For details, see [Parameters and Settings - Use a Customized Template](parameter
 >1. 
 ```objc
 NSError *error = nil;
-DSCapturedResult *capturedResult = [self.cvr captureFromFile:@"Your file path" templateName:DSPresetTemplateReadBarcodes error:&error];
+DSCapturedResult *capturedResult = [self.cvr captureFromFile:@"Your file path" templateName:DSPresetTemplateReadBarcodes];
 DSDecodedBarcodesResult *decodedBarcodesResult = capturedResult.decodedBarcodesResult;
 for (DSBarcodeResultItem *barcodeResultItem in decodedBarcodesResult.items) {
    NSString *barcodeText = barcodeResultItem.text;
@@ -82,15 +82,17 @@ for (DSBarcodeResultItem *barcodeResultItem in decodedBarcodesResult.items) {
 ```
 2. 
 ```swift
-do {
-   let capturedResult = try cvr.captureFromFile("Your file path", templateName: PresetTemplate.readBarcodes.rawValue)
-   if let decodedBarcodesResult = capturedResult.decodedBarcodesResult {
-          for barcodeResultItem in decodedBarcodesResult.items {
-             let barcodeText = barcodeResultItem.text
-             let barcodeFormatString = barcodeResultItem.formatString
-          }
+let capturedResult = try cvr.captureFromFile("Your file path", templateName: PresetTemplate.readBarcodes.rawValue)
+if let decodedBarcodesResult = capturedResult.decodedBarcodesResult {
+   guard let barcodeResultItems = decodedBarcodesResult.items, barcodeResultItems.count>0 else
+   {
+          // result count = 0
+          return
+   }
+   for barcodeResultItem in barcodeResultItems
+   {
+          // deal with the results
    }
-} catch {
 }
 ```
 

programming/objectivec-swift/user-guide/capabilities/read-specific-area.md

@@ -99,15 +99,15 @@ captureVisionSettings.roiMeasuredInPercentage = YES;
 ```
 2. 
 ```swift
+let captureVisionSettings = try cvr.getSimplifiedSettings(PresetTemplate.readBarcodes.rawValue)
+let point0 = CGPoint(x: 15, y: 30) as NSValue
+let point1 = CGPoint(x: 85, y: 30) as NSValue
+let point2 = CGPoint(x: 85, y: 55) as NSValue
+let point3 = CGPoint(x: 15, y: 55) as NSValue
+let roiQuad = Quadrilateral.init(pointArray: [point0,point1,point2,point3])
+captureVisionSettings.roi = roiQuad
+captureVisionSettings.roiMeasuredInPercentage = true
 do {
-   let captureVisionSettings = try cvr.getSimplifiedSettings(PresetTemplate.readBarcodes.rawValue)
-   let roiQuad = Quadrilateral()
-   roiQuad.points[0] = Point(15, 30)
-   roiQuad.points[1] = Point(85, 30)
-   roiQuad.points[2] = Point(85, 70)
-   roiQuad.points[3] = Point(15, 70)
-   captureVisionSettings.roi = roiQuad
-   captureVisionSettings.roiMeasuredInPercentage = true
    try cvr.updateSettings(PresetTemplate.readBarcodes.rawValue, settings: captureVisionSettings)
 } catch {
 }

programming/objectivec-swift/user-guide/capabilities/scan-region-style.md

@@ -20,22 +20,12 @@ After you call `setScanRegion`, the scan region is visible by default. You can h
 >
 >1. 
 ```objc
-DSRect *region = [[DSRect alloc] init];
-region.left = 0.15;
-region.top = 0.25;
-region.right = 0.85;
-region.bottom = 0.65;
-[self.dce setScanRegion:region error:nil];
-[self.cameraView setScanRegionMaskVisible:false];
+[self.dce setScanRegion:[[DSRect alloc] initWithLeft:0.1 top:0.35 right:0.9 bottom:0.55 measuredInPercentage:YES]  error:nil];
+[self.cameraView setScanRegionMaskVisible:NO];
 ```
 2. 
 ```swift
-let region = Rect()
-region.left = 0.15
-region.top = 0.25
-region.right = 0.85
-region.bottom = 0.65
-try? dce.setScanRegion(region)
+try! dce.setScanRegion(Rect(left: 0.1, top: 0.35, right: 0.9, bottom: 0.55, measuredInPercentage: true))
 cameraView.setScanRegionMaskVisible(false)
 ```
 
@@ -54,11 +44,11 @@ The scan region mask style includes the stroke color, stroke width, and mask col
 >
 >1. 
 ```objc
-[self.cameraView setScanRegionMaskStyle:UIColor.whiteColor fillColor:[[UIColor darkGrayColor] colorWithAlphaComponent:0.35] strokeWidth:2];
+[self.cameraView setScanRegionMaskStyle:UIColor.whiteColor strokeWidth:2 surroundingColour:[[UIColor darkGrayColor] colorWithAlphaComponent:0.65]];
 ```
 2. 
 ```swift
-cameraView.setScanRegionMaskStyle(.white, fillColor: UIColor.darkGray.withAlphaComponent(0.35), strokeWidth: 2)
+cameraView.setScanRegionMaskStyle(.white, strokeWidth: 2, surroundingColour: UIColor.darkGray.withAlphaComponent(0.65))
 ```
 
 ## Laser
@@ -71,7 +61,7 @@ The scan laser is a light bar that moves up and down to indicate active scanning
 >
 >1. 
 ```objc
-[self.cameraView setScanLaserVisible:true];
+[self.cameraView setScanLaserVisible:YES];
 ```
 2. 
 ```swift

programming/objectivec-swift/user-guide/capabilities/single-multiple.md

@@ -61,7 +61,7 @@ Use max overlapping feature of multi-frame cross filter to improve the stability
 DSMultiFrameResultCrossFilter *filter = [[DSMultiFrameResultCrossFilter alloc] init];
 // Default value of MaxOverlapingFrames is 5. Increase the number if you want to further improve the stability.
 [filter setMaxOverlappingFrames:DSCapturedResultItemTypeBarcode frames:10];
-[filter enableLatestOverlapping:DSCapturedResultItemTypeBarcode isEnabled:true];
+[filter enableLatestOverlapping:DSCapturedResultItemTypeBarcode isEnabled:YES];
 [self.cvr addResultFilter:filter];
 ```
 2.