Quick Analysis Results Feedback Class. More...
#import <kfxKEDQuickAnalysisFeedback.h>
Instance Methods | |
| (id) | - init |
| Initialize the class instance. More... | |
Class Methods | |
| (kfxKEDQuickAnalysisFeedback *) | + createQuickFromMetadata: |
| Parse image metadata, create, and instantiate Quick Analysis Feedback Object. More... | |
Properties | |
| UIImage * | quickReviewUIImage |
| Quick review image. More... | |
| bool | isBlurry |
| Image may be blurry. More... | |
| bool | isOverSaturated |
| Image may be overly lit image. More... | |
| bool | isUnderSaturated |
| Image may be poorly lit image. More... | |
| bool | isGlareDetected |
| Image may have glare. More... | |
| bool | isOverlySkewed |
| Image may be overly skewed. More... | |
| bool | isShadowed |
| Image may have shadows. More... | |
| bool | isMissingBorders |
| Image may be missing borders. More... | |
| bool | isLowContrastBackground |
| Image may have uneven or low contrast background. More... | |
| kfxKEDBoundingTetragon * | tetragonCorners |
| Tetragon corner data for the sheet edges found automatically. More... | |
Detailed Description
Quick Analysis Results Feedback Class.
Framework: libKfxEngines
Import suggestion: #import <kfxLibEngines/kfxEngines.h>
An instance of this class contains the result of an image quick analysis so that you can confirm if the app user took a good picture. If the image is blurry, over or under saturated, you should prompt your app user to retake the image of the target sheet. If it is not blurry and does not have any saturation issues, then the tetragon corners indicate the sheet boundary found in the input image.
Serialization**
This class adopts the NSCoding protocol so that this object may be archived and unarchived using the iOS standard [NSKeyedArchiver archiveRootObject:<object> toFile: archiveFileName]; approach. Using keyed archive files, you can save this object for later use. The library supports backward compatibility, such that as a new version of an app that uses the API in this SDK, includes a newer versions of the SDK libraries that have data model changes, the older archive can still be read by the newer version. However, it is not a design goal to archive and dearchive with forward compatibility, such as decoding an archive on a newer version of the class, using an older library.
Refer to the kfxKEDImage class description, by expanding the class description, that describes how to archive and unarchive objects in this framework that adopt the NSCoding protocol.
You can create keyed archives using NSKeyedArchiver objects and decoded by NSKeyedUnarchiver objects. The framework design uses keyed archives, which differ from sequential archives, in that every value encoded in a keyed archive is given a Kofax unique key name. When you decode an archive, the underlying implementation can use values by name, allowing the unarchive delegate to request values in any order or not at all.
Please refer to the Apple documentation for more information: https://developer.apple.com/library/ios/documentation/cocoa/reference/foundation/Classes/NSCoder_Class/Reference/NSCoder.html
Keyed Archiving* https://developer.apple.com/library/mac/documentation/Cocoa/Reference/Foundation/Classes/NSKeyedArchiver_Class/Reference/Reference.html#//apple_ref/occ/cl/NSKeyedArchiver
Keyed Unarchiving* https://developer.apple.com/library/mac/documentation/Cocoa/Reference/Foundation/Classes/NSKeyedUnarchiver_Class/Reference/Reference.html#//apple_ref/occ/instm/NSKeyedUnarchiver
Method Documentation
◆ createQuickFromMetadata:()
| + (kfxKEDQuickAnalysisFeedback *) createQuickFromMetadata: | (NSString *) | metadata |
Parse image metadata, create, and instantiate Quick Analysis Feedback Object.
Given an NSString containing the Quick Analysis metadata, this class method parses the data. It then creates the Quick Analysis Feeback object and initializes the object properties with the parsed image information from the metadata.
◆ init()
| - (id) init |
Initialize the class instance.
Use this method in your typical [[class alloc] init]; code lines to initialize an instance of this class with the standard defaults.
Property Documentation
◆ isBlurry
|
readwriteatomic |
Image may be blurry.
The image processor sets this to true if the input image may be blurry. Default: false;
◆ isGlareDetected
|
readwriteatomic |
Image may have glare.
The image processor sets this to true if the input image have been detected with glare. Default: false;
◆ isLowContrastBackground
|
readwriteatomic |
Image may have uneven or low contrast background.
The image processor sets this to true if the input image may have uneven or low contrast background.
Default: false;
◆ isMissingBorders
|
readwriteatomic |
Image may be missing borders.
The image processor sets this to true if the input image may be missing borders. Default: false;
◆ isOverlySkewed
|
readwriteatomic |
Image may be overly skewed.
The image processor sets this to true if the input image may be overly skewed. Default: false;
◆ isOverSaturated
|
readwriteatomic |
Image may be overly lit image.
The likely cause is that the flash is on, or an extremely bright light sits directly above the location where the image was taken. A dirty lens can also cause some of the same "washout" Default: false;
◆ isShadowed
|
readwriteatomic |
Image may have shadows.
The image processor sets this to true if the input image may have shadows. Default: false;
◆ isUnderSaturated
|
readwriteatomic |
Image may be poorly lit image.
The image processor sets this to true if it detects that the input image may be poorly lit. The likely cause is that the image was taken in a dark room. Default: false;
◆ quickReviewUIImage
|
readwriteatomicretain |
Quick review image.
The image processor generates this native image object if the quick analysis completed without error. This image includes a green border surrounding what the libary thinks constitutes the boundary of the target sheet of interest in the larger image.
Your app could obtain this image, and display it for review in order to confirm that the image is correct for further use. Default: nil
◆ tetragonCorners
|
readwriteatomicretain |
Tetragon corner data for the sheet edges found automatically.
The image processor indicates the corners of the sheet found in the input image, if a valid sheet was detected. You can then edit and crop the same image with these coordinates using a basic settings profile initialized with these same coordinates. Default: an initialized object.
The documentation for this class was generated from the following file: