{WebTwainObject} Scan

/**
 * Start image acquisition.
 * @param deviceConfiguration Configuration for the acquisition.
 * @param successCallback A callback function that is executed if the request succeeds.
 * @param failureCallback A callback function that is executed if the request fails.
 * @argument errorCode The error code.
 * @argument errorString The error string.
 */
AcquireImage(
    deviceConfiguration?: DeviceConfiguration
): void;

AcquireImage(
    successCallBack?: () => void,
    failureCallBack?: (
        errorCode: number,
        errorString: string) => void
): void;

AcquireImage(
    deviceConfiguration?: DeviceConfiguration,
    successCallBack?: () => void,
    failureCallBack?: (
        deviceConfiguration?: DeviceConfiguration,
        errorCode: number,
        errorString: string) => void
): void;

interface DeviceConfiguration {
    /**
     * Whether to show the built-in User Interface from the device vendor.
     */
    IfShowUI?: boolean;
    /**
     * How a pixel is represented. Basically it means whether to scan in color, grey or black & white
     */
    PixelType?: Dynamsoft.DWT.EnumDWT_PixelType;
    /**
     * How detailed is the acquisition. Measured by dots per pixel (DPI)
     */
    Resolution?: number;
    /**
     * Whether to use the document feeder or the flatbed of the device.
     */
    IfFeederEnabled?: boolean;
    /**
     * Whether to scan one side or both sides of each paper.
     */
    IfDuplexEnabled?: boolean;
    /**
     * Whether to close the built-in User Interface after aquisition. Only valid when {IfShowUI} is true.
     */
    IfDisableSourceAfterAcquire?: boolean;
    /**
     * Whether to retrieve information about the image after it's transferred.
     */
    IfGetImageInfo?: boolean;
    /**
     * Whether to retrieve extended information about the image after it's transferred.
     */
    IfGetExtImageInfo?: boolean;
    /**
     * How much extended information is retrieved. Only valid when {IfGetExtImageInfo} is true.
     */
    extendedImageInfoQueryLevel?: number;
    /**
     * Whether to simulate the manufacturer's UI inside the client-side browser (only effective when IfShowUI is true).
     * (Added in 16.2)
     */
    RemoteScan?:boolean;
    /**
     * Whether to simulate the manufacturer's UI inside the client-side browser (only effective when IfShowUI and RemoteScan are both true and the WebTwain instance doing the scan has no viewer of its own).
     * (Added in 16.2)
     */
    ShowRemoteScanUI?:boolean;
    /**
     * Specify a source by its index (only effective when RemoteScan is true).
     * (Added in 16.2)
     */
    SelectSourceByIndex?: number;
}

/**
 * Close the data source (a TWAIN/ICA/SANE device which in most cases is a scanner) to free it to be used by other applications.
 */
CloseSource(): boolean; 

/**
 * Close the data source (a TWAIN/ICA/SANE device which in most cases is a scanner) to free it to be used by other applications.
 */
CloseSourceAsync(): Promise<boolean>;

/**
 * Disable the data source (a TWAIN/ICA/SANE device which in most cases is a scanner) to stop the acquiring process. If the data source's user interface is displayed, it will be closed.
 */
DisableSource(): boolean;

/**
 * Enable the data source to start the acquiring process.
 */ 
EnableSource(): boolean;

/**
 * Display the TWAIN source's built-in user interface.
 * @param successCallback A callback function that is executed if the request succeeds.
 * @param failureCallback A callback function that is executed if the request fails.
 */
EnableSourceUI(
    successCallBack: () => void,
    failureCallBack: (
        errorCode: number,
        errorString: string) => void
): void;

/**
 * Load a data source to get it ready to acquire images.
 */
OpenSource(): boolean;

/**
 * Load a data source to get it ready to acquire images.
 */
OpenSourceAsync(): Promise<boolean>;

/**
 * Return all available data sources (scanners, etc.) and optionally all detailed information about them.
 * @param bIncludeDetails Whether to return more details about the data sources or just their names.
 */
GetSourceNames(bIncludeDetails: boolean): string[] | ISourceDetails[];

