Updating new articles, fixing code snippets

Author: Dynamsoft-Henry

programming/android/user-guide/capabilities/add-graphics.md

@@ -107,17 +107,6 @@ Set the style of the highlight overlays with a user defined style:
 
 2. Create your style with the colour and set to the layer.
 
-    ```java
-    // Get the layer first.
-    DrawingLayer layer = cameraView.getDrawingLayer(DrawingLayer.DBR_LAYER_ID);
-    // Create a new DrawingStyle via the DrawingStyleManager.
-    int teal_200_transparent = ResourcesCompat.getColor(MainActivity.this.getResources(), R.color.teal_200_transparent, null);
-    int teal_200 = ResourcesCompat.getColor(MainActivity.this.getResources(), R.color.teal_200, null);
-    int style = DrawingStyleManager.createDrawingStyle(teal_200, 1.0f,teal_200_transparent,teal_200);
-    // Set the newly created DrawingStyle to the layer.
-    layer.setDefaultStyle(style);
-    ```
-
     <div class="sample-code-prefix"></div>
     >- Java
     >- Kotlin

programming/android/user-guide/capabilities/scan-region-style.md

@@ -46,17 +46,30 @@ The scan region mask style includes the stroke color, stroke width, and mask col
     <p>Barcode Scanner UI Components</p>
 </div>
 
+1. Add your colors to `res/values/colors.xml`.
+
+```xml
+<color name="teal_200">#FF03DAC5</color>
+<color name="teal_200_transparent">#2003DAC5</color>
+```
+
+2. Set colors to the scan region mask style.
+
 <div class="sample-code-prefix"></div>
 >- Java
 >- Kotlin
 >
 >1. 
 ```java
-cameraView.setScanRegionMaskStyle(R.color.white, R.color.dy_gray, 2);
+int teal_200_transparent = ResourcesCompat.getColor(MainActivity.this.getResources(), R.color.teal_200_transparent, null);
+int teal_200 = ResourcesCompat.getColor(MainActivity.this.getResources(), R.color.teal_200, null);
+cameraView.setScanRegionMaskStyle(teal_200, teal_200_transparent, 2.0f);
 ```
 2. 
 ```kotlin
-cameraView.setScanRegionMaskStyle(R.color.white, R.color.dy_gray, 2)
+val teal_200_transparent = ResourcesCompat.getColor(this@MainActivity.getResources(), R.color.teal_200_transparent, null)
+val teal_200 = ResourcesCompat.getColor(this@MainActivity.getResources(), R.color.teal_200, null)
+cameraView.setScanRegionMaskStyle(teal_200, teal_200_transparent, 2.0f)
 ```
 
 ## Laser

programming/objectivec-swift/user-guide.md

@@ -323,15 +323,15 @@ region.right = 0.85;
 region.bottom = 0.7;
 config.scanRegion = region;
 // Add the following line to enable the beep sound when a barcode is scanned.
-config.isBeepEnabled = true;
+config.isBeepEnabled = YES;
 // Add the following line if you don't want to display the torch button.
 config.isTorchButtonVisible = false;
 // Add the following line if you don't want to display the close button.
 config.isCloseButtonVisible = false;
 // Add the following line if you want to hide the scan laser.
 config.isScanLaserVisible = false;
 // Add the following line if you want the camera to auto-zoom when the barcode is far away.
-config.isAutoZoomEnabled = true;
+config.isAutoZoomEnabled = YES;
 ```
 2. 
 ```swift

programming/objectivec-swift/user-guide/capabilities/add-functional-buttons.md

@@ -35,9 +35,10 @@ BarcodeScanner provides a set of UI elements that you can easily customize.
 >
 >1. 
 ```objc
-DSCameraView *cameraView = self.cameraView;
-[cameraView setTorchButtonVisible:YES];
-cameraView.cameraToggleButtonVisible = YES;
+@property (nonatomic, strong) DSCameraView *cameraView;
+self.cameraView = [[DSCameraView alloc] initWithFrame:self.view.bounds];
+[self.cameraView setTorchButtonVisible:YES];
+self.cameraView.cameraToggleButtonVisible = YES;
 ```
 2. 
 ```swift

programming/objectivec-swift/user-guide/capabilities/add-graphics.md

@@ -19,7 +19,7 @@ noTitleIndex: true
 - `DrawingLayer`: The layer for displaying the `DrawingItems`.
 - `DrawingStyle`: The style for the `DrawingItem`.
 
-## How to Hide Default Barcode Highlight Overlay
+## Hide Barcode Highlight Overlay
 
 Barcode highlight overlay is displayed by default. You can set the layer invisible to disable it:
 
@@ -32,20 +32,47 @@ Barcode highlight overlay is displayed by default. You can set the layer invisib
 // Get the layer first.
 DSDrawingLayer *layer = [self.cameraView getDrawingLayer:DSDrawingLayerIdDBR];
 // Set the visible property to true or false to control the visibility.
-layer.visible = true;
+layer.visible = NO;
 ```
 2. 
 ```swift
 // Get the layer first.
 let layer = cameraView.getDrawingLayer(DrawingLayerId.dbr)
 // Set the visible property to true or false to control the visibility.
-layer?.visible = true
+layer?.visible = false
 ```
 
