Optional
acceptedOptional
acceptedThe 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.
Optional
acceptedThe minimum document width or height in percent (0 - 100) of the screen size to accept a detected document. Default is 80.0.
Optional
accessibilityAllows you to customize the accessibility configuration for the Document Scanner UI.
Optional
autoWhether the auto-snapping toggle button is hidden.
Optional
autoTitle of the auto-snapping toggle button.
Optional
autoMinimum delay in seconds between two consecutive automatic image captures. iOS only.
Optional
autoIf 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.
Optional
autoControls 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).
Optional
bottomBackground color of the bottom shutter bar.
Optional
bottomColor of the titles of all buttons in the bottom shutter bar (cancel button, etc.) as well as the camera permission prompt button.
Optional
cameraColor of the camera background (relevant only when the camera preview mode is CameraPreviewMode.FIT_IN).
Optional
cameraPreferred camera module (default: back camera).
Optional
cameraPreview mode of the camera. Fit-in or fill-in.
Optional
cameraString displayed on the label indicating that the app is in split mode and needs to go fullscreen to work with the camera. iOS only.
Optional
cancelWhether the cancel button is hidden. iOS only.
Optional
cancelTitle of the cancel button.
Optional
defaultDefault image filter type for new document pages. Defaults to ImageFilterTypeNone.
Optional
detectorDocument detector mode to be used for document outline detection. Defaults to ML_BASED. iOS only. For Android, use the Scanbot SDK initializer.
Optional
documentLimits the maximum size of the document image. If its width or height are zero, this property is effectively ignored.
Optional
enableTitle of the button that opens the screen in which users can allow the app's usage of the camera.
Optional
enableText that will be displayed when the app is not allowed to use the camera, prompting the user to enable the usage of the camera.
Optional
flashWhether the flash toggle button is hidden.
Optional
flashTitle of the flash toggle button.
Optional
flashWhether the flash should be initially enabled. The default value is false.
Optional
forceWhether to show the user guidance elements if auto-snapping is disabled.
Optional
ignoreWhether to ignore the OK_BUT_BAD_ASPECT_RATIO detection status. By default BadAspectRatio is not ignored.
Optional
imageFactor 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.
Optional
maxMaximum number of pages to scan. Ignored when set to null or when multiPageEnabled
is false. Default value is null.
Optional
multiWhether the multi-page toggle button is hidden.
Optional
multiTitle of the multi-page mode toggle button.
Optional
multiControls 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.
Optional
orientationLock mode of the UI's orientation.
Optional
pageTitle 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.
Optional
photoPrioritization 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.
Optional
polygonStroke color of the polygon auto-snap progress animation. Default is green. Cannot be nil.
Optional
polygonWhether the polygon auto-snap progress animation is enabled. Default is true.
Optional
polygonLine width of the polygon auto-snap progress animation. Default is 5.0.
Optional
polygonBackground 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.)
Optional
polygonBackground color of the detected document outline when the document's angle, size and aspect ratio are sufficiently good.
Optional
polygonColor 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.)
Optional
polygonColor of the detected document outline when the document's angle, size and aspect ratio are sufficiently good.
Optional
polygonRadius to use when drawing the rounded corners of the polygon. Default is 8.0.
Optional
polygonWidth of the detected document outline.
Optional
preferredOptional array of aspect ratios the documents should preferably conform to.
Optional
requiredOptional array of aspect ratios the documents must conform to.
Optional
shutterForeground color of the shutter button in auto-snapping mode.
Optional
shutterBackground color of the shutter button in auto-snapping mode.
Optional
shutterWhether 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.
Optional
shutterIndicator color of the shutter button in auto-snapping mode. iOS only.
Optional
shutterForeground color of the shutter button in manual mode.
Optional
shutterBackground color of the shutter button in manual mode.
Optional
stopsIf 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.
Optional
textText hint that will be shown when the current detection status is OK_BUT_BAD_ANGLES.
Optional
textText hint that will be shown when the current detection status is OK_BUT_BAD_ASPECT_RATIO.
Optional
textText hint that will be shown when the scanner's energy saver is activated. iOS only.
Optional
textText hint that will be shown when the current detection status is ERROR_NOTHING_DETECTED.
Optional
textText hint that will be shown when the current detection status is OK.
Optional
textText hint that will be shown when a document was detected but its center is too far away from the image center.
Optional
textText hint that will be shown when the current detection status is ERROR_TOO_DARK.
Optional
textText hint that will be shown when the current detection status is ERROR_TOO_NOISY.
Optional
textText hint that will be shown when the current detection status is OK_BUT_TOO_SMALL.
Optional
topBackground color of the top toolbar.
Optional
topColor of all active toggle buttons in the toolbar.
Optional
topColor of all inactive toggle buttons in the toolbar.
Optional
touchWhether touch-to-focus is enabled on camera preview. Enabled by default. Android only.
Optional
useControls whether buttons should use the all-capitals style as defined by the Android Material Design. Defaults to true. Android only.
Optional
userBackground color of the user guidance hints.
Optional
userFont size of the user guidance. Default is 17.0.
Optional
userText color of the user guidance hints.
The minimum score in percent (0 - 100) of the perspective distortion to accept a detected document. Default is 75.0.