interface SourceDetails {
    /**
     * The driver type which can be "TWAIN" | "ICA" | "SANE"
     */
    DriverType?: string;
    /**
     * Information about the driver if it's DriverType is "ICA"
     */
    DeviceInfo?: any;
    /**
     * The name of the data source. E.g. "TWAIN2 FreeImage Software Scanner".
     */
    ProductName?: string;
    /**
     * Whether it is the default source.
     */
    IsDefaultSource?: boolean;
    /**
     * Whether it is the current source.
     */
    IsCurrentSource?: boolean;
    /**
     * The family name of the data source. E.g. "Software Scan".
     */
    ProductFamily?: string;
    /**
     * The manufacturer of the data source. E.g. "TWAIN Working Group".
     */
    Manufacturer?: string;
    /**
     *
     */
    SupportedGroups?: 1073741827,
    /**
     * The version of the protocol based on which the data source is developed.
     */
    ProtocolMajor?: number;
    ProtocolMinor?: number;
    /**
     * Detailed version of the data source.
     */
    Version?: Version;
}
interface Version {
    MajorNum?: number;
    MinorNum?: number;
    Language?: number;
    Country?: number;
    Info?: string;
}

/**
 * Return all available data sources (scanners, etc.) and optionally all detailed information about them.
 * @param bIncludeDetails Whether to return more details about the data sources or just their names.
 */
GetSourceNamesAsync(bIncludeDetails: boolean): Promise<string[] | ISourceDetails[]>;

/**
 * Bring up the Source Selection User Interface (UI) for the user to choose a data source.
 * @param successCallback A callback function that is executed if the request succeeds.
 * @param failureCallback A callback function that is executed if the request fails.
 * @argument errorCode The error code.
 * @argument errorString The error string.
 */
SelectSource(
    successCallBack?: () => void,
    failureCallBack?: (errorCode: number, errorString: string) => void
): boolean | void;

/**
 * Bring up the Source Selection User Interface (UI) for the user to choose a data source.
 * @param successCallback A callback function that is executed if the request succeeds.
 * @param failureCallback A callback function that is executed if the request fails.
 * @argument errorCode The error code.
 * @argument errorString The error string.
 */
SelectSourceAsync(): Promise<number>;

/**
 * Select a data source by its index.
 * @param index The index of the data source.
 */
SelectSourceByIndex(index: number): boolean;

/**
 * Select a data source by its index.
 * @param index The index of the data source.
 */
SelectSourceByIndexAsync(index: number): Promise<boolean>;

/**
 * Sets a timer which stops the data source opening process once it expires.
 * @param duration Define the duration of the timer (in milliseconds).
 */
SetOpenSourceTimeout(duration: number): boolean;

/**
 * Start the acquisition by passing all settings at once.
 * @param scanSetup Configuration for the acquisition.
 */
startScan(scanSetup: ScanSetup): Promise<IScanSetup>;

