Kofax Mobile SDK API Reference
Public Member Functions | List of all members
QuickAnalysisSettings Class Reference

A configuration object for controlling the quick analysis image processing. More...

Public Member Functions

 QuickAnalysisSettings ()
 Default constructor creates a quick analysis setting object that has default values. More...
 
boolean getBlurDetection ()
 Gets the status of blur detection. More...
 
void setBlurDetection (boolean enabled)
 Sets the status of blur detection. More...
 
boolean getLegacyBlurDetection ()
 Gets the status of legacy blur detection. More...
 
void setLegacyBlurDetection (boolean enabled)
 Sets the status of legacy blur detection. More...
 
boolean getSaturationDetection ()
 Gets the status of saturation detection. More...
 
void setSaturationDetection (boolean enabled)
 Sets the status of saturation detection. More...
 
boolean getGlareDetection ()
 Gets the status of glare detection. More...
 
void setGlareDetection (boolean enabled)
 Sets the status of glare detection. More...
 
double getGlareDetectionIntensityFraction ()
 Gets the value of intensity fraction in glare detection. More...
 
void setGlareDetectionIntensityFraction (double fraction)
 Sets the value of intensity fraction of glare detection. More...
 
double getGlareDetectionMinimumGlareAreaFraction ()
 Gets the value of minimum intensity glare area fraction in glare detection. More...
 
void setGlareDetectionMinimumGlareAreaFraction (double fraction)
 Sets the value of minimum glare area fraction of glare detection. More...
 
int getGlareDetectionIntensityThreshold ()
 Gets the value of intensity threshold in glare detection. More...
 
void setGlareDetectionIntensityThreshold (int threshold)
 Sets the value of intensity threshold fraction of glare detection. More...
 
int getGlareDetectionNumberOfTiles ()
 Gets the value of number of tiles in glare detection. More...
 
void setGlareDetectionNumberOfTiles (int tiles)
 Sets the value of number of tiles of glare detection. More...
 
double getGlareDetectedThreshold ()
 Gets the threshold for the area of the glare. More...
 
void setGlareDetectedThreshold (double threshold)
 Sets the threshold for the area of the glare. More...
 
int getBlurThreshold ()
 Gets the confidence threshold for the blur detection algorithm. More...
 
void setBlurThreshold (int threshold)
 Sets the confidence threshold for the blur detection algorithm. More...
 
int getLegacyBlurThreshold ()
 Gets the sensibility of the blur detection algorithm. More...
 
void setLegacyBlurThreshold (int threshold)
 Sets the sensibility of the blur detection algorithm. More...
 
int getBlurCountPercentThreshold ()
 Gets the threshold for blurry areas. More...
 
void setBlurCountPercentThreshold (int threshold)
 Sets the threshold for blurry areas. More...
 
boolean getSkewDetection ()
 Gets the status of skew detection in the quick analysis process. More...
 
void setSkewDetection (boolean enabled)
 Enable/disable skew detection in the quick analysis process. More...
 
boolean getShadowDetection ()
 Gets the status of shadow detection in the quick analysis process. More...
 
void setShadowDetection (boolean enabled)
 Enable/disable shadow detection in the quick analysis process. More...
 
boolean getMissingBordersDetection ()
 Gets the status of missing borders detection in the quick analysis process. More...
 
void setMissingBordersDetection (boolean enabled)
 Enable/disable missing borders detection in the quick analysis process. More...
 
boolean getLowContrastBackgroundDetection ()
 Gets the status of low contrast background detection in the quick analysis process. More...
 
void setLowContrastBackgroundDetection (boolean enabled)
 Enable/disable low contrast background detection in the quick analysis process. More...
 
UseMRZPassportDetection getUseMRZPassportDetection ()
 Gets the status of MRZ passport detection. More...
 
void setUseMRZPassportDetection (UseMRZPassportDetection useMRZPassportDetection)
 Sets the value of MRZ passport detection. More...
 
UseTargetFrameCrop getUseTargetFrameCrop ()
 Gets the value of target frame cropping. More...
 
void setUseTargetFrameCrop (UseTargetFrameCrop useTargetFrameCrop)
 Sets the value of target frame cropping. More...
 
UseDocumentDetectionBasedCrop getUseDocumentDetectionBasedCrop ()
 Gets the value of document detection based cropping. More...
 
void setUseDocumentDetectionBasedCrop (UseDocumentDetectionBasedCrop useDocumentDetectionBasedCrop)
 Sets the value of document detection based cropping. More...
 

Detailed Description

A configuration object for controlling the quick analysis image processing.

The primary purpose of the settings object is to define properties for quick analysis image processing.

Constructor & Destructor Documentation

Default constructor creates a quick analysis setting object that has default values.

Member Function Documentation

int getBlurCountPercentThreshold ( )

Gets the threshold for blurry areas.

An image is considered blurry when the amount of blurry areas exceeds this threshold.
The threshold should be specified as percentage of the image area.

Threshold values should be in the [0, 100] range, other values will be clamped to this range.
Defaults to 80.

