iinkJS

> The fastest way to integrate rich handwriting features in your webapp.

iinkJS is a JavaScript library that can be used in every web application to bring handwriting recognition.

It integrates all you need:

• Signal capture for all devices,
• Digital ink rendering,
• Link to MyScript Cloud to bring handwriting recognition.

Table of contents

• Examples
• Features
• Requirements
• Installation
• Usage
• Documentation
• Development
• Support
• Feedback
• Contributing

Examples

Discover Interactive Ink with iinkJS and its major features with our text demo and tutorial.

Try our two basic examples featuring the text recognition and the math recognition.

All our examples with the source codes in this directory.

We also provide examples of integration with the major JavaScript frameworks:

Framework	Link
	Example of React integration
	Example of Angular integration
	Example of Vue integration

Features

• Text and Math support,
• Easy to integrate,
• Digital ink capture and rendering,
• Rich editing gestures,
• Import and export content,
• Styling,
• Typeset support,
• More than 200 mathematical symbols supported,
• 65 supported languages.

You can discover all the features on our Developer website for Text and Math.

Requirements

1. Have npm, yarn.
2. Have a MyScript developer account. You can create one here.
3. Get your keys and the free monthly quota to access MyScript Cloud at developer.myscript.com

Installation

iinkJS can be installed with the well known package managers npm, yarn.

If you want to use npm or yarn you first have to init a project (or use an existing one).

npm init
OR
yarn init 

You can then install iinkJS and use it as showed in the Usage section.

npm install iink-js
OR
yarn add iink-js

Usage

1. Create an index.html file in the same directory.

2. Add the following lines in the head section of your file to use iinkJS and the css. We use PEP to ensure better browsers compatibilities. Note that you can also use it using dependencies from node_modules:

3. Still in the head section, add a style and specify the height and the width of your editor:

<style>
    #editor {
        width: 100%;
        height: 100%;
    }
</style>

4. In the body tag, create a div tag that will contain the editing area:

    <div id="editor"></div>

5. In JavaScript and within a `

    <style>
        #editor {
            width: 100%;
            height: 100%;
        }
    </style>
   
   
    <div id="editor"></div>
   

7. Open `index.html` in your browser or serve your folder content using any web server.

You can find this guide, and a more complete example on the [MyScript Developer website](https://developer.myscript.com/docs/interactive-ink/latest/web/iinkjs/).

## Documentation

You can find a complete documentation with the following sections on our Developer website:

* **Get Started**: [how to use iinkJS with a full example](https://developer.myscript.com/docs/interactive-ink/latest/web/iinkjs/get-started/),
* **Editing**: [how to interact with content](https://developer.myscript.com/docs/interactive-ink/latest/web/iinkjs/editing/),
* **Conversion**: [how to convert your handwritten content](https://developer.myscript.com/docs/interactive-ink/latest/web/iinkjs/conversion/),
* **Import and Export**: [how to import and export your content](https://developer.myscript.com/docs/interactive-ink/latest/web/iinkjs/import-and-export/),
* **Styling**: [how to style content](https://developer.myscript.com/docs/interactive-ink/latest/web/iinkjs/styling/).

As well as a global [Configuration page](https://developer.myscript.com/docs/interactive-ink/latest/reference/web/configuration/).

We also provide a complete [API Reference](https://myscript.github.io/iinkJS/docs/).

## Development

Instructions to help you build the project and develop are available in the [SETUP.md](https://github.com/MyScript/iinkJS/blob/master/SETUP.md) file.


## Getting support

You can get support and ask your questions on the [dedicated section](https://developer-support.myscript.com/support/discussions/forums/16000096760) of MyScript Developer website.

## Sharing your feedback ?

Made a cool app with iinkJS? We would love to hear about you!
We’re planning to showcase apps using it so let us know by sending a quick mail to [myapp@myscript.com](mailto://myapp@myscript.com).

## Contributing

We welcome your contributions: if you would like to extend iinkJS for your needs, feel free to fork it! 

Please take a look at our [contributing](https://github.com/MyScript/iinkJS/blob/master/CONTRIBUTING.md) guidelines before submitting your pull request.

## License
This library is licensed under the [Apache 2.0](https://opensource.org/licenses/Apache-2.0).