interface ScanSetup {
  /**
   * An id that specifies this specific setup.
   */
  setupId?: string,
  /**
   * Whether to ignore or fail the acquistion when an exception is raised. Set "ignore" or "fail".
   */
  exception?: string,
  /**
   * The name of the data source (the scanner). If not set, the default data source is used.
   */
  scanner?: string,
  ui?: {
    /**
     * Whether to show the UI of the device.
     */
    bShowUI?: boolean,
    /**
     * Whether to show the indicator of the device.
     */
    bShowIndicator?: boolean,
  },
  /**
   * The TWAIN transfer mode.
   */
  transferMode?: Dynamsoft.DWT.EnumDWT_TransferMode | number,
  /**
   * Set how the transfer is done.
   */
  fileXfer?: {
    /**
     * Specify the file name (or pattern) for file transfer.
     * Example: "C:\\WebTWAIN<%06d>.bmp"
     */
    fileName?: string,
    /**
     * Specify the file format.
     */
    fileFormat?: Dynamsoft.DWT.EnumDWT_FileFormat | number,
    /**
     * Specify the quality of JPEG files.
     */
    jpegQuality?: number,
    /**
     * Specify the compression type of the file.
     */
    compressionType?: Dynamsoft.DWT.EnumDWT_CompressionType | number
  }
  /**
   * Set where the scanned images are inserted.
   */
  insertingIndex?: number,
  /**
   * The profile is a base64 string, if present, it overrides settings and more settings.
   */
  profile?: string,
  /**
   * Basic settings.
   */
  settings?: {
    /**
     * "ignore" (default) or "fail".
     */
    exception?: string,
    /**
     * Specify the pixel type.
     */
    pixelType?: Dynamsoft.DWT.EnumDWT_PixelType | number,
    /**
     * Specify the resolution.
     */
    resolution?: number,
    /**
     * Whether to enable document feader.
     */
    bFeeder?: boolean,
    /**
     * Whether to enable duplex scan.
     */
    bDuplex?: boolean
  },
  moreSettings?: {
    /**
     * "ignore" (default) or "fail".
     */
    exception?: string,
    /**
     * Specify the bit depth.
     */
    bitDepth?: number,
    /**
     * Specify the page size.
     */
    pageSize?: Dynamsoft.DWT.EnumDWT_CapSupportedSizes | number,
    /**
     * Specify the unit.
     */
    unit?: Dynamsoft.DWT.EnumDWT_UnitType | number,
    /**
     * Specify a layout to scan, if present, it'll override pageSize.
     */
    layout?: {
      left?: number,
      top?: number,
      right?: number,
      bottom?: number
    },
    /**
     * Specify the pixel flavor.
     */
    pixelFlavor?: Dynamsoft.DWT.EnumDWT_CapPixelFlavor | number,
    /**
     * Specify Brightness.
     */
    brightness?: number,
    /**
     * Specify contrast.
     */
    contrast?: number,
    /**
     * Specify how many images are transferred per session.
     */
    nXferCount?: number,
    /**
     * Whether to enable automatic blank image detection and removal.
     */
    autoDiscardBlankPages?: boolean,
    /**
     * Whether to enable automatic border detection.
     */
    autoBorderDetection?: boolean,
    /**
     * Whether to enable automatic skew correction.
     */
    autoDeskew?: boolean,
    /**
     * Whether to enable automatic brightness adjustment.
     */
    autoBright?: boolean
  },
  /**
   * A callback triggered before the scan, after the scan and after each page has been transferred.
   * Returned status
   * {event: 'beforeAcquire', result: {…}} //Equivalent to OnPreAllTransfers event
   * {event: 'postTransfer', bScanCompleted: false, result: {…}} //Equivalent to OnPostTransfer event
   * {event: 'postTransfer', bScanCompleted: true, result: {…}} //Equivalent to OnPostAllTransfers event
   */
  funcScanStatus?: (status: Status) => void,
  /**
   * Set up how the scanned images are outputted.
   */
  outputSetup?: {
    /**
     * Output type. "http" is the only supported type for now.
     */
    type?: string,
    /**
     * Set the output format.
     */
    format?: Dynamsoft.DWT.EnumDWT_ImageType | number,
    /**
     * Specify how many times the library will try the output.
     */
    reTries?: 3,
    /**
     * Whether to use the FileUploader.
     */
    useUploader?: false,
    /**
     * Whether to upload all images in one HTTP post.
     */
    singlePost?: boolean,
    /**
     * Whether to show a progress bar when outputting.
     */
    showProgressBar?: boolean,
    /**
     * Whether to remove the images after outputting.
     */
    removeAfterOutput?: boolean,
    /**
     * A callback triggered during the outputting.
     * @argument fileInfo A JSON object that contains the fileName, percentage, statusCode, responseString, etc.
     */
    funcHttpUploadStatus?: (fileInfo: any) => void,
    /**
     * Setup for PDF output.
     */
    pdfSetup?: {
      author?: string,
      compression?: Dynamsoft.DWT.EnumDWT_PDFCompressionType | number,
      creator?: string,
      /**
       * Example: 'D:20181231'
       */
      creationDate?: string,
      keyWords?: string,
      /**
       * Example: 'D:20181231'
       */
      modifiedDate?: string,
      producer?: string,
      subject?: string,
      title?: string,
      version?: number,
      quality?: number
    },
    /**
     * Setup for TIFF output.
     */
    tiffSetup?: {
      quality?: number,
      compression?: Dynamsoft.DWT.EnumDWT_TIFFCompressionType | number,
      /**
       * Specify Tiff custom tags.
       */
      tiffTags?: TiffTag[]
    },
    /**
     * Setup for HTTP upload via Post.
     */
    httpParams?: {
      /**
       * Target of the request.
       * Example: "http://dynamsoft.com/receivepost.aspx"
       */
      url?: string,
      /**
       * Custom headers in the form.
       * Example: {md5: ""}
       */
      headers?: any,
      /**
       * Custom form fields.
       * Example: {"UploadedBy": "Dynamsoft"}
       */
      formFields?: any,
      /**
       * The maximum size of a file to be uploaded (in bytes).
       */
      maxSizeLimit?: number,
      /**
       * Specify how many threads (<=4) are to be used. Only valid when {useUploader} is true.
       */
      threads?: number,
      /**
       * Specify the names for the files in the form.
       * Example: "RemoteName<%06d>"
       */
      remoteName?: string,
      /**
       * Specify the name(s) (pattern) of the uploaded files.
       * Example: "uploadedFile<%06d>.jpg"
       */
      fileName?: string
    }
  }
}

