Params that influence the scanning process.

Constructors

Properties

alreadyCropped?: boolean

This option can be set to true if you know for sure that the image you provide contains already cropped document by its edges. This was designed to process on the server side images captured and cropped on mobile.

authenticityParams: AuthenticityParams
backendProcessingConfig?: BackendProcessingConfig

Set up the backend processing service parameters.

barcodeParserType?: number

There are documents that contain barcodes which data can be parsed only if document type verification is performed. The following property allows setting the barcode parser type which should be used during recognition. It allows parsing barcode data without performing document type verification.

barcodeTypes?: BarcodeType[]

Set types of barcodes that you wish to recognize. All barcodes will be recognized if it's empty.

Unmodifiable property. Use setter instead of editing.

captureButtonScenario?: Scenario

Documents processing scenario for the Capture button.

checkHologram?: boolean

Use authenticityParams.checkLiveness instead.

checkRequiredTextFields?: boolean

If set to true, in case required fields are not read, their values will be empty.

convertCase?: number

This option allows output text case transformation. No changes applied by default to original values.

customParams?: Record<string, any>

Takes JSON with parameters that are not presented in the DocumentReader.

Unmodifiable property. Use setter instead of editing.

dateFormat?: string

Change the format string of displayed dates in the results.

Mask examples: dd/mm/yyyy, mm/dd/yyyy, dd-mm-yyyy, mm-dd-yyyy, dd/mm/yy. Set to null to revert default value.

depends on the device's locale.
debugSaveCroppedImages?: boolean

If set to true, cropped images will be saved to the application's directory.

debugSaveImages?: boolean

If set to true, images will be saved to the application's directory.

debugSaveLogs?: boolean

If set to true, text logs will be saved to the application's directory.

debugSaveRFIDSession?: boolean

If set to true, RFID sessions will be saved to the application's directory.

depersonalizeLog?: boolean

If set to true, personal information will be removed from logs.

disableAuthResolutionFilter?: boolean

This parameter if enabled will ignore the minimum barcode resolution needed to start processing.

disableFocusingCheck?: boolean

If set to true, document focus check will be omitted.

disablePerforationOCR?: boolean

When enabled, OCR of perforated fields in the document template will not be performed.

documentAreaMin?: number

Specifies minimal area of the image that document should cover to be treated as candidate when locating. Value should be in range from 0 to 1, where 1 is when document should fully cover the image.

documentGroupFilter?: DocumentTypeEnum[]

Array of specific eligible document types to recognize from. You may, for example, specify only passports to be recognized by setting this property.

Unmodifiable property. Use setter instead of editing.

documentIDList?: number[]

Takes the list of the document IDs to process. All documents will be processed if it's empty.

Unmodifiable property. Use setter instead of editing.

doublePageSpread?: boolean

If set to true, allows to process up to two pages of the document (so-called "a double-page spread") for one-shot if they are presented on the frame (image).

faceApiParams?: FaceApiParams

Custom Face API integration params.

fieldTypesFilter?: FieldType[]

If you recognize the MRZ of documents, all fields will be extracted. If you recognize the Visual zone of documents, you can set the list of field types that you wish to extract, other fields will be skipped during processing. All fields will be extracted if it is empty.

Unmodifiable property. Use setter instead of editing.

forceDocFormat?: DocFormat

Force use of specified document format when locating and recognizing document to reduce the number of candidates.

forceDocID?: number

Force use of specific template ID and skip document type identification step.

forceReadMrzBeforeLocate?: boolean

This option can be set to true to make sure that in series processing MRZ is located fully inside the result document image, if present on the document. Enabling this option may add extra processing time, by disabling optimizations, but allows more stability in output image quality.

generateAlpha2Codes?: boolean
generateDoublePageSpreadImage?: boolean

When enabled together with doublePageSpread and there is a passport with two pages spread in the image, pages will be cropped, straightened and aligned together, as if the document was captured on a flatbed scanner.

generateDTCVC?: boolean

This parameter is used to generate DTCVC data.

generateNumericCodes?: boolean

This parameter is used to generate numeric representation for issuing state and nationality codes.

imageDpiOutMax?: number

This option controls maximum resolution in dpi of output images. Resolution will remain original in case 0 is set.

imageOutputMaxHeight?: number

Maximum height of output images. In pixels.

imageOutputMaxWidth?: number

Maximum width of output images. In pixels.

imageQA: ImageQA

Controls properties of ImageQA checks.

integralImage?: boolean

Allows to build an integral image, taking into account the quality of fixation of each of the individual images.

lcidFilter?: LCID[]

The whitelist of LCID types to use during the recognition.

Unmodifiable property. Use setter instead of editing.

lcidIgnoreFilter?: LCID[]

The list of LCID types to ignore during the recognition. If empty, values with all LCID types will be extracted. Narrowing down the list can reduce processing time.

Unmodifiable property. Use setter instead of editing.

logLevel?: LogLevel

Sets the level of logs detalization when used together with logs parameter.

logs?: boolean

If set to true, the DocumentReader logs will be shown in the console.

manualCrop?: boolean

If set to true, allows you to manually set the document's bounds after it is detected.

matchTextFieldMask?: boolean

