DocumentScannerConfiguration class

Document scanner configuration class. All UI configuration options are optional.

Inheritance

Constructors

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

Properties

acceptedAngleScore double?
The minimum score in percent (0 - 100) of the perspective distortion to accept a detected document. Default is 75.0.
getter/setter pairinherited
acceptedSizeScore double?
The minimum document width or height in percent (0 - 100) of the screen size to accept a detected document. Default is 80.0.
getter/setter pairinherited
accessibilityConfiguration DocumentScannerAccessibilityConfiguration?
Allows you to customize the accessibility configuration for the Document Scanner UI
getter/setter pairinherited
autoSnappingButtonHidden bool?
Controls whether the auto-snapping toggle button is hidden or not.
getter/setter pairinherited
autoSnappingButtonTitle String?
Title of the auto-snapping toggle button.
getter/setter pairinherited
autoSnappingDelay double?
The minimum delay in seconds between two consecutive automatic image captures. iOS only.
getter/setter pairinherited
autoSnappingEnabled bool?
When auto-snapping is 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.
getter/setter pairinherited
autoSnappingSensitivity double?
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 by 3 seconds. The default value is 0.66 (2 seconds)
getter/setter pairinherited
bottomBarBackgroundColor Color?
The background color of the bottom shutter-bar.
getter/setter pairinherited
bottomBarButtonsColor Color?
The color of the title of all buttons in the bottom shutter-bar (Cancel button, etc.), as well as the camera permission prompt button.
getter/setter pairinherited
cameraBackgroundColor Color?
The color of the camera background (relevant only when the camera preview mode is CameraPreviewMode.FIT_IN).
getter/setter pairinherited
cameraModule CameraModule?
The preferred camera module (default - BACK)
getter/setter pairinherited
cameraPreviewMode CameraPreviewMode?
Preview mode of the camera. Fit-In or Fill-In.
getter/setter pairinherited
cameraUnavailableExplanationText String?
String being displayed on the label describing that the app is in split mode and needs to go fullscreen to work with camera. iOS only.
getter/setter pairinherited
cancelButtonHidden bool?
Whether the cancel button is hidden or not. iOS only.
getter/setter pairinherited
cancelButtonTitle String?
Title of the cancel button.
getter/setter pairinherited
defaultPageFilter ImageFilterType?
The default image filter type for new documents pages. Defaults to ImageFilterTypeNone.
getter/setter pairinherited
detectorMode DocumentDetectorMode?
The mode of the document detector to be used for document outline detection. Defaults to ML_BASED. iOS only. For Android, use the Scanbot SDK initializer.
getter/setter pairinherited
documentImageSizeLimit Size?
Limits the maximum size of the document image. If width or height are zero, this property is effectively ignored.
getter/setter pairinherited
enableCameraButtonTitle String?
Title of the button that opens the screen where the user can allow the usage of the camera by the app.
getter/setter pairinherited
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.
getter/setter pairinherited
flashButtonHidden bool?
Controls whether the flash toggle button is hidden or not.
getter/setter pairinherited
flashButtonTitle String?
Title of the flash toggle button.
getter/setter pairinherited
flashEnabled bool?
Controls whether the flash should be initially enabled. The default value is FALSE.
getter/setter pairinherited
forceUserGuidance bool?
Shows the user guidance elements if autosnapping is disabled.
getter/setter pairinherited
hashCode int
The hash code for this object.
no setterinherited
ignoreBadAspectRatio bool?
Sets whether to ignore the OK_BUT_BAD_ASPECT_RATIO detection status. By default BadAspectRatio is not ignored.
getter/setter pairinherited
imageScale double?
The image scaling factor. The factor 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.
getter/setter pairinherited
maxNumberOfPages int?
Maximum number of pages to scan. Ignored when set to null, or when multiPageEnabled is FALSE. Default value is null.
getter/setter pairinherited
multiPageButtonHidden bool?
Controls whether the multi-page toggle button is hidden or not.
getter/setter pairinherited
multiPageButtonTitle String?
Title of the multi-page mode toggle button.
getter/setter pairinherited
multiPageEnabled bool?
Controls 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.
getter/setter pairinherited
orientationLockMode OrientationLockMode?
UI Interface orientation lock mode
getter/setter pairinherited
pageCounterButtonTitle String?
Title suffix of the button that finishes the document scanning 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.
getter/setter pairinherited
photoQualityPrioritization CapturePhotoQualityPrioritization?
The prioritization of still image quality and capturing speed. Defaults to CapturePhotoQualityPrioritization.BALANCED. If you experience lots of blurry still images try to set this property to CapturePhotoQualityPrioritization.QUALITY. Note: Has no effect on devices prior to iOS 13.0!. iOS only.
getter/setter pairinherited
polygonAutoSnapProgressColor Color?
Stroke color of polygon auto snap progress animation. Default is green. Can't be nil.
getter/setter pairinherited
polygonAutoSnapProgressEnabled bool?
Whether polygon auto snap progress animation is enabled or not. Default is true.
getter/setter pairinherited
polygonAutoSnapProgressLineWidth double?
Line width of polygon auto snap progress animation. Default is 5.0.
getter/setter pairinherited
polygonBackgroundColor Color?
The 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).
getter/setter pairinherited
polygonBackgroundColorOK Color?
The background color of the detected document outline when we are ready to snap OK.
getter/setter pairinherited
polygonColor Color?
The 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).
getter/setter pairinherited
polygonColorOK Color?
The color of the detected document outline when we are ready to snap OK.
getter/setter pairinherited
polygonCornerRadius double?
The radius to use when drawing rounded corners of the polygon. Default is 8.0.
getter/setter pairinherited
polygonLineWidth double?
Width of the detected document outline.
getter/setter pairinherited
preferredAspectRatios List<AspectRatio>?
An optional array of aspect ratios the documents may conform to.
getter/setter pairinherited
requiredAspectRatios List<AspectRatio>?
An optional array of aspect ratios the documents have to conform to.
getter/setter pairinherited
runtimeType Type
A representation of the runtime type of the object.
no setterinherited
screen String?
The configuration object should be applied for this screen
getter/setter pairoverride
shutterButtonAutoInnerColor Color?
Whether polygon auto snap progress animation is enabled or not. Default is true.
getter/setter pairinherited
shutterButtonAutoOuterColor Color?
The background color of the shutter button in auto-snapping mode.
getter/setter pairinherited
shutterButtonHidden bool?
Hides the shutter button if set to TRUE. Shows it otherwise. Defaults to FALSE. If set to TRUE, auto-snapping is enabled and the property autoSnappingEnabled of the behaviour configuration will have no effect. Also the auto-snapping button will be hidden.
getter/setter pairinherited
shutterButtonIndicatorColor Color?
The indicator color of the shutter button in auto-snapping mode. iOS only.
getter/setter pairinherited
shutterButtonManualInnerColor Color?
The foreground color of the shutter button in manual mode.
getter/setter pairinherited
shutterButtonManualOuterColor Color?
The background color of the shutter button in manual mode.
getter/setter pairinherited
stopsCameraSessionWhenDisappeared bool?
The camera session will be stopped entirely, when the receiver disappears and restarts when the receiver reappears if set to True else will pause the delivery of video frames and QR Codes. Defaults to True. iOS only.
getter/setter pairinherited
textHintBadAngles String?
Text hint that will be shown when the current detection status is OK_BUT_BAD_ANGLES
getter/setter pairinherited
textHintBadAspectRatio String?
Text hint that will be shown when the current detection status is OK_BUT_BAD_ASPECT_RATIO
getter/setter pairinherited
textHintEnergySavingActive String?
The text being displayed on the user-guidance label, when the scanners energy saver is activated. iOS only.
getter/setter pairinherited
textHintNothingDetected String?
Text hint that will be shown when the current detection status is ERROR_NOTHING_DETECTED
getter/setter pairinherited
textHintOffCenter String?
The text being displayed on the user-guidance label, when a document was detected, but its center is too far away from the image center.
getter/setter pairinherited
textHintOK String?
Text hint that will be shown when the current detection status is OK
getter/setter pairinherited
textHintTooDark String?
Text hint that will be shown when the current detection status is ERROR_TOO_DARK
getter/setter pairinherited
textHintTooNoisy String?
Text hint that will be shown when the current detection status is ERROR_TOO_NOISY
getter/setter pairinherited
textHintTooSmall String?
Text hint that will be shown when the current detection status is OK_BUT_TOO_SMALL
getter/setter pairinherited
topBarBackgroundColor Color?
The background color of the top toolbar.
getter/setter pairinherited
topBarButtonsActiveColor Color?
The color of all active toggle buttons in the toolbar.
getter/setter pairinherited
topBarButtonsInactiveColor Color?
The color of all inactive toggle buttons in the toolbar.
getter/setter pairinherited
touchToFocusEnabled bool?
Whether touch-to-focus is enabled on camera preview. Enabled by default. Android only.
getter/setter pairinherited
useButtonsAllCaps bool?
Controls whether buttons should use all capitals style, as defined by the Android Material Design. Defaults to TRUE. Android only.
getter/setter pairinherited
userGuidanceBackgroundColor Color?
The background color of the user guidance hints.
getter/setter pairinherited
userGuidanceFontSize double?
Font size of the user guidance. Default is 17.0.
getter/setter pairinherited
userGuidanceTextColor Color?
The text color of the user guidance hints.
getter/setter pairinherited
version String?
A version of the configuration object
getter/setter pairinherited

Methods

noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toJson() Map<String, dynamic>
inherited
toString() String
A string representation of this object.
inherited

Operators

operator ==(Object other) bool
The equality operator.
inherited