{WebTwainObject}.Addon.Camera

/**
 * Return a list of all available cameras.
 */
getSourceList(): Promise<DeviceInfo[]>;

interface DeviceInfo{
    deviceId: string;
    label: string;
}

/**
 * Select a camera to use.
 * @param deviceId Specify the camera with its deviceId.
 */
selectSource(deviceId: string): Promise<DeviceInfo>;

/**
 * Return the info about the current camera.
 */
getCurrentSource():DeviceInfo;

/**
 * Close the current camera.
 */
closeSource(): Promise<DeviceInfo>;

/**
 * Return the resolutions supported by the current camera.
 */
getResolution(): Promise<Resolution[]>

interface Resolution{
    width: number;
    height: number;
}

/**
 * Set the resolution for the current camera.
 * @param resolution Specify the resolution.
 */
setResolution(resolution: Resolution): Promise<Resolution>;

/**
 * Return the resolution of the current camera.
 */
getCurrentResolution(): Promise<Resolution>;

/**
 * Start streaming video from the current camera.
 * @param element Specify an HTML element to put the video stream in.
 * @param resolution Specify the initial resolution.
 * @param fill Whether to fill the viewer space with the video stream and leave no margin. The default value is `false`.
 */
play(element?: HTMLElement,
    resolution?: Resolution,
    fill?: boolean
): Promise<Resolution>;

/**
 * Pause the video stream.
 */
pause(): void;

/**
 * Resume the video stream.
 */
resume(): void;

/**
 * Stop the video stream.
 */
stop(): void;

/**
 * Return the status of the current camera.
 */
getStatus(): string;

/**
 * Capture a frame from the video stream.
 */
capture(): Promise<Blob>;

/**
 * Start streaming video from the current camera in the viewer.
 * @param deviceId Specify a camera.
 * @param resolution Specify the initial resolution.
 * @param mode Specify the mode.
 * @param fill Whether to fill the viewer area with the video stream and leave no margin.
 */
showVideo(deviceId?: string,
    resolution?: Resolution,
    mode?: string,
    fill?: boolean
): Promise<Resolution>;

/**
 * Close the camera and hide the video streaming UI.
 */
closeVideo(): void;

/**
 * This event is triggered when the video is closed.
 */
on("video-closed", callback: () => void): boolean;

/**
 * This event is triggered when the video playing operation. throws out an error.
 * @argument errorCode The error code.
 * @argument errorString The error string.
 */
on("video-error", callback: (errorCode, errorString) => void): boolean;

/**
 * Open the camera to capture document(s).
 * @param scanConfiguration Specify the scan configuration.
 */
scanDocument(scanConfiguration?: ScanConfiguration
): Promise<Resolution>;

