dynamsoft-capture-vision-react-native 2.4.2000-alpha.2 → 2.6.1002

package/src/dbr/EnumBarcodeFormat.tsx

@@ -1,98 +1,109 @@
+/**
+ * EnumBarcodeFormat defines the supported barcode formats.
+ * Using or operator can enable multiple Formats.
+ *  <p>
+ * Code snippet:
+ * ```
+ * let settings: SimplifiedCaptureVisionSettings = ...;
+ * settings.barcodeSettings.barcodeFormatIds = EnumBarcodeFormat.BF_ONED | EnumBarcodeFormat.BF_QR_CODE; //Means decode OneD and QRCode
+ * ```
+ * @see SimplifiedBarcodeReaderSettings.barcodeFormatIds
+ * */
 const EnumBarcodeFormat = {
     /**No barcode format in BarcodeFormat*/
-    BF_NULL:BigInt(0x00n),
+    BF_NULL:BigInt(0x00),
     /**All supported formats in BarcodeFormat*/
-    BF_ALL:BigInt(0xFFFFFFFEFFFFFFFFn),
-    BF_DEFAULT:BigInt(0xFE3BFFFFn),
+    BF_ALL:BigInt(0xFFFFFFFEFFFFFFFF),
+    BF_DEFAULT:BigInt(0xFE3BFFFF),
     /**Combined value of BF_CODABAR, BF_CODE_128, BF_CODE_39, BF_CODE_39_Extended, BF_CODE_93, BF_EAN_13, BF_EAN_8, INDUSTRIAL_25, BF_ITF, BF_UPC_A, BF_UPC_E, BF_MSI_CODE;  */
-    BF_ONED:BigInt(0x003007FFn),
+    BF_ONED:BigInt(0x003007FF),
     /**Combined value of BF_GS1_DATABAR_OMNIDIRECTIONAL, BF_GS1_DATABAR_TRUNCATED, BF_GS1_DATABAR_STACKED, BF_GS1_DATABAR_STACKED_OMNIDIRECTIONAL, BF_GS1_DATABAR_EXPANDED, BF_GS1_DATABAR_EXPANDED_STACKED, BF_GS1_DATABAR_LIMITED*/
-    BF_GS1_DATABAR:BigInt(0x0003F800n),
+    BF_GS1_DATABAR:BigInt(0x0003F800),
     /**Code 39 */
-    BF_CODE_39:BigInt(0x1n),
+    BF_CODE_39:BigInt(0x1),
     /**Code 128 */
-    BF_CODE_128:BigInt(0x2n),
+    BF_CODE_128:BigInt(0x2),
     /**Code 93 */
-    BF_CODE_93:BigInt(0x4n),
+    BF_CODE_93:BigInt(0x4),
     /**Codabar */
-    BF_CODABAR:BigInt(0x8n),
+    BF_CODABAR:BigInt(0x8),
     /**Interleaved 2 of 5 */
-    BF_ITF:BigInt(0x10n),
+    BF_ITF:BigInt(0x10),
     /**EAN-13 */
-    BF_EAN_13:BigInt(0x20n),
+    BF_EAN_13:BigInt(0x20),
     /**EAN-8 */
-    BF_EAN_8:BigInt(0x40n),
+    BF_EAN_8:BigInt(0x40),
     /**UPC-A */
-    BF_UPC_A:BigInt(0x80n),
+    BF_UPC_A:BigInt(0x80),
     /**UPC-E */
-    BF_UPC_E:BigInt(0x100n),
+    BF_UPC_E:BigInt(0x100),
     /**Industrial 2 of 5 */
-    BF_INDUSTRIAL_25:BigInt(0x200n),
+    BF_INDUSTRIAL_25:BigInt(0x200),
     /**CODE39 Extended */
-    BF_CODE_39_EXTENDED:BigInt(0x400n),
+    BF_CODE_39_EXTENDED:BigInt(0x400),
     /**GS1 Databar Omnidirectional*/
-    BF_GS1_DATABAR_OMNIDIRECTIONAL:BigInt(0x800n),
+    BF_GS1_DATABAR_OMNIDIRECTIONAL:BigInt(0x800),
     /**GS1 Databar Truncated*/
-    BF_GS1_DATABAR_TRUNCATED:BigInt(0x1000n),
+    BF_GS1_DATABAR_TRUNCATED:BigInt(0x1000),
     /**GS1 Databar Stacked*/
-    BF_GS1_DATABAR_STACKED:BigInt(0x2000n),
+    BF_GS1_DATABAR_STACKED:BigInt(0x2000),
     /**GS1 Databar Stacked Omnidirectional*/
-    BF_GS1_DATABAR_STACKED_OMNIDIRECTIONAL:BigInt(0x4000n),
+    BF_GS1_DATABAR_STACKED_OMNIDIRECTIONAL:BigInt(0x4000),
     /**GS1 Databar Expanded*/
-    BF_GS1_DATABAR_EXPANDED:BigInt(0x8000n),
+    BF_GS1_DATABAR_EXPANDED:BigInt(0x8000),
     /**GS1 Databar Expaned Stacked*/
-    BF_GS1_DATABAR_EXPANDED_STACKED:BigInt(0x10000n),
+    BF_GS1_DATABAR_EXPANDED_STACKED:BigInt(0x10000),
     /**GS1 Databar Limited*/
-    BF_GS1_DATABAR_LIMITED:BigInt(0x20000n),
+    BF_GS1_DATABAR_LIMITED:BigInt(0x20000),
     /**Patch code. */
-    BF_PATCHCODE:BigInt(0x00040000n),
+    BF_PATCHCODE:BigInt(0x00040000),
     /**PDF417 */
-    BF_CODE_32:BigInt(0x01000000n),
-    BF_PDF417:BigInt(0x02000000n),
+    BF_CODE_32:BigInt(0x01000000),
+    BF_PDF417:BigInt(0x02000000),
     /**QRCode */
-    BF_QR_CODE:BigInt(0x04000000n),
+    BF_QR_CODE:BigInt(0x04000000),
     /**DataMatrix */
-    BF_DATAMATRIX:BigInt(0x08000000n),
+    BF_DATAMATRIX:BigInt(0x08000000),
     /**AZTEC */
-    BF_AZTEC:BigInt(0x10000000n),
+    BF_AZTEC:BigInt(0x10000000),
     /**MAXICODE */
-    BF_MAXICODE:BigInt(0x20000000n),
+    BF_MAXICODE:BigInt(0x20000000),
     /**Micro QR Code*/
-    BF_MICRO_QR:BigInt(0x40000000n),
+    BF_MICRO_QR:BigInt(0x40000000),
     /**Micro PDF417*/
-    BF_MICRO_PDF417:BigInt(0x00080000n),
+    BF_MICRO_PDF417:BigInt(0x00080000),
     /**GS1 Composite Code*/
-    BF_GS1_COMPOSITE:BigInt(0x80000000n),
+    BF_GS1_COMPOSITE:BigInt(0x80000000),
     /**MSI Code*/
-    BF_MSI_CODE:BigInt(0x100000n),
+    BF_MSI_CODE:BigInt(0x100000),
     /*Code 11*/
-    BF_CODE_11:BigInt(0x200000n),
-    BF_TWO_DIGIT_ADD_ON:BigInt(0x400000n),
-    BF_FIVE_DIGIT_ADD_ON:BigInt(0x800000n),
+    BF_CODE_11:BigInt(0x200000),
+    BF_TWO_DIGIT_ADD_ON:BigInt(0x400000),
+    BF_FIVE_DIGIT_ADD_ON:BigInt(0x800000),
     /**Combined value of BF2_USPSINTELLIGENTMAIL, BF2_POSTNET, BF2_PLANET, BF2_AUSTRALIANPOST, BF2_RM4SCC.*/
-    BF_MATRIX_25:BigInt(0x1000000000n),
-    BF_POSTALCODE:BigInt(0x3F0000000000000n),
+    BF_MATRIX_25:BigInt(0x1000000000),
+    BF_POSTALCODE:BigInt(0x3F0000000000000),
     /**Nonstandard barcode */
-    BF_NONSTANDARD_BARCODE:BigInt(0x100000000n),
+    BF_NONSTANDARD_BARCODE:BigInt(0x100000000),
     /**USPS Intelligent Mail.*/
-    BF_USPSINTELLIGENTMAIL:BigInt(0x10000000000000n),
+    BF_USPSINTELLIGENTMAIL:BigInt(0x10000000000000),
     /**Postnet.*/
-    BF_POSTNET:BigInt(0x20000000000000n),
+    BF_POSTNET:BigInt(0x20000000000000),
     /**Planet.*/
-    BF_PLANET:BigInt(0x40000000000000n),
+    BF_PLANET:BigInt(0x40000000000000),
     /**Australian Post.*/
-    BF_AUSTRALIANPOST:BigInt(0x80000000000000n),
+    BF_AUSTRALIANPOST:BigInt(0x80000000000000),
     /**Royal Mail 4-State Customer Barcode.*/
-    BF_RM4SCC:BigInt(0x100000000000000n),
-    BF_KIX:BigInt(0x200000000000000n),
+    BF_RM4SCC:BigInt(0x100000000000000),
+    BF_KIX:BigInt(0x200000000000000),
     /**DotCode.*/
-    BF_DOTCODE:BigInt(0x200000000n),
+    BF_DOTCODE:BigInt(0x200000000),
     /**_PHARMACODE_ONE_TRACK.*/
-    BF_PHARMACODE_ONE_TRACK:BigInt(0x400000000n),
+    BF_PHARMACODE_ONE_TRACK:BigInt(0x400000000),
     /**PHARMACODE_TWO_TRACK.*/
-    BF_PHARMACODE_TWO_TRACK:BigInt(0x800000000n),
+    BF_PHARMACODE_TWO_TRACK:BigInt(0x800000000),
     /**PHARMACODE.*/
-    BF_PHARMACODE:BigInt(0xC00000000n)
+    BF_PHARMACODE:BigInt(0xC00000000)
 }
 type EnumBarcodeFormat = bigint;
 export { EnumBarcodeFormat };