-## How to Add User Defined DrawingItem(s)
+## Add User-Define DrawingItem(s)
+
+<div class="sample-code-prefix"></div>
+>- Objective-C
+>- Swift
+>
+>1. 
+```objc
+DSDrawingLayer *barcodeLayer = [self.cameraView getDrawingLayer:DSDrawingLayerIdDBR];
+NSMutableArray<DSDrawingItem *> *drawingItemArrayList = [NSMutableArray array];
+DSQuadDrawingItem *quadDrawingItem = [[DSQuadDrawingItem alloc] initWithQuad:nil];
+[drawingItemArrayList addObject:quadDrawingItem];
+[barcodeLayer setDrawingItems:drawingItemArrayList];
+// You can also use the append logic if you don't want to clear the previous items.
+// [barcodeLayer addDrawingItems:drawingItemArrayList];
+```
+2. 
+```swift
+let barcodeLayer = cameraView.getDrawingLayer(DrawingLayerId.dbr)
+var drawingItemArrayList: [DrawingItem] = []
+let quadDrawingItem = QuadDrawingItem(quad: nil)
+drawingItemArrayList.append(quadDrawingItem)
+barcodeLayer?.setDrawingItems(drawingItemArrayList)
+// You can also use the append logic if you don't want to clear the previous items.
+// barcodeLayer?.addDrawingItems(drawingItemArrayList)
+```
 
 ## How to Change the DrawingStyle
 
+### Use Preset Styles
+
 Set the style of the highlight overlays with a preset style:
 
 <div class="sample-code-prefix"></div>
@@ -67,7 +94,9 @@ let layer = cameraView.getDrawingLayer(DrawingLayerId.dbr)
 layer?.setDefaultStyle(DrawingStyleId.blueStroke)
 ```
 
-Set the style of the highlight overlays with a use defined style:
+### Use User Defined Styles
+
+Set the style of the highlight overlays with a user defined style:
 
 1. Create colours in the **values/colours.xml** file.
 

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

@@ -36,6 +36,8 @@ Example:
 >
 >1. 
 ```objc
+@property (nonatomic, strong) DSCaptureVisionRouter *cvr;
+self.cvr = [[DSCaptureVisionRouter alloc] init];
 NSError *error = nil;
 DSSimplifiedCaptureVisionSettings *settings = [self.cvr getSimplifiedSettings:DSPresetTemplateReadBarcodes error:&error];
 DSSimplifiedBarcodeReaderSettings *barcodeSettings = settings.barcodeSettings;
@@ -44,11 +46,15 @@ barcodeSettings.barcodeFormatIds = DSBarcodeFormatQRCode | DSBarcodeFormatDataMa
 ```
 2. 
 ```swift
+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)
 do {
-   let settings = try cvr.getSimplifiedSettings(PresetTemplate.readBarcodes.rawValue)
-   settings.barcodeSettings?.barcodeFormatIds = BarcodeFormat.qrCode.rawValue | BarcodeFormat.dataMatrix.rawValue
-   try cvr.updateSettings(PresetTemplate.readBarcodes.rawValue, settings: settings)
+   try cvr.updateSettings(PresetTemplate.readBarcodes.rawValue, settings:settings)
 } catch {
+   print("update runtimeSettings error:\(error.localizedDescription)")
 }
 ```
 
@@ -72,7 +78,7 @@ config.barcodeFormats = DSBarcodeFormatQRCode | DSBarcodeFormatDataMatrix;
 ```swift
 let config = BarcodeScannerConfig()
 // QR Code + DataMatrix
-config.barcodeFormats = BarcodeFormat.qrCode.rawValue | BarcodeFormat.dataMatrix.rawValue
+config.barcodeFormats = [.qrCode, .dataMatrix]
 ```
 
 > [!Note]

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

@@ -34,12 +34,14 @@ captureVisionSettings.barcodeSettings.expectedBarcodesCount = 1;
 ```
 2. 
 ```swift
+guard let captureVisionSettings = try? cvr.getSimplifiedSettings(PresetTemplate.readBarcodes.rawValue) else {
+   return
+}
+captureVisionSettings.minImageCaptureInterval = 200
+captureVisionSettings.timeout = 200
+captureVisionSettings.barcodeSettings?.barcodeFormatIds = BarcodeFormat.qrCode.rawValue | BarcodeFormat.dataMatrix.rawValue
+captureVisionSettings.barcodeSettings?.expectedBarcodesCount = 1
 do {
-   let captureVisionSettings = try cvr.getSimplifiedSettings(PresetTemplate.readBarcodes.rawValue)
-   captureVisionSettings.minImageCaptureInterval = 200
-   captureVisionSettings.timeout = 200
-   captureVisionSettings.barcodeSettings?.barcodeFormatIds = BarcodeFormat.qrCode.rawValue | BarcodeFormat.dataMatrix.rawValue
-   captureVisionSettings.barcodeSettings?.expectedBarcodesCount = 1
    try cvr.updateSettings(PresetTemplate.readBarcodes.rawValue, settings: captureVisionSettings)
 } catch {
    // Handle error

programming/objectivec-swift/user-guide/capabilities/init-customized-template.md

@@ -33,7 +33,11 @@ NSError *error = nil;
 ```
 2. 
 ```swift
-try cvr.initSettingsFromFile("ReadQRCodes.json")
+do {
+   try cvr.initSettingsFromFile("ReadQRCodes.json")
+} catch {
+   print("initSettingsFromFile error:\(error.localizedDescription)")
+}
 ```
 
 ## Initialize with BarcodeScanner APIs

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

