Merge pull request #126 from BlinkID/feature/v2.14.0

Feature/v2.14.0

CHANGELOG.md

@@ -1,3 +1,18 @@
+## 2.14.0
+
+- Updates and additions
+    - added support for reading back side of new Australian Driver's licence for state Victoria - use `PPAustraliaDLBackRecognizerSettings` and `PPAustraliaDLBackRecognizerResult`
+    - added support for reading front side of Indonesian ID - use `PPIndonesianIDFrontRecognizerSettings` and `PPIndonesianIDFrontRecognizerSettings`
+    - added support for Malaysian visa with document code TS - use `PPMrtdRecognizerSettings` and `PPMrtdRecognizerResult`
+    - added support for setting DPI for full document images returned by `PPMrtdRecognizerSettings`, `PPAustraliaDLBackRecognizerSettings`, `PPAustraliaDLFrontRecognizerSettings` and `PPEudlRecognizerSettings`:
+        - use `fullDocumentImageDPI` on the corresponding recognizer settings
+
+- Minor API changes
+    - removed `imageDPI` property on `PPTemplatingRecognizerSettings`        
+
+- Improvements in ID scanning performance:
+    - improved reading of Malaysian MyKad address        
+
 ## 2.13.0
 
 - Updates and additions

MicroBlink.framework/Headers/PPAusIDBackRecognizerSettings.h

@@ -31,6 +31,34 @@ PP_CLASS_AVAILABLE_IOS(6.0)
  */
 @property (nonatomic) BOOL displayFullDocumentImage;
 
+/**
+ * Defines if issuing authority should be extracted from Austrian ID
+ *
+ * Default: YES
+ */
+@property (nonatomic, assign) BOOL extractIssuingAuthority;
+
+/**
+ * Defines if owner's name should be extracted from Austrian ID
+ *
+ * Default: YES
+ */
+@property (nonatomic, assign) BOOL extractPrincipalResidence;
+
+/**
+ * Defines ifdate of issue should be extracted from Austrian ID
+ *
+ * Default: YES
+ */
+@property (nonatomic, assign) BOOL extractDateOfIssue;
+
+/**
+ * Defines if owner's height should be extracted from Austrian ID
+ *
+ * Default: YES
+ */
+@property (nonatomic, assign) BOOL extractHeight;
+
 /**
  * Defines if glare detection should be turned on/off for front side of Austrian ID
  *

MicroBlink.framework/Headers/PPAusIDFrontRecognizerSettings.h

@@ -37,6 +37,35 @@ PP_CLASS_AVAILABLE_IOS(6.0)
  */
 + (NSString *)FULL_DOCUMENT_IMAGE;
 
+/**
+ *  Defines if sex of Austrian ID owner should be extracted
+ *
+ *  Default: YES
+ */
+@property (nonatomic, assign) BOOL extractSex;
+
+/**
+ * Defines if citizenship of Austrian ID owner should be extracted
+ *
+ * Default: YES
+ */
+@property (nonatomic, assign) BOOL extractLastName;
+
+/**
+ * Defines if date of birth of Austrian ID owner should be extracted
+ *
+ * Default: YES
+ */
+@property (nonatomic, assign) BOOL extractFirstName;
+
+
+/**
+ * Defines if date of expiry should be extracted from Austrian ID
+ *
+ * Default: YES
+ */
+@property (nonatomic, assign) BOOL extractDateOfBirth;
+
 /**
  * Sets whether face photo from ID card should be sent to didOutputMetadata method of scanDelegate object.
  * If you want to recieve this image, be sure to enable dewarpedImage in MetadataSettings.

MicroBlink.framework/Headers/PPAustraliaDLBackRecognizerResult.h

@@ -0,0 +1,41 @@
+//
+//  PPAustraliaDLBackRecognizerResult.h
+//  MicroBlinkDev
+//
+//  Created by Jura Skrlec on 30/11/2017.
+//
+
+#import "PPDetectorRecognizerResult.h"
+
+/**
+ * Class representing values obtained when scanning back side of Australian DL
+ */
+PP_CLASS_AVAILABLE_IOS(6.0)
+@interface PPAustraliaDLBackRecognizerResult : PPDetectorRecognizerResult
+
+/**
+ * The last name of the Australian DL owner.
+ */
+@property (nonatomic, readonly, nullable) NSString *lastName;
+
+/**
+ * The licence number of the Australian DL owner.
+ */
+@property (nonatomic, readonly, nullable) NSString *licenceNumber;
+
+/**
+ * The address of the Australian DL owner.
+ */
+@property (nonatomic, readonly, nullable) NSString *address;
+
+/**
+ * The document date of expiry of the Australian DL in DD.MM.yyyy format.
+ */
+@property (nonatomic, readonly, nullable) NSString *rawDocumentDateOfExpiry;
+
+/**
+ * The document date of expiry of the Australian DL
+ */
+@property (nonatomic, readonly, nullable) NSDate *documentDateOfExpiry;
+
+@end