/**
 * Cancels all pending transfers.
 */ 
CancelAllPendingTransfers(): boolean;

/**
 * Closes and unloads Data Source Manager.
 */
CloseSourceManager(): boolean;

/**
 * Closes and unloads Data Source Manager.
 */
CloseSourceManagerAsync(): Promise<boolean>;

/**
 * Closes the scanning process to release resources on the machine.
 */
CloseWorkingProcess(): boolean;

/**
 * Ejects the current page and begins scanning the next page in the document feeder.
 */
FeedPage(): boolean;

/**
 * Get the custom data source data and saves the data in a specified file.
 * @param fileName The path of the file to save the data source data to.
 */
GetCustomDSData(fileName: string): boolean;

/**
 * Gets custom DS data and returns it in a base64 string.
 */
GetCustomDSDataEx(): string;

/**
 * Inspect the current data source and return whether it is a scanner, a webcam, etc.
 */
GetDeviceType(): number;

/**
 * Get the name of a data source by its index in data source manager source list.
 * @param index The index of the data source.
 */
GetSourceNameItems(index: number): string;

/**
 * Load and open data source manager.
 */
OpenSourceManager(): boolean;

/**
 * Load and open data source manager.
 */
OpenSourceManagerAsync(): Promise<boolean>;

/**
 * Reset the image layout in the data source.
 */
ResetImageLayout(): boolean;

/**
 * If called while {IfFeederEnabled} property is true, the data source will return the current page to the input area and return the last page from the output area into the acquisition area.
 */
RewindPage(): boolean;

/**
 * Sets custom data source data to be used for scanning, the data is stored in a file which can be regarded as a scanning profile.
 * @param fileName The path  of the file.
 */
SetCustomDSData(fileName: string): boolean;

/**
 * Set custom data source data to be used for scanning, the input is a base64 string.
 * @param dsDataString The string that contains custom data source data.
 */
SetCustomDSDataEx(dsDataString: string): boolean;

/**
 * Set the file transfer information to be used in File Transfer mode.
 * @param fileName The path to transfer the file to.
 * @param fileFormat The format of the file.
 */
SetFileXferInfo(
    fileName: string,
    fileFormat: Dynamsoft.DWT.EnumDWT_FileFormat | number
): boolean;

/**
 * Set the left, top, right, and bottom sides of the image layout rectangle for the current data source. The image layout rectangle defines a frame of the data source's scanning area to be acquired.
 * @param left Specify the rectangle (leftmost coordinate).
 * @param top Specify the rectangle (topmost coordinate).
 * @param right Specify the rectangle (rightmost coordinate).
 * @param bottom Specify the rectangle (bottommost coordinate).
 */
SetImageLayout(
    left: number,
    top: number,
    right: number,
    bottom: number
): boolean;

/**
 * Return or set the pixel bit depth for the current value of `PixelType` .
 */
BitDepth: number;

/**
 * Return or set whether newly acquired images are inserted or appended.
 */
IfAppendImage: boolean;

/**
 * Return or set whether to enable duplex scanning (in other words, whether to scan both sides of the paper).
 */
IfDuplexEnabled: boolean;

/** 
 * Return or set whether a data source's Automatic Document Feeder (ADF) is enabled for scanning.
 */
IfFeederEnabled: boolean;

/**
 * Return or set whether the data source displays the user interface when scanning.
 */
IfShowUI: boolean;

/**
 * Return or set the driver type which determines the type of sources to use.
 */
ImageCaptureDriverType: Dynamsoft.DWT.EnumDWT_Driver | number;

/**
 * Return or set the page size the data source uses to acquire images.
 */
PageSize: Dynamsoft.DWT.EnumDWT_CapSupportedSizes | number;

/**
 * Return or set the pixel type used when acquiring images. 
 */
PixelType: Dynamsoft.DWT.EnumDWT_PixelType | number;

/**
 * Return or set the resolution used when acquiring images.
 */
Resolution: number;

/**
 * Returns how many data sources are available on the local system.
 */
readonly SourceCount: number;

/**
 * Retrun or set the dividing line between black and white.
 */
BlankImageThreshold: number;

/**
 * Return or set the brightness to be used for scanning by the data source.
 */
Brightness: number;