Returns
the threshold for blurry areas
See also
getLegacyBlurThreshold()
boolean getBlurDetection ( )

Gets the status of blur detection.

Returns
boolean
See also
setBlurDetection(boolean)
int getBlurThreshold ( )

Gets the confidence threshold for the blur detection algorithm.

An image section is considered blurry when its algorithm confidence exceeds this threshold.

The threshold should be specified as percentage in the [0, 100] range, other values will be clamped to this range.
Defaults to 50.

Returns
the confidence threshold of the blur detection algorithm
double getGlareDetectedThreshold ( )

Gets the threshold for the area of the glare.

An image is considered to have a glare when the area of the glare exceeds this threshold.
The threshold should be specified as a fraction of the image area.

Threshold values should be in the [0.01, 0.99] range, other values will be clamped to this range.
Defaults to 0.05.

Returns
the threshold for the area of the glare
See also
setGlareDetectedThreshold(double)
boolean getGlareDetection ( )

Gets the status of glare detection.

Returns
boolean
See also
setGlareDetection(boolean)
double getGlareDetectionIntensityFraction ( )

Gets the value of intensity fraction in glare detection.

Return the intensity fraction value used in glare detection.

Returns
double
See also
setGlareDetectionIntensityFraction(double)
int getGlareDetectionIntensityThreshold ( )

Gets the value of intensity threshold in glare detection.

Return the intensity threshold value used in glare detection.

Returns
int
See also
setGlareDetectionIntensityThreshold(int)
double getGlareDetectionMinimumGlareAreaFraction ( )

Gets the value of minimum intensity glare area fraction in glare detection.

Return the minimum intensity glare area fraction value used in glare detection.

Returns
double
See also
setGlareDetectionMinimumGlareAreaFraction(double)
int getGlareDetectionNumberOfTiles ( )

Gets the value of number of tiles in glare detection.

Return the number of tiles value used in glare detection.

Returns
int
See also
setGlareDetectionNumberOfTiles(int)
boolean getLegacyBlurDetection ( )

Gets the status of legacy blur detection.

Returns
boolean
See also
setLegacyBlurDetection(boolean)
int getLegacyBlurThreshold ( )

Gets the sensibility of the blur detection algorithm.

An image section is considered blurry when its blurriness exceeds this threshold.

Threshold values should be in the [0, 100] range, other values will be clamped to this range.
Defaults to 15.
Rising this threshold increases the number of sections marked as blurry.

Detected blurry sections are used in conjunction with blurCountPercentThreshold to calculate the percentage of blurry areas and decide if the whole image should be considered blurry.

Returns
the sensibility of the blur detection algorithm
See also
getBlurCountPercentThreshold()
boolean getLowContrastBackgroundDetection ( )

Gets the status of low contrast background detection in the quick analysis process.

Returns
boolean
See also
setLowContrastBackgroundDetection(boolean)
boolean getMissingBordersDetection ( )

Gets the status of missing borders detection in the quick analysis process.

Returns
boolean
See also
setMissingBordersDetection(boolean)
boolean getSaturationDetection ( )

Gets the status of saturation detection.

Returns
boolean
See also
setSaturationDetection(boolean)
boolean getShadowDetection ( )

Gets the status of shadow detection in the quick analysis process.

Returns
boolean
See also
setShadowDetection(boolean)
boolean getSkewDetection ( )

Gets the status of skew detection in the quick analysis process.

Returns
boolean
See also
setSkewDetection(boolean)
UseDocumentDetectionBasedCrop getUseDocumentDetectionBasedCrop ( )

Gets the value of document detection based cropping.

Returns
UseDocumentDetectionBasedCrop
See also
setUseDocumentDetectionBasedCrop(UseDocumentDetectionBasedCrop)
UseMRZPassportDetection getUseMRZPassportDetection ( )

Gets the status of MRZ passport detection.

Returns
UseMRZPassportDetection
See also
setSaturationDetection(boolean)
UseTargetFrameCrop getUseTargetFrameCrop ( )

Gets the value of target frame cropping.

Returns
UseTargetFrameCrop
See also
setUseTargetFrameCrop(UseTargetFrameCrop)
void setBlurCountPercentThreshold ( int  threshold)

Sets the threshold for blurry areas.

An image is considered blurry when the amount of blurry areas exceeds this threshold.
The threshold should be specified as percentage of the image area.

Threshold values should be in the [0, 100] range, other values will be clamped to this range.
Defaults to 80.

Parameters
thresholdthe threshold for blurry areas
See also
setLegacyBlurThreshold(int)
void setBlurDetection ( boolean  enabled)

Sets the status of blur detection.

This is to enable or disable blur detection in quick analysis The default value is true.

Parameters
enabled: boolean
void setBlurThreshold ( int  threshold)

Sets the confidence threshold for the blur detection algorithm.

An image section is considered blurry when its algorithm confidence exceeds this threshold.

The threshold should be specified as percentage in the [0, 100] range, other values will be clamped to this range.
Defaults to 50.