MicroBlink.framework/Headers/PPAustraliaDLBackRecognizerSettings.h

@@ -0,0 +1,67 @@
+//
+//  PPAustraliaDLBackRecognizerSettings.h
+//  MicroBlinkDev
+//
+//  Created by Jura Skrlec on 30/11/2017.
+//
+
+#import "PPRecognizerSettings.h"
+
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * Settings class for configuring Asutralian Front DL Recognizer.
+ *
+ * Australian Back ID recognizer is used for scanning front side of Australian DL. It always extracts
+ * identity card number, first and last name of ID holder while extracting other elements is optional.
+ */
+PP_CLASS_AVAILABLE_IOS(6.0)
+@interface PPAustraliaDLBackRecognizerSettings : PPRecognizerSettings
+
+/**
+ * Name of the image sent to didOutputMetadata method of scanDelegate object that contains full document.
+ * This image will be sent to scan delegate during recognition process if displaying of full document image
+ * is enabled via displayFullDocumentImage property and receiving of dewarpedImage in MetadataSettings is enabled.
+ */
++ (NSString *)FULL_DOCUMENT_IMAGE;
+
+/**
+ *  Defines if last name of Australian DL owner should be extracted
+ *
+ *  Default: YES
+ */
+@property (nonatomic, assign) BOOL extractLastName;
+
+/**
+ *  Defines if sex of Australian DL owner should be extracted
+ *
+ *  Default: YES
+ */
+@property (nonatomic, assign) BOOL extractAddress;
+
+/**
+ * Defines if date of expiry should be extracted from Australian DL
+ *
+ * Default: YES
+ */
+@property (nonatomic, assign) BOOL extractDateOfExpiry;
+
+/**
+ * Sets whether full document image of ID card should be sent to didOutputMetadata method of scanDelegate object.
+ * If you want to recieve this image, be sure to enable dewarpedImage in MetadataSettings.
+ *
+ * Default: NO
+ */
+@property (nonatomic, assign) BOOL displayFullDocumentImage;
+
+/**
+ * Property got setting DPI for full document images
+ *
+ * Default: 250.0
+ */
+@property (nonatomic, assign) NSUInteger fullDocumentImageDPI;
+
+@end
+
+NS_ASSUME_NONNULL_END

MicroBlink.framework/Headers/PPAustraliaDLFrontRecognizerSettings.h

@@ -93,6 +93,13 @@ PP_CLASS_AVAILABLE_IOS(6.0)
  */
 @property (nonatomic, assign) BOOL displayFullDocumentImage;
 
+/**
+ * Property got setting DPI for full document images
+ *
+ * Default: 250.0
+ */
+@property (nonatomic, assign) NSUInteger fullDocumentImageDPI;
+
 @end
 
 NS_ASSUME_NONNULL_END

MicroBlink.framework/Headers/PPBlinkIDRecognizers.h

@@ -22,6 +22,8 @@
 // Australia
 #import "PPAustraliaDLFrontRecognizerSettings.h"
 #import "PPAustraliaDLFrontRecognizerResult.h"
+#import "PPAustraliaDLBackRecognizerSettings.h"
+#import "PPAustraliaDLBackRecognizerResult.h"
 
 // Croatia
 #import "PPCroIDBackRecognizerSettings.h"