/**
 * Return or set Contrast to be used for scanning by the data source.
 */
Contrast: number;

/**
 * Return the device name of current source. 
 */
readonly CurrentSourceName: string; 

/**
 * Return a value that indicates the data source status.
 */
DataSourceStatus: number;

/**
 * Return the name of the last used source. 
 */
DefaultSourceName: string;

/**
 * Return whether the source supports duplex. If yes, it further returns the level of duplex the data source supports.
 */
readonly Duplex: Dynamsoft.DWT.EnumDWT_DUPLEX | number;

/**
 * Return or set whether to enable the data source's auto-brightness feature.
 */
IfAutoBright: boolean;

/**
 * Return or set whether the data source (the scanner) discards blank images during scanning automatically.
 */
IfAutoDiscardBlankpages: boolean;

/**
 * Return or set whether to enable the data source's automatic document feeding process.
 */
IfAutoFeed: boolean;

/**
 * Return or set whether to enable the data source's automatic border detection feature.
 */
IfAutomaticBorderDetection: boolean;

/**
 * Return or set whether to enable the data source's automatic skew correction feature.
 */
IfAutomaticDeskew: boolean;

/**
 * Return or set whether to enable the data source's automatic document scanning process.
 */
IfAutoScan: boolean;

/**
 * Return whether or not there are documents loaded in the data source's feeder.
 */
readonly IfFeederLoaded: boolean;

/**
 * Return whether the Source has a paper sensor that can detect pages on the ADF or Flatbed.
 */
readonly IfPaperDetectable: boolean;

/**
 * Return or set whether the data source displays a progress indicator during acquisition and transfer.
 */
IfShowIndicator: boolean;

/**
 * Return whether the data source supports acquisitions with the UI (User Interface) disabled.
 */
readonly IfUIControllable: boolean; 

/**
 * Return or set whether the new TWAIN DSM (data source Manager) is used for acquisitions. The new TWAIN DSM is a DLL called 'TWAINDSM.dll' while the default | old DSM is called 'twain_32.dll'.
 */
IfUseTwainDSM: boolean;

/**
 * Return the value of the bottom edge of the current image frame (in Unit).
 */
readonly ImageLayoutFrameBottom: number;

/**
 * Return the value of the left edge of the current image frame (in Unit).
 */
readonly ImageLayoutFrameLeft: number;

/**
 * Return the value of the right edge of the current image frame (in Unit).
 */
readonly ImageLayoutFrameRight: number;

/**
 * Return the value of the top edge of the current image frame (in Unit).
 */
readonly ImageLayoutFrameTop: number;

/**
 * Return the document number of the current image.
 */
readonly ImageLayoutDocumentNumber: number;

/**
 * Return the page number of the current image.
 */
readonly ImageLayoutPageNumber: number;

/**
 * Return the bit depth of the current image.
 */
readonly ImageBitsPerPixel: number;

/**
 * Return the length of the current image.
 */
readonly ImageLength: number;

/**
 * Return the width of the current image.
 */
readonly ImageWidth: number;

/**
 * Return the horizontal resolution of the current image.
 */
readonly ImageXResolution: number;

/**
 * Return the vertical resolution of the current image.
 */
readonly ImageYResolution: number;

/**
 * Return the pixel type of the current image.
 */
readonly ImagePixelType: Dynamsoft.DWT.EnumDWT_PixelType | number;

/**
 * Return the data of the magnetic data if the data source supports magnetic data recognition.
 */
readonly MagData: string;

/**
 * Return the type of the magnetic data if the data source supports magnetic data recognition.
 */
readonly MagType: Dynamsoft.DWT.EnumDWT_MagType | number;

/**
 * Return the number of transfers the data source is ready to supply upon demand.
 */
readonly PendingXfers: number;

/**
 * Return or set the pixel flavor to be used for acquiring images.
 */
PixelFlavor: number;

/**
 * Return or set the data source's transfer mode.
 */
TransferMode: Dynamsoft.DWT.EnumDWT_TransferMode | number;

/**
 * Return or set the unit of measure for all quantities. Note that this setting is only effective for TWAIN (hardware) related operations. 
 */
Unit: Dynamsoft.DWT.EnumDWT_UnitType | number;

/**
 * Return and set the number of images your application is willing to accept for each scan job.
 */ 
XferCount: number;

/**
 * This event is triggered when all page(s) have been scanned and transferred.
 */
RegisterEvent('OnPostAllTransfers',function(){});