interface ScanConfiguration{
  element?: HTMLDivElement, //Bind the element or element id. 
                             //After binding, display the video in the specified element, otherwise, display the video in full screen.
  scannerViewer?:{
    deviceId?: string,  
    maxDocuments?: number,       //The maximum documents can be captured/loaded in to the buffer. 
    enableBorderDetection?: boolean,  // Whether to enable border detection. The default value is true.
    fullScreen?: boolean,   //Whether to display the video in full screen. The default value is false.
    polygonStyle?:{      //The sytle of the auto detect border.       
      stroke: string,    //default: "#fe8e14". Only supports #16 hexadecimal.
      strokeWidth: string,  //default: "2px"
      dash: string          //The allowed value are "solid" and "dashed", the default value is "solid".
      },
    resolution?:{
      visibility?: boolean, //Whether to display the resolution icon in the upper left corner. The default value is true.
      valueList?:[ {   
       label: string,    //The resolution value listed in the drop-down list. For example："1920x1080"
       value: Resolution //The resolution you set. For example: { width:1920, height:1080}
      },{……}]
       defaultValue?: Resolution , //Set the default value according to the value set in the valueList.
      },
    autoScan?:{   //Automatically capture when a clear document is detected. Only applicable to video scanning. 
       visibility?: boolean,     //Whether to display the automatic scan icon. The default value is true.
       enableAutoScan?: boolean, //Whether to enable automatic scan. The default value is false.
       },
    autoDetect?:{  //Only applicable to video scanning.                  
       visibility?: boolean,         //Whether to display the automatic border detection icon. The default value is true.
       enableAutoDetect?: boolean,   //Whether to enable automatic border detection. The default value is false.     
       acceptedPolygonConfidence?: number, //The default value is 80. The higher the setting, the more accurate the automatic border detection.
       fpsLimit?: number,  //The maximum number of frames detected per second. The default value is 3.
       },     
    continuousScan?:{   //Only applicable to video scanning.
       visibility?: boolean,   //Whether to display the continuous scan icon. The default value is true.
       enableContinuousScan?: boolean,  //Whether to enable continuous scan. The default value is true.
       },
    switchCamera?:{  //The default camera is the rear camera.
       visibility?: boolean,   //Whether to display the switch camera icon. The default value is true.
       },
    loadLocalFile?:{  
       visibility?: boolean,   //Whether to display the load local file icon. The default value is true.
       },
    funcConfirmExitContinuousScan?: funcConfirmExitContinuousScan, 
      //funcConfirmExitContinuousScan is the callback funtion
      //Return true：Exit continuous scan mode without saving the captured image data. Return false: Stay on the original viewer
    funcConfirmExit?: funcConfirmExit, 
      //funcConfirmExit is the callback funtion
      //Return true：End this capture without saving the image data. Return false: Stay on the original viewer
    },

  filterViewer?:{
    visibility?: boolean,   //Whether to display filter viewer. The default value is true.
    insert?: {  //Insert an image  
       visibility?: boolean,   //Whether to display the insert icon. The default value is true.
       position?: string   //Set whether to insert the image "before" or "after" the current image. The default value is "before".
       },
    remove?: { //Remove an image
   	  visibility?: boolean,   //Whether to display the remove icon. The default value is true.
       },
    rotateLeft?: { 
      visibility?: boolean,   //Whether to display the rotate left icon. The default value is true.
      },
    filter?: {  
      visibility?: boolean,   //Whether to display the filter icon. The default value is true.
      valueList?:[ {   //If not specified, listing all the filters in the order of original, blackAndWhite, grayscale, clean, brightening, saveToner by default. 
                        //Support adjusting the valueList order to arrange the filter order.
       label: string,   //The label of the filter. For example. The filter "Original" can be modified to any word you want to describe
       value: string,   //The filter value. The value must be set according to our specification below.
			//Allowed values:
                        //original 
		        //blackAndWhite
			//grayscale
			//clean
			//brightening
			//saveToner	
       option?: {
          level: 1 //The filter level. The allowed values are 1(default value), 2, 3.
                      //The higher the level, the better the quality, but the more time it takes.
           }
        },{……}]
	 
       defaultValue?: string,   //Filter selected by default. By default, the original filter is selected.
       },
    exitDocumentScanAfterSave?: false  //The default value is false.
    },

  cropViewer?: { 
    visibility?: boolean,   //Whether to display the crop viewer. The default value is true. 
    polygonStyle?:{    //The polygon style in the crop viewer.       
      stroke: string,       //default : "#fe8e14".  Only supports #16 hexadecimal.
      strokeWidth: string,   //default: "2px"
      dash: string           //The allowed value are "solid" and "dashed", the default value is "solid".
      },
    rotateLeft?:{   
      visibility?: boolean,   //Whether to display the rotate left icon. The default value is true.
     },
    rotateRight?:{   
      visibility?: boolean,   //Whether to display the rotate right icon. The default value is true.
     },
    autoDetectBorder?:{   
      visibility?: boolean,   //Whether to display the automatic border detection icon. The default value is true.
     },
   }
 }

 function funcConfirmExitContinuousScan(){
     return true;  
  }

 function funcConfirmExit(){
     return true;  
  }