package/src/dbr/EnumDeblurMode.tsx

@@ -1,12 +1,28 @@
-export enum EnumDeblurMode  {
-    DM_SKIP= 0x0,
-    DM_DIRECT_BINARIZATION= 0x1,
-    DM_THRESHOLD_BINARIZATION= 0x2,
-    DM_GRAY_EQUALIZATION= 0x4,
-    DM_SMOOTHING= 0x8,
-    DM_MORPHING= 0x10,
-    DM_DEEP_ANALYSIS= 0x20,
-    DM_SHARPENING= 0x40,
-    DM_BASED_ON_LOC_BIN= 0x80,
-    DM_SHARPENING_SMOOTHING= 0x100,
-}
+/**
+ * DeblurMode specifies the image processing algorithms applied to the localized zones containing barcodes,
+ * aimed at generating a binary image for extracting barcode data during the final phase of the barcode decoding process.
+ *  <p>
+ * @see SimplifiedBarcodeReaderSettings.deblurModes
+ * */
+export enum EnumDeblurMode {
+  /** Skips the process, no deblurring is applied. */
+  DM_SKIP = 0x0,
+  /** Applies a direct binarization algorithm for generating the binary image. */
+  DM_DIRECT_BINARIZATION = 0x1,
+  /** Utilizes a threshold binarization algorithm for generating the binary image, dynamically determining the threshold based on the image content. */
+  DM_THRESHOLD_BINARIZATION = 0x2,
+  /** Employs a gray equalization algorithm to adjust the contrast and brightness, improving the clarity of the gray-scale image before binarization. */
+  DM_GRAY_EQUALIZATION = 0x4,
+  /** Implements a smoothing algorithm to reduce noise and artifacts, smoothing out the gray-scale image before binarization. */
+  DM_SMOOTHING = 0x8,
+  /** Uses a morphing algorithm to enhance the gray-scale image before binarization. */
+  DM_MORPHING = 0x10,
+  /** Engages in a deep analysis of the grayscale image based on the barcode format to intelligently generate the optimized binary image, tailored to complex or severely blurred images. */
+  DM_DEEP_ANALYSIS = 0x20,
+  /** Applies a sharpening algorithm to enhance the edges and details of the barcode, making it more distinguishable on the gray-scale image before binarization. */
+  DM_SHARPENING = 0x40,
+  /** Decodes the barcodes based on the binary image obtained during the localization process. */
+  DM_BASED_ON_LOC_BIN = 0x80,
+  /** Combines sharpening and smoothing algorithms for a comprehensive deblurring effect, targeting both clarity and smoothness of the gray-scale image before binarization. */
+  DM_SHARPENING_SMOOTHING = 0x100,
+}

