Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

@spoonconsulting/cordova-plugin-genius-scan

Package Overview
Dependencies
Maintainers
2
Versions
5
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@spoonconsulting/cordova-plugin-genius-scan

Cordova Plugin for Genius Scan SDK

  • 3.0.1
  • unpublished
  • latest
  • npm
  • Socket score

Version published
Weekly downloads
0
Maintainers
2
Weekly downloads
 
Created
Source

Genius Scan SDK Cordova plugin

Description

This Cordova plugin allows you to access the Genius Scan SDK core features from a Cordova application:

  • Automatic document detection
  • Document perspective correction
  • Image enhancement with 4 different modes (Grayscale, Color, Black & white, Photo)

Licence

This plugin is based on the Genius Scan SDK for which you need to setup a licence. You can aleady try the "demo" version for free by not setting a licence key, the only limitation being that the app will exit after 60 seconds.

To buy a licence or for any question regarding the SDK, please contact us at sdk@thegrizzlylabs.com!

Demo application

As an example, you can check our demo application

Requirements

This plugin requires cordova-cli above 7.0.0: see this page for upgrading if you have an older version.

Platform-specific requirements

  • iOS: cordova-ios above 4.3.0 Nothing to do on a new project; use cordova platform update ios --save within your existing cordova project to upgrade it.
  • Android: cordova-android at least 6.x.x

Note for Xcode 10 users: Cordova-ios is not fully compatible with Xcode 10 yet, you may need to use cordova run ios --buildFlag="-UseModernBuildSystem=0" command to build the project properly

Upgrade from an older version

If you are using an older plugin version, you will first need to remove the plugin from your cordova project:

cordova plugin remove @thegrizzlylabs/cordova-plugin-genius-scan

Then you can install the new version following the instructions below.

Installation

You can install the plugin with Cordova CLI, plugman, or using the config.yml file.

Note for Phonegap, Ionic and other cordova-based tools:

You can usually run cordova commands from the phonegap/ionic cli.

  • ionic cordova prepare
  • ionic cordova plugin add ....
  • phonegap cordova prepare (or, shorter phonegap prepare)
  • ...

With Cordova CLI

From your Cordova project folder, install the plugin with the following command:

cordova plugin add @thegrizzlylabs/cordova-plugin-genius-scan

With config.yml

Add the following lines to your project's config.yml file:

<plugin name="@thegrizzlylabs/cordova-plugin-genius-scan" spec="~2.3.0"/>

And run cordova prepare.

With plugman

From your Cordova project folder, you can also use plugman to install the plugin only for a specific platform.

plugman install --platform ios --project ./platforms/ios --plugin @thegrizzlylabs/cordova-plugin-genius-scan

Usage

Once the deviceReady Cordova event has been fired, the following method will be available:

Set the licence key

cordova.plugins.GeniusScan.setLicenceKey(licenceKey, onSuccess, onFail)

Initialize the SDK with a valid licence key. Note that, for testing purpose, you can also use the plugin without a licence key, but it will only work for 60 seconds.

ParamTypeDescription
licenceKeyStringGenius scan licence key for your application id
onSuccessFunctionSuccess callback function, called when key is valid
onFailFunctionError callback

Scan an existing image

cordova.plugins.GeniusScan.scanImage(imageFileUri, onSuccess, onFail, scanOptions)
ParamTypeDescription
imageFileUriStringfile URI to the original JPEG file to be transformed with the plugin (Note: it won't be overriden by the plugin)
onSuccess(fileUri)FunctionCallback function, called with the file URI of the processed JPEG output
onFailFunctionError callback
scanOptionsObjectScan Options

Scan a picture from the camera

cordova.plugins.GeniusScan.scanCamera(onSuccess, onFail, scanOptions)
ParamTypeDescription
onSuccess(fileUri)FunctionCallback function, called with the file URI of the processed JPEG output
onFailFunctionError callback
scanOptionsObjectScan Options

Generate a pdf from images

cordova.plugins.GeniusScan.generatePDF(imageFileUris, onSuccess, onFail, pdfOptions)
ParamTypeDescription
imageFileUrisArrayArray of URIs to JPEG files that will be converted, in the given order, into a pdf
onSuccess(fileUri)FunctionCallback function, called with the file URI of the resulting PDF
onFailFunctionError callback
pdfOptionsObjectOptions for pdf generation
pdfOptions.passwordStringPassword to protect the pdf

Scan options

scanOptions can be used to customize the scanning interface:

ParamTypeDescription
scanOptions.defaultEnhancementStringForce a specific image enhancement by default. Accepted values: cordova.plugins.GeniusScan.ENHANCEMENT_NONE, cordova.plugins.GeniusScan.ENHANCEMENT_BW, cordova.plugins.GeniusScan.ENHANCEMENT_COLOR, cordova.plugins.GeniusScan.ENHANCEMENT_PHOTO

Error callback

In case of failure, error callback function is called with an error message as a string

Usage with Ionic

You can use this plugin with any Cordova-based framework, for example Ionic. The way to detect that the device is ready is slightly different, but after that you also access the plugin with cordova.plugins.GeniusScan.scanImage(imageFileUri, onSuccess, onFail)

In the controller where you need the plugin, you will have to import Platform and pass it to the constructor, and also declare the cordova variable so that TypeScript recognizes it.

import { Platform } from 'ionic-angular';

declare var cordova:any;

export class HomePage {
  constructor(private platform: Platform) {
    platform.ready().then(() => {
      // platform.ready is the equivalent of the deviceReady event described above
      // the plugin method is now available:
      cordova.plugins.GeniusScan.scanCamera(...)
    });
  }

}

FAQ

What if I get a validation error from App Store Connect?

You must remove the x86_64 and i386 slices before submitting your application to the App Store. They are only used for the iOS smiulator and iTunes rejects any binary that contains non-ARM slices.

They can stripped out with a script like this one.

What should I do if my license is invalid?

Make sure you have an ongoing contract with us. Contact us at sdk@thegrizzlylabs.com for any information.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[2.4.2] - 2019-02-27

Changed

  • Compatibility with android-cordova >= v7.0.0

Added

  • ENHANCEMENT_NONE default enhancement option
  • Cancel button on iOS camera screen
  • Auto trigger in Android

[2.4.1] - 2018-12-05

Changed

  • Fix README

[2.4.0] - 2018-12-05

Added

  • PDF generation with generatePDF
  • Selecting an enhancement type by default with defaultEnhancement option

Changed

  • Fix crash on ipad when clicking "Edit" button
  • Fix error with too long activity result code

Keywords

FAQs

Package last updated on 03 Mar 2021

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc