Interface DocumentScannerConfiguration

interface DocumentScannerConfiguration {
    acceptedAngleScore?: number;
    acceptedBrightnessThreshold?: number;
    acceptedSizeScore?: number;
    accessibilityConfiguration?: DocumentScannerAccessibilityConfiguration;
    autoSnappingButtonHidden?: boolean;
    autoSnappingButtonTitle?: string;
    autoSnappingDelay?: number;
    autoSnappingEnabled?: boolean;
    autoSnappingSensitivity?: number;
    bottomBarBackgroundColor?: string;
    bottomBarButtonsColor?: string;
    cameraBackgroundColor?: string;
    cameraModule?: CameraModule;
    cameraPreviewMode?: CameraPreviewMode;
    cameraUnavailableExplanationText?: string;
    cancelButtonHidden?: boolean;
    cancelButtonTitle?: string;
    defaultPageFilter?: ImageFilterType;
    detectorMode?: DocumentDetectorMode;
    documentImageSizeLimit?: Size;
    enableCameraButtonTitle?: string;
    enableCameraExplanationText?: string;
    flashButtonHidden?: boolean;
    flashButtonTitle?: string;
    flashEnabled?: boolean;
    forceUserGuidance?: boolean;
    ignoreBadAspectRatio?: boolean;
    imageScale?: number;
    maxNumberOfPages?: number;
    multiPageButtonHidden?: boolean;
    multiPageButtonTitle?: string;
    multiPageEnabled?: boolean;
    orientationLockMode?: OrientationLockMode;
    pageCounterButtonTitle?: string;
    photoQualityPrioritization?: CapturePhotoQualityPrioritization;
    polygonAutoSnapProgressColor?: string;
    polygonAutoSnapProgressEnabled?: boolean;
    polygonAutoSnapProgressLineWidth?: number;
    polygonBackgroundColor?: string;
    polygonBackgroundColorOK?: string;
    polygonColor?: string;
    polygonColorOK?: string;
    polygonCornerRadius?: number;
    polygonLineWidth?: number;
    preferredAspectRatios?: AspectRatio[];
    requiredAspectRatios?: AspectRatio[];
    shutterButtonAutoInnerColor?: string;
    shutterButtonAutoOuterColor?: string;
    shutterButtonHidden?: boolean;
    shutterButtonIndicatorColor?: string;
    shutterButtonManualInnerColor?: string;
    shutterButtonManualOuterColor?: string;
    stopsCameraSessionWhenDisappeared?: boolean;
    textHintBadAngles?: string;
    textHintBadAspectRatio?: string;
    textHintEnergySavingActive?: string;
    textHintNothingDetected?: string;
    textHintOK?: string;
    textHintOffCenter?: string;
    textHintTooDark?: string;
    textHintTooNoisy?: string;
    textHintTooSmall?: string;
    topBarBackgroundColor?: string;
    topBarButtonsActiveColor?: string;
    topBarButtonsInactiveColor?: string;
    touchToFocusEnabled?: boolean;
    useButtonsAllCaps?: boolean;
    userGuidanceBackgroundColor?: string;
    userGuidanceFontSize?: number;
    userGuidanceTextColor?: string;
}

Properties

acceptedAngleScore? acceptedBrightnessThreshold? acceptedSizeScore? accessibilityConfiguration? autoSnappingButtonHidden? autoSnappingButtonTitle? autoSnappingDelay? autoSnappingEnabled? autoSnappingSensitivity? bottomBarBackgroundColor? bottomBarButtonsColor? cameraBackgroundColor? cameraModule? cameraPreviewMode? cameraUnavailableExplanationText? cancelButtonHidden? cancelButtonTitle? defaultPageFilter? detectorMode? documentImageSizeLimit? enableCameraButtonTitle? enableCameraExplanationText? flashButtonHidden? flashButtonTitle? flashEnabled? forceUserGuidance? ignoreBadAspectRatio? imageScale? maxNumberOfPages? multiPageButtonHidden? multiPageButtonTitle? multiPageEnabled? orientationLockMode? pageCounterButtonTitle? photoQualityPrioritization? polygonAutoSnapProgressColor? polygonAutoSnapProgressEnabled? polygonAutoSnapProgressLineWidth? polygonBackgroundColor? polygonBackgroundColorOK? polygonColor? polygonColorOK? polygonCornerRadius? polygonLineWidth? preferredAspectRatios? requiredAspectRatios? shutterButtonAutoInnerColor? shutterButtonAutoOuterColor? shutterButtonHidden? shutterButtonIndicatorColor? shutterButtonManualInnerColor? shutterButtonManualOuterColor? stopsCameraSessionWhenDisappeared? textHintBadAngles? textHintBadAspectRatio? textHintEnergySavingActive? textHintNothingDetected? textHintOK? textHintOffCenter? textHintTooDark? textHintTooNoisy? textHintTooSmall? topBarBackgroundColor? topBarButtonsActiveColor? topBarButtonsInactiveColor? touchToFocusEnabled? useButtonsAllCaps? userGuidanceBackgroundColor? userGuidanceFontSize? userGuidanceTextColor?