package/src/dbr/EnumLocalizationMode.tsx

@@ -1,12 +1,26 @@
+/**
+ * LocalizationMode specifies the strategies used to identify the locations of barcodes within an image.
+ * @see SimplifiedBarcodeReaderSettings.localizationModes
+ * */
 export enum EnumLocalizationMode {
+    /** Omits the localization process entirely. */
     LM_SKIP = 0x0,
+    /** Automatic localization mode selection; not yet implemented. */
     LM_AUTO = 0x1,
+    /** Identifies barcodes by finding connected blocks, offering optimal results, especially recommended for highest priority in most scenarios. */
     LM_CONNECTED_BLOCKS = 0x2,
+    /** Detects barcodes through analysis of patterns of contiguous black and white regions, tailored for QR Codes and DataMatrix codes. */
     LM_STATISTICS = 0x4,
+    /** Locates barcodes by identifying linear patterns, designed primarily for 1D barcodes and PDF417 codes. */
     LM_LINES = 0x8,
+    /** Provides rapid barcode localization, suited for interactive applications where speed is crucial. */
     LM_SCAN_DIRECTLY = 0x10,
+    /** Targets barcode localization through detection of specific mark groups, optimized for Direct Part Marking (DPM) codes. */
     LM_STATISTICS_MARKS = 0x20,
+    /** Combines methods of locating connected blocks and linear patterns to efficiently localize postal codes. */
     LM_STATISTICS_POSTAL_CODE = 0x40,
+    /** Initiates barcode localization from the image center, facilitating faster detection in certain layouts. */
     LM_CENTRE = 0x80,
+    /** Specialized for quick localization of 1D barcodes, enhancing performance in fast-scan scenarios. */
     LM_ONED_FAST_SCAN = 0x100,
-}
+}