@@ -64,7 +64,7 @@ let capturedResult = try cvr.captureFromFile("Your-file-path", templateName: Pre
 
 For details, see [Parameters and Settings - Use a Customized Template](parameters-and-settings.md#use-a-customized-template).
 
-## Code Snippet
+## How to Extract Barcode Info
 
 <div class="sample-code-prefix"></div>
 >- Objective-C

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

@@ -8,7 +8,7 @@ needGenerateH3Content: true
 needAutoGenerateSidebar: true
 ---
 
-# Read from camera
+# Read from Camera
 
 > [!Important]
 > This page is for **Foundational APIs** only. Refer to [Quick Start](../../user-guide.md) for how to scan from camera with `BarcodeScanner` component.
@@ -31,9 +31,11 @@ Follow these three steps to read barcodes from the camera:
    >
    >1. 
    ```objc
-   DSCameraEnhancer *cameraEnhancer = [[DSCameraEnhancer alloc] init];
-   DSCameraView *cameraView = [[DSCameraView alloc] initWithFrame:self.view.bounds];
-   cameraEnhancer.cameraView = cameraView;
+   @property (nonatomic, strong) DSCameraEnhancer *dce;
+   @property (nonatomic, strong) DSCameraView *cameraView;
+   self.dce = [[DSCameraEnhancer alloc] init];
+   self.cameraView = [[DSCameraView alloc] initWithFrame:self.view.bounds];
+   self.dce.cameraView = self.cameraView;
    ```
    2. 
    ```swift
@@ -50,9 +52,10 @@ Follow these three steps to read barcodes from the camera:
    >
    >1. 
    ```objc
-   DSCaptureVisionRouter *cvr = [[DSCaptureVisionRouter alloc] init];
+   @property (nonatomic, strong) DSCaptureVisionRouter *cvr;
+   self.cvr = [[DSCaptureVisionRouter alloc] init];
    NSError *error = nil;
-   [cvr setInput:cameraEnhancer error:&error];
+   [self.cvr setInput:self.dce error:&error];
    ```
    2. 
    ```swift
@@ -71,7 +74,7 @@ To use another camera source, complete the following steps so the library can pr
 2. Convert the raw camera input to a `com.dynamsoft.core.basic_structures.ImageData` object.
 3. Use `addImageToBuffer` to add the `ImageData` object to the buffer. 
 
-## Result receiver
+## Result Receiver
 
 Use `CapturedResultReceiver` to receive capture results. The callback is triggered each time an image is processed, regardless of whether a barcode is decoded.
 
@@ -81,20 +84,25 @@ Use `CapturedResultReceiver` to receive capture results. The callback is trigger
 >
 >1. 
 ```objc
-[cvr addResultReceiver:self];
-// Implement DSCapturedResultReceiver callback:
+@interface ViewController () <DSCapturedResultReceiver>
+- (void)setUpDCV {
+   [self.cvr addResultReceiver:self];
+}
 - (void)onDecodedBarcodesReceived:(DSDecodedBarcodesResult *)result {
 }
 ```
 2. 
 ```swift
-cvr.addResultReceiver(self)
-// Implement CapturedResultReceiver callback:
-func onDecodedBarcodesReceived(_ result: DecodedBarcodesResult) {
+class ViewController: UIViewController, CapturedResultReceiver {
+   func setUpDCV() {
+          cvr.addResultReceiver(self)
+   }
+   func onDecodedBarcodesReceived(_ result: DecodedBarcodesResult) {
+   }
 }
 ```
 
-## Start capturing
+## Start Capturing
 
 Use `startCapturing` and `stopCapturing` to control when barcode decoding starts and stops.
 
@@ -104,9 +112,15 @@ Use `startCapturing` and `stopCapturing` to control when barcode decoding starts
 >
 >1. 
 ```objc
-[cvr startCapturing:DSPresetTemplateReadBarcodes completionHandler:nil];
+[self.cvr startCapturing:DSPresetTemplateReadBarcodes completionHandler:nil];
 ```
 2. 
 ```swift
-try? cvr.startCapturing(PresetTemplate.readBarcodes.rawValue)
+cvr.startCapturing(PresetTemplate.readBarcodes.rawValue) { isSuccess, error in
+   if (!isSuccess) {
+          if let error = error {
+             self.showResult("Error", error.localizedDescription)
+          }
+   }
+}
 ```