Properties

acceptedAngleScore?: number

The minimum score in percent (0 - 100) of the perspective distortion to accept a detected document. Default is 75.0.

acceptedBrightnessThreshold?: number

The brightness threshold to accept a detected document in the range of 0 (very dark) to 255 (very bright). If the average brightness value of the detector's input image is below this value, the status of the detection will be set to ERROR_TOO_DARK.

acceptedSizeScore?: number

The minimum document width or height in percent (0 - 100) of the screen size to accept a detected document. Default is 80.0.

accessibilityConfiguration?: DocumentScannerAccessibilityConfiguration

Allows you to customize the accessibility configuration for the Document Scanner UI.

autoSnappingButtonHidden?: boolean

Whether the auto-snapping toggle button is hidden.

autoSnappingButtonTitle?: string

Title of the auto-snapping toggle button.

autoSnappingDelay?: number

Minimum delay in seconds between two consecutive automatic image captures. iOS only.

autoSnappingEnabled?: boolean

If enabled, the document scanner will take a photo automatically when a document is detected, conditions are good and the auto-snapping time-out elapses. In this mode, the user can still tap the shutter button to snap a document.

autoSnappingSensitivity?: number

Controls the auto-snapping speed. Sensitivity must be within the 0..1 range. A value of 1.0 triggers automatic capturing immediately, a value of 0.0 delays the automatic capturing by 3 seconds. The default value is 0.66 (2 seconds).

bottomBarBackgroundColor?: string

Background color of the bottom shutter bar.

bottomBarButtonsColor?: string

Color of the titles of all buttons in the bottom shutter bar (cancel button, etc.) as well as the camera permission prompt button.

cameraBackgroundColor?: string

Color of the camera background (relevant only when the camera preview mode is CameraPreviewMode.FIT_IN).

cameraModule?: CameraModule

Preferred camera module (default: back camera).

cameraPreviewMode?: CameraPreviewMode

Preview mode of the camera. Fit-in or fill-in.

cameraUnavailableExplanationText?: string

String displayed on the label indicating that the app is in split mode and needs to go fullscreen to work with the camera. iOS only.

cancelButtonHidden?: boolean

Whether the cancel button is hidden. iOS only.

cancelButtonTitle?: string

Title of the cancel button.

defaultPageFilter?: ImageFilterType

Default image filter type for new document pages. Defaults to ImageFilterTypeNone.

detectorMode?: DocumentDetectorMode

Document detector mode to be used for document outline detection. Defaults to ML_BASED. iOS only. For Android, use the Scanbot SDK initializer.

documentImageSizeLimit?: Size

Limits the maximum size of the document image. If its width or height are zero, this property is effectively ignored.

enableCameraButtonTitle?: string

Title of the button that opens the screen in which users can allow the app's usage of the camera.

enableCameraExplanationText?: string

Text that will be displayed when the app is not allowed to use the camera, prompting the user to enable the usage of the camera.

flashButtonHidden?: boolean

Whether the flash toggle button is hidden.

flashButtonTitle?: string

Title of the flash toggle button.

flashEnabled?: boolean

Whether the flash should be initially enabled. The default value is false.

forceUserGuidance?: boolean

Whether to show the user guidance elements if auto-snapping is disabled.

ignoreBadAspectRatio?: boolean

Whether to ignore the OK_BUT_BAD_ASPECT_RATIO detection status. By default BadAspectRatio is not ignored.

imageScale?: number

Factor for scaling images. Must be within the 0..1 range. A factor of 1 means that the resulting images retain their original size. When the factor is less than 1, resulting images will be made smaller by that factor. By default the scale is 1.

maxNumberOfPages?: number

Maximum number of pages to scan. Ignored when set to null or when multiPageEnabled is false. Default value is null.

multiPageButtonHidden?: boolean

Whether the multi-page toggle button is hidden.

multiPageButtonTitle?: string

Title of the multi-page mode toggle button.

multiPageEnabled?: boolean

Controls initial multi-page mode. When enabled, the user can take multiple document photos before closing the screen by tapping the page counter button. When disabled, the screen will be closed immediately after the first document photo is made. The default value is false.

orientationLockMode?: OrientationLockMode