@@ -74,6 +76,10 @@
 #import "PPMrtdCombinedRecognizerResult.h"
 #import "PPMrzFilter.h"
 
+// Indonesia
+#import "PPIndonesianIDFrontRecognizerSettings.h"
+#import "PPIndonesianIDFrontRecognizerResult.h"
+
 // Poland
 #import "PPPolishIDFrontRecognizerSettings.h"
 #import "PPPolishIDFrontRecognizerResult.h"

MicroBlink.framework/Headers/PPCzIDBackRecognizerSettings.h

@@ -31,6 +31,27 @@ PP_CLASS_AVAILABLE_IOS(6.0)
  */
 @property (nonatomic) BOOL displayFullDocumentImage;
 
+/**
+ * Defines if citizenship of Czech ID authority should be extracted
+ *
+ * Default: YES
+ */
+@property (nonatomic, assign) BOOL extractAuthority;
+
+/**
+ * Defines if address of Czech ID owner should be extracted
+ *
+ * Default: YES
+ */
+@property (nonatomic, assign) BOOL extractAddress;
+
+/**
+ * Defines if personal number should be extracted from Czech ID
+ *
+ * Default: YES
+ */
+@property (nonatomic, assign) BOOL extractPersonalNumber;
+
 /**
  * Defines if glare detection should be turned on/off for back side of Czech IDs.
  *

MicroBlink.framework/Headers/PPCzIDFrontRecognizerSettings.h

@@ -37,6 +37,48 @@ PP_CLASS_AVAILABLE_IOS(6.0)
  */
 + (NSString *)FULL_DOCUMENT_IMAGE;
 
+/**
+ *  Defines if sex of Czech ID owner should be extracted
+ *
+ *  Default: YES
+ */
+@property (nonatomic, assign) BOOL extractSex;
+
+/**
+ * Defines if citizenship of Czech ID owner should be extracted
+ *
+ * Default: YES
+ */
+@property (nonatomic, assign) BOOL extractLastName;
+
+/**
+ * Defines if date of birth of Czech ID owner should be extracted
+ *
+ * Default: YES
+ */
+@property (nonatomic, assign) BOOL extractFirstName;
+
+/**
+ * Defines if date of expiry should be extracted from Czech ID
+ *
+ * Default: YES
+ */
+@property (nonatomic, assign) BOOL extractDateOfExpiry;
+
+/**
+ * Defines if date of issue should be extracted from Czech ID
+ *
+ * Default: YES
+ */
+@property (nonatomic, assign) BOOL extractDateOfIssue;
+
+/**
+ * Defines if date of expiry should be extracted from Czech ID
+ *
+ * Default: YES
+ */
+@property (nonatomic, assign) BOOL extractDateOfBirth;
+
 /**
  * Sets whether face photo from ID card should be sent to didOutputMetadata method of scanDelegate object.
  * If you want to recieve this image, be sure to enable dewarpedImage in MetadataSettings.

MicroBlink.framework/Headers/PPEudlRecognizerSettings.h

@@ -89,6 +89,13 @@ PP_CLASS_AVAILABLE_IOS(6.0)
  */
 @property (nonatomic, assign) PPEudlCountry country;
 
+/**
+ * Property got setting DPI for full document images
+ *
+ * Default: 250.0
+ */
+@property (nonatomic, assign) NSUInteger fullDocumentImageDPI;
+
 @end
 
 NS_ASSUME_NONNULL_END

MicroBlink.framework/Headers/PPGermanOldIDRecognizerSettings.h

@@ -39,6 +39,13 @@ PP_CLASS_AVAILABLE_IOS(6.0)
  */
 + (NSString *)FULL_DOCUMENT_IMAGE;
 
+/**
+ * Defines if owner's place of birth should be extracted from German ID
+ *
+ * Default: YES
+ */
+@property (nonatomic, assign) BOOL extractPlaceOfBirth;
+
 /**
  * Sets whether face image from ID card should be sent to didOutputMetadata method of scanDelegate object.
  * If you want to recieve this image, be sure to enable dewarpedImage in MetadataSettings.