When disabled, text field OCR will be done as is and then the recognized value will be matched to the field mask for validity. If enabled, we are trying to read a field value with maximum efforts to match the mask and provide a correctly formatted value, making assumptions based on the provided field mask in the template.

measureSystem?: MeasureSystem

Measure system of fields' values that are presented in results. Default: If the country code is US or LR or MM, the MeasureSystem.IMPERIAL system of measurement, otherwise, the MeasureSystem.METRIC.

minDPI?: number

Allows you to set the minimum acceptable DPI value of the camera frame that is passed for recognition. Camera frames the DPI of which are less than you set won't be passed for recognition.

minimalHolderAge?: number

This options allows specifying the minimal age in years of the document holder for the document to be considered valid.

mrzDetectMode?: MrzDetectionModes

Make better MRZ detection on complex noisy backgrounds, like BW photocopy of some documents. Works only in the single-frame processing.

mrzFormatsFilter?: MRZFormat[]

This option allows limiting MRZ formats to be recognized by specifying them in array.

Unmodifiable property. Use setter instead of editing.

multiDocOnImage?: boolean

This option allows locating and cropping multiple documents from one image if enabled.

multipageProcessing?: boolean

If set to true, processing of more than one page of the document (if they exist) will be triggered, otherwise, only one page will be processed.

noGraphics?: boolean

When enabled no graphic fields will be cropped from document image.

parseBarcodes?: boolean

When set to false, the Barcode code parsing will be skipped and the raw information from the code will be returned instead.

pdfPagesLimit?: number

Maximum number of pages to be processed in a PDF document. If set, only the specified number of pages will be analyzed.

perspectiveAngle?: number

since 7.6 Allows you to set the maximum value of the deviation of the corners of the document from the value of 90 degrees.

processAuth?: number

Accepts sum of Authenticity values.

respectImageQuality?: boolean

Use strictImageQuality instead. When enabled, image quality checks status affects document optical and overall status.

resultTypeOutput?: ResultType[]

Types of results to return in response.

Unmodifiable property. Use setter instead of editing.

returnCroppedBarcode?: boolean

If set to true, an image with cropped barcode will be returned.

returnUncroppedImage?: boolean

If set to true, an original (uncropped) image will be received, which is sent for recognition.

rfidParams?: RFIDParams

Custom RFID params.

scenario?: Scenario

Documents processing scenario.

selectLongestNames?: boolean

Select the longest value from the different value sources and write it to the value field if comparison is done successfully. The parameter applies this logic to the personal names, such as given name, surname, surname and given name, middle name and etc.

shiftExpiryDate?: number

This option allows shifting the date of expiry into the future or past for number of months specified. This is useful, for example, in some cases when document might be still valid for some period after original expiration date to prevent negative validity status for such documents. Or by shifting the date to the past will set negative validity for the documents that is about to expire in a specified number of months.

shouldReturnPackageForReprocess?: boolean

When set to true, the rawResults property of the Results will contain the encrypted containers of scanning results that may be used for later reprocessing.

splitNames?: boolean

When enabled, the Surname and GivenNames field (TextField) will be divided into fields with fieldTypes FieldType.FIRST_NAME, FieldType.SECOND_NAME, FieldType.THIRD_NAME, FieldType.LAST_NAME.

strictBarcodeDigitalSignatureCheck?: boolean

If the certificates required for performing the Digital signature check are missing, this parameter if enabled will make the Barcode format check failed.

strictDLCategoryExpiry?: boolean

Set to force DL categories expiry date status to either valid or not. By default, if the DL category expiry date is correct, its status will be wasNotDone, otherwise error.

strictImageQuality?: boolean

When enabled, the image quality check status affects the document optical and overall status.

strictSecurityChecks?: boolean

When enabled, this parameter marks security checks that don’t meet minimum requirements as 'Failed' (instead of 'WasNotDone'), which causes the overall security status to be 'Failed'.

timeout?: number

Allows you to set the time limit for document recognition (in seconds), beyond which the recognition does not continue regardless of its result. The countdown starts from the moment the scenario starts. Setting value to 0 means infinity.

timeoutFromFirstDetect?: number

Allows you to set the time limit for document recognition (in seconds), beyond which the recognition does not continue regardless of its result. The countdown starts from the moment the document is detected. Setting value to 0 means infinity.

timeoutFromFirstDocType?: number

Allows you to set the time limit for document recognition (in seconds), beyond which the recognition does not continue regardless of its result. The countdown starts from the moment the document type is recognized. Setting value to 0 means infinity.

timeoutLiveness?: number

Start the countdown from the moment the document liveness authenticity check is started (in seconds). Setting value to 0 means infinity.

updateOCRValidityByGlare?: boolean

When enabled, fail OCR field validity, if there is a glare over the text ƒfield on the image.

useAuthenticityCheck?: boolean

This parameter is used to enable document authenticity check.

useFaceApi?: boolean

Use this property to set up the Face API integration.

uvTorchEnabled?: boolean

Set to true when torch is connected and enabled by user.

Android only.

Methods

  • Returns void

  • Parameters

    Returns void

  • Parameters

    Returns void

  • Allows you to deserialize object.

    Parameters

    • jsonObject: any

    Returns ProcessParams