Parameters
thresholdthe confidence threshold of the blur detection algorithm
void setGlareDetectedThreshold ( double  threshold)

Sets the threshold for the area of the glare.

An image is considered to have a glare when the area of the glare exceeds this threshold.
The threshold should be specified as a fraction of the image area.

Threshold values should be in the [0.01, 0.99] range, other values will be clamped to this range.
Defaults to 0.02.

Parameters
thresholdthe threshold for the area of the glare
void setGlareDetection ( boolean  enabled)

Sets the status of glare detection.

This is to enable or disable glare detection in quick analysis. The default value is true.

Parameters
enabled: boolean
void setGlareDetectionIntensityFraction ( double  fraction)

Sets the value of intensity fraction of glare detection.

The fraction of pixels with the highest intensity that are assumed to be glare. Valid values: 0.01-0.99 The default value is 0.03d.

Parameters
fraction: double
void setGlareDetectionIntensityThreshold ( int  threshold)

Sets the value of intensity threshold fraction of glare detection.

The absolute lower threshold for high intensity pixels. No pixel below this threshold is perceived as glare. Valid values: 0-255 The default value is 230.

Parameters
threshold: int
void setGlareDetectionMinimumGlareAreaFraction ( double  fraction)

Sets the value of minimum glare area fraction of glare detection.

The minimum area of an image that needs to be affected by glare to be included in the glare area. Valid values: 0.01-0.99 The default value is 0.01d.

Parameters
fraction: double
void setGlareDetectionNumberOfTiles ( int  tiles)

Sets the value of number of tiles of glare detection.

The number of tiles into which an edge of the image is divided for glare detection. Valid values: 1-1000 The default value is 100.

Parameters
tiles: int
void setLegacyBlurDetection ( boolean  enabled)

Sets the status of legacy blur detection.

This is to enable or disable legacy blur detection in quick analysis process, when enabled, the analysis is performed on legacy algorithm. If user enables this and wants to set a threshold of his own, user should be using {setLegacyBlurThreshold(int)}. The default value is false.

Parameters
enabled: boolean
void setLegacyBlurThreshold ( int  threshold)

Sets the sensibility of the blur detection algorithm.

An image section is considered blurry when its blurriness exceeds this threshold.

Threshold values should be in the [0, 100] range, other values will be clamped to this range.
Defaults to 15.
Rising this threshold increases the number of sections marked as blurry.

Detected blurry sections are used in conjunction with blurCountPercentThreshold to calculate the percentage of blurry areas and decide if the whole image should be considered blurry.

Parameters
thresholdthe sensibility of the blur detection algorithm
See also
setBlurCountPercentThreshold(int)
void setLowContrastBackgroundDetection ( boolean  enabled)

Enable/disable low contrast background detection in the quick analysis process.

When disabled, the QuickAnalysisFeedback will always return isLowContrastBackground as false. The default value is true (enabled).

Parameters
enabled: boolean
void setMissingBordersDetection ( boolean  enabled)

Enable/disable missing borders detection in the quick analysis process.

When disabled, the QuickAnalysisFeedback will always return isMissingBorders as false. The default value is true (enabled).

Parameters
enabled: boolean
void setSaturationDetection ( boolean  enabled)

Sets the status of saturation detection.

This is to enable or disable saturation detection in quick analysis The default value is true.

Parameters
enabled: boolean
void setShadowDetection ( boolean  enabled)

Enable/disable shadow detection in the quick analysis process.

When disabled, the QuickAnalysisFeedback will always return isShadowed as false. The default value is true (enabled).

Parameters
enabled: boolean
void setSkewDetection ( boolean  enabled)

Enable/disable skew detection in the quick analysis process.

When disabled, the QuickAnalysisFeedback will always return isOverlySkewed as false. The default value is true (enabled).

Parameters
enabled: boolean
void setUseDocumentDetectionBasedCrop ( UseDocumentDetectionBasedCrop  useDocumentDetectionBasedCrop)

Sets the value of document detection based cropping.

Specify quick analysis to use document detection based cropping or not The default value is UseDocumentDetectionBasedCrop.OFF

Parameters
useDocumentDetectionBasedCrop: UseDocumentDetectionBasedCrop
void setUseMRZPassportDetection ( UseMRZPassportDetection  useMRZPassportDetection)

Sets the value of MRZ passport detection.

Specify quick analysis to use MRZ passport detection for cropping process or not The default value is UseMRZPassportDetection.OFF

Parameters
useMRZPassportDetection: UseMRZPassportDetection
void setUseTargetFrameCrop ( UseTargetFrameCrop  useTargetFrameCrop)

Sets the value of target frame cropping.

Specify quick analysis to use target frame cropping or not The default value is UseTargetFrameCrop.OFF

Parameters
useTargetFrameCrop: UseTargetFrameCrop

The documentation for this class was generated from the following file:
Untitled Document © 2018 Kofax, Inc. All rights reserved. Use is subject to license terms.