Lock mode of the UI's orientation.

pageCounterButtonTitle?: string

Title suffix of the button that finishes the document scanning process when multi-page scanning is enabled. The button's title has the format "# Pages", where '#' shows the number of images captured up to now and the suffix "Pages" is set using this method.

photoQualityPrioritization?: CapturePhotoQualityPrioritization

Prioritization of still image quality and capturing speed. Defaults to CapturePhotoQualityPrioritization.BALANCED. If you experience lots of blurry still images, try setting this property to CapturePhotoQualityPrioritization.QUALITY. iOS only.

polygonAutoSnapProgressColor?: string

Stroke color of the polygon auto-snap progress animation. Default is green. Cannot be nil.

polygonAutoSnapProgressEnabled?: boolean

Whether the polygon auto-snap progress animation is enabled. Default is true.

polygonAutoSnapProgressLineWidth?: number

Line width of the polygon auto-snap progress animation. Default is 5.0.

polygonBackgroundColor?: string

Background color of the detected document outline when the document's angle, size or aspect ratio is not yet sufficiently good. (All net.doo.snap.lib.detector.DetectionResult with OK_BUT_XXX.)

polygonBackgroundColorOK?: string

Background color of the detected document outline when the document's angle, size and aspect ratio are sufficiently good.

polygonColor?: string

Color of the detected document outline when the document's angle, size or aspect ratio is not yet sufficiently good. (All detection statuses in net.doo.snap.lib.detector.DetectionResult that have the OK_BUT_XXX prefix.)

polygonColorOK?: string

Color of the detected document outline when the document's angle, size and aspect ratio are sufficiently good.

polygonCornerRadius?: number

Radius to use when drawing the rounded corners of the polygon. Default is 8.0.

polygonLineWidth?: number

Width of the detected document outline.

preferredAspectRatios?: AspectRatio[]

Optional array of aspect ratios the documents should preferably conform to.

requiredAspectRatios?: AspectRatio[]

Optional array of aspect ratios the documents must conform to.

shutterButtonAutoInnerColor?: string

Foreground color of the shutter button in auto-snapping mode.

shutterButtonAutoOuterColor?: string

Background color of the shutter button in auto-snapping mode.

shutterButtonHidden?: boolean

Whether to hide the shutter button. Defaults to false. If set to true, auto-snapping is enabled and the property autoSnappingEnabled of the behavior configuration will have no effect. In addition, the auto-snapping button will be hidden.

shutterButtonIndicatorColor?: string

Indicator color of the shutter button in auto-snapping mode. iOS only.

shutterButtonManualInnerColor?: string

Foreground color of the shutter button in manual mode.

shutterButtonManualOuterColor?: string

Background color of the shutter button in manual mode.

stopsCameraSessionWhenDisappeared?: boolean

If true, the camera session will be stopped entirely when the receiver disappears and restarted when the receiver reappears. Else, the delivery of video frames will be paused. Defaults to true. iOS only.

textHintBadAngles?: string

Text hint that will be shown when the current detection status is OK_BUT_BAD_ANGLES.

textHintBadAspectRatio?: string

Text hint that will be shown when the current detection status is OK_BUT_BAD_ASPECT_RATIO.

textHintEnergySavingActive?: string

Text hint that will be shown when the scanner's energy saver is activated. iOS only.

textHintNothingDetected?: string

Text hint that will be shown when the current detection status is ERROR_NOTHING_DETECTED.

textHintOK?: string

Text hint that will be shown when the current detection status is OK.

textHintOffCenter?: string

Text hint that will be shown when a document was detected but its center is too far away from the image center.

textHintTooDark?: string

Text hint that will be shown when the current detection status is ERROR_TOO_DARK.

textHintTooNoisy?: string

Text hint that will be shown when the current detection status is ERROR_TOO_NOISY.

textHintTooSmall?: string

Text hint that will be shown when the current detection status is OK_BUT_TOO_SMALL.

topBarBackgroundColor?: string

Background color of the top toolbar.

topBarButtonsActiveColor?: string

Color of all active toggle buttons in the toolbar.

topBarButtonsInactiveColor?: string

Color of all inactive toggle buttons in the toolbar.

touchToFocusEnabled?: boolean

Whether touch-to-focus is enabled on camera preview. Enabled by default. Android only.

useButtonsAllCaps?: boolean

Controls whether buttons should use the all-capitals style as defined by the Android Material Design. Defaults to true. Android only.

userGuidanceBackgroundColor?: string

Background color of the user guidance hints.

userGuidanceFontSize?: number

Font size of the user guidance. Default is 17.0.

userGuidanceTextColor?: string

Text color of the user guidance hints.