package/src/dbr/SimplifiedBarcodeReaderSettings.tsx

@@ -4,17 +4,77 @@ import type {EnumDeblurMode} from "./EnumDeblurMode";
 import type {EnumGrayscaleTransformationMode} from "../core/EnumGrayscaleTransformationMode";
 import type {EnumGrayscaleEnhancementMode} from "../core/EnumGrayscaleEnhancementMode";
 
+/**
+ * This interface defines simplified settings for barcode reading tasks.
+ * */
 export interface SimplifiedBarcodeReaderSettings {
-    barcodeFormatIds?: EnumBarcodeFormat | bigint;
-    _barcodeFormatIdsNumberString?: string;
-    expectedBarcodesCount?: number;
-    minResultConfidence?: number;
-    minBarcodeTextLength?: number;
-    barcodeTextRegExPattern?: string;
-    maxThreadsInOneTask?: number;
-    localizationModes?: Array<EnumLocalizationMode> | Int32Array;
-    deblurModes?: Array<EnumDeblurMode> | Int32Array;
-    grayscaleTransformationModes?: Array<EnumGrayscaleTransformationMode> | Int32Array;
-    grayscaleEnhancementModes?: Array<EnumGrayscaleEnhancementMode> | Int32Array;
-    scaleDownThreshold?: number;
+  /**
+   * A combined value of enumeration BarcodeFormat to specify the targeting barcode formats.
+   * @see EnumBarcodeFormat
+   * */
+  barcodeFormatIds?: EnumBarcodeFormat | bigint;
+
+  /**@internal*/
+  _barcodeFormatIdsNumberString?: string;
+
+  /**
+   * Set the expected barcode count. The default value is 0.
+   * @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.
+   * */
+  expectedBarcodesCount?: number;
+
+  /**
+   * Set the minimum result confidence to filter out the low confidence results. The default value is 30.
+   * */
+  minResultConfidence?: number;
+
+  /**
+   * Set the minimum barcode text length to filter out the unqualified results.
+   * */
+  minBarcodeTextLength?: number;
+
+  /**
+   * Set the RegEx pattern of the barcode text to filter out the unqualified results.
+   * */
+  barcodeTextRegExPattern?: string;
+  maxThreadsInOneTask?: number;
+
+  /**
+   * Set the location modes with an array of enumeration LocalizationMode.
+   * View the reference page of LocalizationModes for more detail about location modes.
+   * @see EnumLocalizationMode
+   * */
+  localizationModes?: Array<EnumLocalizationMode> | Int32Array;
+
+  /**
+   * Set the deblur modes with an array of enumeration DeblurMode.
+   * View the reference page of DeblurModes for more detail about deblur modes.
+   * @see EnumDeblurMode
+   * */
+  deblurModes?: Array<EnumDeblurMode> | Int32Array;
+
+  /**
+   * Set the grayscale transformation modes with an array of enumeration GrayscaleTransformationMode.
+   * View the reference page of GrayscaleTransformationModes for more detail about grayscale transformation modes.
+   * @see EnumGrayscaleTransformationMode
+   * */
+  grayscaleTransformationModes?: Array<EnumGrayscaleTransformationMode> | Int32Array;
+
+  /**
+   * Set the grayscale enhancement modes with an array of enumeration GrayscaleEnhancementMode.
+   * View the reference page of GrayscaleEnhancementModes for more detail about grayscale enhancement modes.
+   * @see EnumGrayscaleEnhancementMode
+   * */
+  grayscaleEnhancementModes?: Array<EnumGrayscaleEnhancementMode> | Int32Array;
+
+  /**
+   * Set the threshold for scaling down the input image during barcode localization.
+   * If the shorter edge size of the image is larger than this threshold, the original may be scaled down to reduce processing time.
+   * The default value is 2300.
+   * */
+  scaleDownThreshold?: number;
 }