/**
 * This event is triggered after each page has been scanned and transferred.
 */ 
RegisterEvent('OnPostTransfer',function() {});

/**
 * This event is triggered after each page has been scanned and transferred. This is the asynchronous counterpart to the synchronous event {OnPostTransfer}.
 * @argument outputInfo Detailed information about the image that just got transferred.
 */ 
RegisterEvent('OnPostTransferAsync',function(outputInfo: OutputInfo) {});

interface outputInfo {
    /**
     * Id of the image if it's transferred to the buffer.
     */
    imageId?: number;
    /**
     * Path of the image if it's transferred to the disk.
     */
    Path?: string;
    /**
     * Information about the image.
     */
    imageInfo?: object;
    /**
     * Extended information about the image.
     */
    extendedImageInfo?: object;
}

/**
 * This event is triggered when all images are scanned and ready to be transferred.
 */
RegisterEvent('OnPreAllTransfers',function(){});

/**
 * This event is triggered when a page has been scanned and is ready to be transferred.
 */
RegisterEvent('OnPreTransfer',function(){...});

/**
 * This event is triggered when the user interface of the data source is closed manually by the user.
 */
RegisterEvent('OnSourceUIClose',function() {});

/**
 * Gets detailed information about all capabilities of the current data source.
 * @param successCallback A callback function that is executed if the request succeeds.
 * @param failureCallback A callback function that is executed if the request fails.
 * @argument capabilityDetails Detailed information about the specified capabilities.
 * @argument errorCode The error code.
 * @argument errorString The error string.
 */
getCapabilities(
    successCallback: (capabilityDetails: CapabilityDetails[]) => void,
    failureCallback: (
        errorCode: number,
        errorString: string
    ) => void
): void;

/**
 * Detailed information about a specific capability
 */
interface CapabilityDetails {
    /**
     * The Capability.
     */
    capability: ValueAndLabel;
    /**
     * The container type of the Capability
     */
    conType: ValueAndLabel;
    /**
     * The index for the current value of the Capability
     */
    curIndex: number;
    /**
     * The current value of the Capability
     */    
    curValue: ValueAndLabel;
    /**
     * The index for the default value of the Capability
     */    
    defIndex: number;
    /**
     * The operation types that are supported by the Capability. Types include {"get", "set", "reset" "getdefault", "getcurrent"}
     */   
    query: string[];
    /**
     * The value type of the Capability. Value types include
        TWTY_BOOL: 6
        TWTY_FIX32: 7
        TWTY_FRAME: 8
        TWTY_INT8: 0
        TWTY_INT16: 1
        TWTY_INT32: 2
        TWTY_STR32: 9
        TWTY_STR64: 10
        TWTY_STR128: 11
        TWTY_STR255: 12
        TWTY_UINT8: 3
        TWTY_UINT16: 4
        TWTY_int: 5
     */    
    valueType: ValueAndLabel;
    /**
     * The available values of the Capability
     */    
    values: ValueAndLabel[];
}

interface ValueAndLabel {
    /**
     * Numeric representation of the item
     */
    value: Dynamsoft.DWT.EnumDWT_Cap | Dynamsoft.DWT.EnumDWT_CapType | Dynamsoft.DWT.EnumDWT_CapValueType | number;
    /**
     * Label or name of the item
     */    
    label: string;
}

/**
 * Sets up one or multiple capabilities in one call.
 * @param capabilities A object that describes how to set capabilities.
 * @param successCallback A callback function that is executed if the request succeeds.
 * @param failureCallback A callback function that is executed if the request fails.
 * @argument capabilities The capabilities to set.
 */
setCapabilities(
    capabilities: Capabilities,
    successCallback: (capabilities: Capabilities) => void,
    failureCallback: (capabilities: Capabilities) => void
): void;

interface Capabilities {
    /**
     * Whether to "ignore" or "fail" the request if an exception occurs. This is an overall setting that is inherited by all capabilities. 
     */
    exception: string;
    /**
     * Specifies how to set capabilities
     */
    capabilities: CapabilitySetup[]
}

interface CapabilitySetup {
    /**
     * Specify a capability
     */
    capability: Dynamsoft.DWT.EnumDWT_Cap | number;
    /**
     * The value to set to the capability or the value of the capability after setting.
     */
    curValue: number | string;
    errorCode?: number;
    errorString?: string;
    /**
     * Whether to "ignore" or "fail" the request if an exception occurs when setting this specific capability.
     */
    exception? : string;
}