BLINKINPUT ELEMENT =================

ELEMENT DESCRIPTION
--------------------------------
BLINKINPUT integrates Microblink BlinkInput, AI-powered software for lighting-fast Input scanning. BlinkId runs directly on your user’s phone or your own servers, without the need for an internet connection.
It captures high-resolution images of cropped documents and scan custom data such as various Barcodes, QR Codes, VINs and top-up numbers on SIMs.

STEP-BY-STEP SETUP
--------------------------------
 0) Register a MICROBLINK account: https://microblink.com/login

 1) Get a licence key from MICROBLINK for BLINKINPUT, on IN-BROWSER platform: https://developer.microblink.com/license

 2) Enter your BLINKINPUT LICENSE KEY in the Plugin Settings, field BLINKINPUTLICENSEKEY, optionally, enter this CSS customisation in the Plugin Settings, field CUSTOM CSS (HEADERS):
   /* Global font family */
   --mb-font-family: inherit;

   /* Component (UI with buttons) */
   --mb-component-background: #FFF;
   --mb-component-font-color: #000;
   --mb-component-font-size:  14px;
   --mb-component-font-style: normal;
   --mb-component-font-weight: 400;
   --mb-component-letter-spacing: normal;
   --mb-component-line-height: 20px;
   --mb-component-text-transform: none;
   --mb-component-border-color: rgba(120, 120, 128, 0.2);
   --mb-component-border-radius: 5px;
   --mb-component-border-style: solid;
   --mb-component-border-width: 1px;
   --mb-component-box-shadow: none;
   --mb-component-button-background:        #FFF;
   --mb-component-button-border-color:         rgba(120, 120, 128, 0.2);
   --mb-component-button-border-color-disabled: rgba(116, 116, 128, 0.08);
   --mb-component-button-border-radius: 20px;
   --mb-component-button-border-style: solid;
   --mb-component-button-border-width: 1px;
   --mb-component-button-box-shadow: 0px 1px 4px rgba(0, 0, 0, 0.1);
   --mb-component-button-box-shadow-disabled: none;

   /* User feedback (messages below buttons) */
   --mb-feedback-font-color-error: #FF2D55;
   --mb-feedback-font-color-info: rgba(60, 60, 67, 0.7);
   --mb-feedback-font-size: 12px;
   --mb-feedback-font-style: normal;
   --mb-feedback-font-weight: 400;
   --mb-feedback-letter-spacing: normal;
   --mb-feedback-line-height: 16px;
   --mb-feedback-text-transform: none;

   /* Overlays */
   --mb-overlay-draganddrop-background: rgba(72, 178, 232, 0.25);
   --mb-overlay-draganddrop-background-error: rgba(255, 45, 85, 0.25);
   --mb-overlay-draganddrop-border-color-error: #FF2D55;
   --mb-overlay-draganddrop-border-style-error: dashed;

 3) Drap and drop up the visual element BLINKINPUT in your app, containing the scanning engine.

 4) Select the BLINKINPUT element, in APPEARANCE section, configure the following fields
 
 FIELDS :
 - ACTION MESSAGE : Default text message shown to the user prior to scanning.
 - RTL : Right to left (RTL) Support.
 - RESULT DATA TYPE : Must always be set to Result (BlinkCard).
 - SCAN FROM IMAGE : Enable Scan from Image.
 - SCAN INVERSE (GLOBAL) : Enables scanning of barcodes with inverse intensity values (e.g. white barcode on black background).
 - DEEP SCAN (GLOBAL) : Enable slower, but more thorough scanning, thus giving the higher possibility of successful scan.
   NOTE: this option has no effect on PDF417 barcode scanning.
 - SCAN PDF417 : Should PDF417 2D barcode be scanned.
 - NULL QUIET ZONE : Allow scanning PDF417 barcodes which don't have quiet zone surrounding it (e.g. text concatenated with barcode). This option can significantly increase recognition time.
 - UNCERTAIN DECODING : Enable decoding of non-standard PDF417 barcodes, but without guarantee that all data will be read.
   This option should be enabled for PDF417 barcode that has missing rows (i.e. not whole barcode is printed).
 - SCAN AZTEC : Should Aztec 2D barcode be scanned.
 - SCAN DATAMATRIX : Should DataMatrix 2D barcode be scanned.
 - SCAN EAN8 : Should EAN8 barcode be scanned.
 - SCAN EAN13 : Should EAN13 barcode be scanned.
 - SCAN CODE39 : Should Code39 barcode be scanned.
 - CODE39 FULL ASCII : Enable reading code39 barcode contents as extended data.
   For more information about code39 extended data (a.k.a. full ASCII mode), see https://en.wikipedia.org/wiki/Code_39#Full_ASCII_Code_39
 - SCAN CODE128 : Should Code128 barcode be scanned.
 - USE AUTO SCALE : Allow enabling the autodetection of image scale when scanning barcodes.
   If set to true, prior reading barcode, image scale will be corrected.
   This enabled correct reading of barcodes on high-resolution images but slows down the recognition process.
 - SCAN ITF : Should ITF barcode be scanned.
 - SCAN QR CODE : Should QR code be scanned.
 - SCAN UPCA : Should UPCA barcode be scanned.
 - SCAN UPCE : Should UPCE barcode be scanned.


 5) Integrate the logic into your application using the following BLINKINPUT events, states and actions:

 EVENTS :
 If you intend to trigger an action depending on the scan events, use any of the following Workflow Start:
 - READY : Event which is emitted when UI component is successfully initialized and ready for use.
 - SCAN SUCCESS : Event which is emitted after successful scan.
 - CAMERA SCAN STARTED : Event which is emitted when camera scan is started, i.e. when user clicks on scan from camera button.
 - IMAGE SCAN STARTED : Event which is emitted when image scan is started, i.e. when user clicks on Scan from gallery button.
 - SCAN ABORTED : Event which is emitted when scan is aborted, i.e. when user clicks on close from the gallery toolbar, or presses escape key.
 - SCAN ERROR : Event which is emitted during or immediately after scan error.
 - FEEDBACK : Event which is emitted during positive or negative user feedback scanning, for example partially hidden Barcode or successful scanning for example.
 - FATAL ERROR : Event which is emitted during initialization of UI component.

 EXPOSED STATES:
 Use any element able to show/process the data of interest (such as a Group with a Text field) stored within the result of the following states of the BLINKINPUT element :
   - RESULT : Result of the scan, containing individually selectable information detected from the Barcodes scan.
   - ERROR CODE : BLINKINPUT Technical Error code.
   - ERROR FATAL : BLINKINPUT Technical Fatal error short description.
   - ERROR MESSAGE : BLINKINPUT Technical Fatal error message.
   - FEEDBACK CODE : BLINKINPUT feedback code, preventing scanning.
   - FEEDBACK MESSAGE : BLINKINPUT feedback message, preventing scanning.
   - FEEDBACK STATE : BLINKINPUT feedback state, indicating whether the event preventing the scan has been cleared or not.
   - RAW RESULT : BLINKINPUT feedback state, indicating whether the event preventing the scan has been cleared or not.

 ELEMENT ACTIONS - TRIGGERED IN WORKFLOW:
   - RESET : Reset the BLINKINPUT element to its original state and attributes.    

IMPLEMENTATION EXAMPLE
======================
Feel free to browse the app editor in the Service URL for an implementation example.

ADDITIONAL INFORMATION
======================
Supported file formats: PNG, JPEG

TROUBLESHOOTING
================
Any plugin related error will be posted to the Console of the browser.

PERFORMANCE CONSIDERATIONS
===========================
N/A

QUESTIONS ?
===========
Contact us at [email protected] for any additional feature you would require or support question