package/src/dce/CameraEnhancer.tsx

@@ -9,96 +9,218 @@ import type {EnumEnhancedFeatures} from "./EnumEnhancedFeatures";
 const isTurboModuleEnabled = global.__turboModuleProxy != null;
 
 const DynamsoftCameraEnhancerModule = isTurboModuleEnabled ?
-    require("./NativeDynamsoftCameraViewModule").default :
-    NativeModules.DynamsoftCameraView;
+  require("./NativeDynamsoftCameraViewModule").default :
+  NativeModules.DynamsoftCameraView;
 
+/**
+ * The singleton instance of CameraEnhancer.
+ * */
 let dce: CameraEnhancer | null;
-export class CameraEnhancer extends ImageSourceAdapter {
-    private constructor() {
-        super();
-    }
-
-    protected init() {
-        this.isaId = DynamsoftCameraEnhancerModule.createInstance()
-    }
-
-    static async requestCameraPermission() {
-        if(Platform.OS === "android") {
-            DynamsoftCameraEnhancerModule.requestCameraPermission()
-        }
-    }
-
-    static getInstance(): CameraEnhancer {
-        if (dce) {
-            return dce;
-        }
-        return dce = new CameraEnhancer();
-    }
-
-    open() {
-        DynamsoftCameraEnhancerModule.open();
-    }
-
-    close() {
-        DynamsoftCameraEnhancerModule.close();
-    }
-
-    setCameraView(view: CameraView) {
-        if (view) {
-            DynamsoftCameraEnhancerModule.setCameraView(view.nativeCameraViewHandle);
-        }
-    }
-
-    selectCamera(position: EnumCameraPosition | number) {
-        DynamsoftCameraEnhancerModule.selectCamera(position);
-    }
-
-    getCameraPosition(): Promise<EnumCameraPosition | number> {
-        return DynamsoftCameraEnhancerModule.getCameraPosition();
-    }
-
-    setFocus(floatX: number, floatY: number, focusMode: EnumFocusMode | number) {
-        DynamsoftCameraEnhancerModule.setFocus(floatX, floatY, focusMode);
-    }
 
-    getFocusMode(): Promise<EnumFocusMode | number> {
-        return DynamsoftCameraEnhancerModule.getFocusMode();
-    }
-
-    setZoomFactor(factor: number) {
-        DynamsoftCameraEnhancerModule.setZoomFactor(factor);
-    }
-
-    getZoomFactor(): Promise<number> {
-        return DynamsoftCameraEnhancerModule.getZoomFactor();
-    }
-
-    enableEnhancedFeatures(features: EnumEnhancedFeatures | number) {
-        DynamsoftCameraEnhancerModule.enableEnhancedFeatures(features);
-    }
-
-    disableEnhancedFeatures(features: EnumEnhancedFeatures | number) {
-        DynamsoftCameraEnhancerModule.disableEnhancedFeatures(features);
-    }
-
-    setScanRegion(region: DSRect | null | undefined) {
-        DynamsoftCameraEnhancerModule.setScanRegion(region);
-    }
-
-    getScanRegion(): Promise<DSRect | null | undefined> {
-        return DynamsoftCameraEnhancerModule.getScanRegion()
-    }
-
-    turnOnTorch() {
-        DynamsoftCameraEnhancerModule.turnOnTorch()
-    }
-
-    turnOffTorch() {
-        DynamsoftCameraEnhancerModule.turnOffTorch()
-    }
-
-    destroy() {
-        this.close()
-        super.destroy();
-    }
+/**
+ * The CameraEnhancer class is the primary class of Dynamsoft Camera Enhancer that defines the camera controlling APIs.
+ * It is a subclass of {@link ImageSourceAdapter}.
+ * <p>
+ * In js end of react-native, CameraEnhancer uses singleton mode. You can only get CaptureVisionRouter instance by {@link CameraEnhancer.getInstance}.
+ * */
+export class CameraEnhancer extends ImageSourceAdapter {
+  private constructor() {
+    super();
+  }
+
+  protected init() {
+    this.isaId = DynamsoftCameraEnhancerModule.createInstance()
+  }
+
+  /**Trigger to request the camera permission.*/
+  static async requestCameraPermission() {
+    if (Platform.OS === "android") {
+      DynamsoftCameraEnhancerModule.requestCameraPermission()
+    }
+  }
+
+  /**
+   * Get the singleton instance of CameraEnhancer.
+   * <p>
+   * This method ensures that only one instance of CameraEnhancer is created
+   * and reused throughout the application. If an instance already exists, it will
+   * return the existing one. Otherwise, it will create a new instance and return it.
+   *
+   * @returns {CameraEnhancer} The singleton instance of CameraEnhancer.
+   * */
+  static getInstance(): CameraEnhancer {
+    if (dce) {
+      return dce;
+    }
+    return dce = new CameraEnhancer();
+  }
+
+  /**Opens the currently selected camera and starts the video stream.*/
+  open() {
+    DynamsoftCameraEnhancerModule.open();
+  }
+
+  /**Closes the currently active camera and stops the video stream.*/
+  close() {
+    DynamsoftCameraEnhancerModule.close();
+  }
+
+  /**
+   * Bind a CameraView instance with this CameraEnhancer instance.
+   *
+   * <p>
+   * Code snippet:
+   * ```
+   * function App(): React.JSX.Element {
+   *      const cameraView = useRef<CameraView>(null);
+   *      const camera = CameraEnhancer.getInstance();
+   *      useEffect(() => {
+   *          camera.setCameraView(cameraView.current!!);
+   *          camera.open();
+   *      }, [camera, cameraView])
+   *      return (<CameraView style={{flex:1}} ref={cameraView}/>);
+   * }
+   * ```
+   *
+   * @param view - the CameraView element
+   * */
+  setCameraView(view: CameraView) {
+    if (view) {
+      DynamsoftCameraEnhancerModule.setCameraView(view.nativeCameraViewHandle);
+    }
+  }
+
+  /**
+   * Select a camera with a camera position.
+   * @param position - One of the {@link EnumCameraPosition}
+   * */
+  selectCamera(position: EnumCameraPosition | number) {
+    DynamsoftCameraEnhancerModule.selectCamera(position);
+  }
+
+  /**
+   * Get the camera position.
+   * @return {Promise<EnumCameraPosition|number>} - A promise that resolves {@link EnumCameraPosition.CP_BACK} or {@link EnumCameraPosition.CP_FRONT}.
+   * */
+  getCameraPosition(): Promise<EnumCameraPosition | number> {
+    return DynamsoftCameraEnhancerModule.getCameraPosition();
+  }
+
+  /**
+   * Set the focus point of interest and trigger an one-off auto-focus.
+   * After the focus, you can either lock the focalngth or keep the continuous auto focus enabled by configuring the subsequent focus mode.
+   * @param floatX - The x of focus point of interest. The coordinate base of the point is "image".
+   * @param floatX - The y of focus point of interest. The coordinate base of the point is "image".
+   * @param focusMode The subsequent focus mode.
+   * @see EnumFocusMode
+   * */
+  setFocus(floatX: number, floatY: number, focusMode: EnumFocusMode | number) {
+    DynamsoftCameraEnhancerModule.setFocus(floatX, floatY, focusMode);
+  }
+
+  /**
+   * Get the currently actived focus mode.
+   *  @return {Promise<EnumFocusMode|number>} - A promise that resolves one of {@link EnumFocusMode}.
+   * */
+  getFocusMode(): Promise<EnumFocusMode | number> {
+    return DynamsoftCameraEnhancerModule.getFocusMode();
+  }
+
+  /**
+   * Set the zoom factor of the camera.
+   * @param factor - The zoom factor.
+   * */
+  setZoomFactor(factor: number) {
+    DynamsoftCameraEnhancerModule.setZoomFactor(factor);
+  }
+
+  /**
+   * Get the zoom factor of the camera.
+   * @return {Promise<number>} - A promise that resolves current zoom factor.
+   * */
+  getZoomFactor(): Promise<number> {
+    return DynamsoftCameraEnhancerModule.getZoomFactor();
+  }
+
+  /**
+   * Enable the specified enhanced features. View {@link EnumEnhancedFeatures} to learn about these enhanced features.
+   * By default, these enhanced features are all disabled.
+   * <p>
+   * Code snippet:
+   * ```
+   * cameraEnhancer.enableEnhancedFeatures(EnumEnhancedFeatures.EF_AUTO_ZOOM | EnumEnhancedFeatures.EF_FRAME_FILTER)
+   * ```
+   * @param features - An enum value or a bitwise combination of EnumEnhancedFeatures which indicates a series of enhanced features.
+   * @see EnumEnhancedFeatures
+   * */
+  enableEnhancedFeatures(features: EnumEnhancedFeatures | number) {
+    DynamsoftCameraEnhancerModule.enableEnhancedFeatures(features);
+  }
+
+  /**
+   * Disables one or more previously enabled enhanced features.
+   * <p>
+   * Code snippet:
+   * ```
+   * cameraEnhancer.disableEnhancedFeatures(EnumEnhancedFeatures.EF_AUTO_ZOOM | EnumEnhancedFeatures.EF_FRAME_FILTER)
+   * ```
+   * @param features - An enum value or a bitwise combination of EnumEnhancedFeatures indicating the features to be disabled.
+   * @see EnumEnhancedFeatures
+   * */
+  disableEnhancedFeatures(features: EnumEnhancedFeatures | number) {
+    DynamsoftCameraEnhancerModule.disableEnhancedFeatures(features);
+  }
+
+  /**
+   * Sets the scan region within the camera's view which limits the frame acquisition to a specific area of the video feed.
+   * <p>
+   * Code snippet:
+   * ```
+   * let scanRegion = {
+   *    top: 25,
+   *    bottom: 75,
+   *    left: 25,
+   *    right: 75,
+   *    measuredInPercentage: true,
+   * }
+   * cameraEnhancer.setScanRegion(scanRegion);
+   * //...
+   * cameraEnhancer.setScanRegion(null); //Cancel the scan region
+   * ```
+   *
+   * @param region - specifies the scan region. If null or undefined, cancel the scan region.
+   * @remarks The region is always specified relative to the original video size, regardless of any transformations or zoom applied to the video display.
+   * @see DSRect
+   * */
+  setScanRegion(region: DSRect | null | undefined) {
+    DynamsoftCameraEnhancerModule.setScanRegion(region);
+  }
+
+  /**
+   * Retrieves the current scan region.
+   * @return {Promise<DSRect|null|undefined>} - A promise that resolves current scan region.
+   * @see DSRect
+   * */
+  getScanRegion(): Promise<DSRect | null | undefined> {
+    return DynamsoftCameraEnhancerModule.getScanRegion()
+  }
+
+  /**
+   * Turn on the torch.
+   * */
+  turnOnTorch() {
+    DynamsoftCameraEnhancerModule.turnOnTorch()
+  }
+
+  /**
+   * Turn off the torch.
+   * */
+  turnOffTorch() {
+    DynamsoftCameraEnhancerModule.turnOffTorch()
+  }
+
+  destroy() {
+    this.close()
+    super.destroy();
+  }
 }

package/src/dce/CameraView.tsx

@@ -1,5 +1,5 @@
 // @ts-ignore
-import React, {Component, ComponentProps} from 'react';
+import React, {Component, ComponentProps, createElement} from 'react';
 import {
     findNodeHandle,
     type HostComponent,
@@ -10,6 +10,13 @@ import {
 } from "react-native";
 import type {CameraViewNativeProps} from "./DynamsoftCameraViewNativeComponent";
 
+/**
+ * Transforms CameraViewNativeProps to a format compatible with the native CameraView component.
+ * This ensures only supported properties are passed to the native layer.
+ * @param props - The props for the {@link CameraView} component.
+ * @returns The transformed native props.
+ * @internal
+ */
 const transformToNativeCameraViewProps = (props: CameraViewNativeProps | undefined | null): CameraViewNativeProps => {
     return JSON.parse(JSON.stringify(
         {
@@ -31,9 +38,19 @@ const NativeCameraView: HostComponent<CameraViewNativeProps> = isTurboModuleEnab
     require("./DynamsoftCameraViewNativeComponent").default :
     requireNativeComponent(ComponentName)
 
+/**
+ * The CameraView class is a React Component that wraps the native CameraView, which is used to display the camera preview.
+ * Users can add interactable UI elements on the view.
+ * You can view {@link CameraViewNativeProps} to know what custom properties you can define.
+ * Only available when CameraView is bound on CameraEnhancer by {@link CameraEnhancer.setCameraView} .
+ * @prop CameraViewNativeProps
+ * @see CameraViewNativeProps
+ * @see CameraEnhancer.setCameraView
+ */
 export class CameraView extends Component<CameraViewNativeProps, any> {
     private readonly nativeCameraViewRef: React.RefObject<RefType> = React.createRef<RefType>();
     private readonly nativeProps = transformToNativeCameraViewProps(this.props)
+
     /** @internal */
     public get nativeCameraViewHandle(): number | null {
         return findNodeHandle(this.nativeCameraViewRef.current);