Classes

The AnalysisViewController provides a custom analysis screen which shows the upload and analysis activity. The user should have the option of canceling the process by navigating back to the review screen.

Undocumented

Undocumented

Errors thrown when running a custom validation.

Undocumented

Undocumented

Undocumented

Undocumented

Undocumented

A Gini Vision document made from a QR code.

The Gini Vision Library supports the following QR code formats:

• Bezahlcode (http://www.bezahlcode.de).
• Stuzza (AT) and GiroCode (DE) (https://www.europeanpaymentscouncil.eu/document-library/guidance-documents/quick-response-code-guidelines-enable-data-capture-initiation).
• EPS E-Payment (https://eservice.stuzza.at/de/eps-ueberweisung-dokumentation/category/5-dokumentation.html).

Convenience class to interact with the Gini Vision Library.

The Gini Vision Library provides views for capturing, reviewing and analysing documents.

By integrating this library in your application you can allow your users to easily take a picture of a document, review it and - by implementing the necessary callbacks - upload the document for analysis to the Gini API.

The Gini Vision Library can be integrated in two ways, either by using the Screen API or the Component API. The Screen API provides a fully pre-configured navigation controller for easy integration, while the Component API provides single view controllers for advanced integration with more freedom for customization.

The GiniVisionDocumentBuilder provides a way to build a GiniVisionDocument from a Data object and a DocumentSource. Additionally the DocumentImportMethod can bet set after builder iniatilization. This is an example of how a GiniVisionDocument should be built when it has been imported with the Open with feature.

let documentBuilder = GiniVisionDocumentBuilder(data: data, documentSource: .appName(name: sourceApplication))
documentBuilder.importMethod = .openWith
let document = documentBuilder.build()
do {
try document?.validate()
...
} catch {
...
}

Undocumented

The HelpMenuViewController provides explanations on how to take better pictures, how to use the Open with feature and which formats are supported by the Gini Vision Library.

The ImageAnalysisNoResultsViewController provides a custom no results screen which shows some capture suggestions when there is no results when analysing an image.

Undocumented

Custom view to easily create onboarding pages which can then be used in OnboardingViewController. Simply pass an image and a name. Both will be beautifully aligned and displayed to the user.

The OnboardingViewController provides a custom onboarding screen which presents some introductory screens to the user on how to get the camera in a perfect position etc. By default, three screens are pre-configured.

To allow displaying the onboarding as a transparent modal view, set the modalPresentationStyle of the container class to .OverCurrentContext. Add a blank page at the end to make it possible to “swipe away” the onboarding. To achieve this, the container class needs to implement UIScrollViewDelegate and dismiss the view when the last (empty) page is reached. With the UIScrollViewDelegate callbacks it is also possible to add a custom page control and update the current page accordingly.

Use the OnboardingPage class to quickly create custom onboarding pages in a nice consistent design. See below how easy it is to present an custom onboarding view controller.

let pages = [
    OnboardingPage(image: myOnboardingImage1, text: "My Onboarding Page 1"),
    OnboardingPage(image: myOnboardingImage2, text: "My Onboarding Page 2"),
    OnboardingPage(image: myOnboardingImage3, text: "My Onboarding Page 3")
    OnboardingPage(image: myOnboardingImage4, text: "My Onboarding Page 4")
]
let onboardingController = OnboardingViewController(pages: pages, scrollViewDelegate: self)
presentViewController(onboardingController, animated: true, completion: nil)

The ReviewViewController provides a custom review screen. The user has the option to check for blurriness and document orientation. If the result is not satisfying, the user can either return to the camera screen or rotate the photo by steps of 90 degrees. The photo should be uploaded to Gini’s backend immediately after having been taken as it is safe to assume that in most cases the photo is good enough to be processed further.