Introduction

Overview

본 문서는 SELVAS AI의 수식 인식 솔루션인 Selvy Pen SDK for Math의 API 가이드입니다.
Selvy Pen SDK for Math는 손글씨로 수식을 입력하면 손글씨를 LaTeX으로 변환해 주는 솔루션입니다.
표준 C언어 기반의 라이브러리로써 Android, iOS, Tizen, Windows, Linux 등의 플랫폼을 지원하며, 그 외 플랫폼 및 Non-OS는 커스터마이징을 통해 지원이 가능합니다.

Specification

수학식

• 중등 수학과정을 지원하는 87개 수식 심볼을 인식할 수 있습니다.

• 분수, 루트, 제곱 등 7개의 수식 구조를 인식할 수 있습니다.

	룰	구조	예시
1	Horizontal pair		\(2x\)
2	Fence		\((1024+512)\)
3	Fraction		\(\dfrac{2x+4}{5y-2}\)
4	Square root		\(\sqrt{144} + \sqrt{1728}\)
5	Subscript		\(x_i\)
6	Superscript		\(x^2\)
7	Overscript		\(\overline{AB}\)

화학식

• 중등 과학과정을 지원하는 60개 심볼을 인식할 수 있습니다.

• 5개의 화학식 구조를 인식할 수 있습니다.

	룰	구조	예시
1	Horizontal pair		\(Cl\)
2	Fence		\((OH)\)
3	Subscript		\(Al_{2}\)
4	Superscript		\(Ca^{2+}\)
5	Subsuperscript		\(SO_{4}^{2-}\)

Prerequisite

Touch Event

필기 입력 구현을 위해서는 다음과 같은 터치 이벤트 사양이 요구됩니다.

• Touch Down : 펜을 터치 디바이스상에 처음 대는 순간 발생하는 이벤트
• Touch Move : 펜을 터치 디바이스에서 떼지 않은 상태로 있을 경우 발생하는 이벤트
• Touch Up : 펜을 터치 디바이스 상에서 떼는 순간 발생하는 이벤트
  Touch Down이 발생한 경우라면 항상 Touch Up이 발생하여야 합니다. 즉, 사용자가 필기 도중 터치 패드 영역을 벗어난 경우에도 드라이버에서는 Touch Up 이벤트를 발생시켜야 합니다.

Sampling Rate

'Sampling Rate’란 터치 디바이스에서 터치 이벤트를 체크하는 시간(or 양)을 말합니다.
필기 입력기 적용을 위해서는 보통 10~40ms(초당 25~100개의 터치 이벤트) 정도로 조정합니다.
유의할 점은 Sampling Rate가 40ms를 넘게 되면 필기한 모양이 자연스럽지 못하고 인식률도 떨어지게 됩니다. 대개의 경우 10~20ms를 권장합니다.

Delay time

인식 대기 시간은 필기 입력이 끝났다고 판단하는데 걸리는 시간입니다.
즉, 터치 디바이스에서 펜을 뗀 후 일정 시간 동안 필기 입력이 없으면, 사용자의 입력이 끝났다고 판단하고 인식 엔진을 호출하게 됩니다.
인식 대기 시간은 설정 메뉴를 통해 사용자가 적당한 값을 선택하도록 할 수도 있으며, 일반적으로 300~500ms의 값을 사용합니다.
물론, 인식 대기 시간을 활용하지 않고 버튼을 사용하여 시간에 관계없이 버튼을 클릭하면 바로 인식 엔진을 호출하도록 구현할 수도 있습니다.

Porting

Selvy Pen SDK for Math를 사용하기 위해 필요한 파일은 다음과 같습니다.

• hdb/와 license_key/license.key는 플랫폼과 개발언어 상관없이 공통적으로 사용되는 파일입니다.
• 그 외의 파일들은 플랫폼과 개발언어에 따라 파일 구성과 파일명이 다를 수 있습니다.

• C/C++
• C#
• Java

Selvy Pen SDK for Math - Windows/
│
├── hdb/
│   ├── ma_CF.hdb
│   └── ma_EX.hdb
│
├── include/
│   ├── dhwr.h
│   ├── dhwr_define.h
│   ├── dhwr_gesture.h
│   ├── dhwr_ink.h
│   ├── dhwr_result.h
│   └── dhwr_setting.h
│
├── libs/
│   ├── win32_x86/
│   │   ├── libspmath.dll
│   │   └── libspmath.lib
│   │
│   └── win32_x86_64/
│       ├── libspmath.dll
│       └── libspmath.lib
│
└── license_key/
    └── license.key

Selvy Pen SDK for Math - Windows/
│
├── hdb/
│   ├── ma_CF.hdb
│   └── ma_EX.hdb
│
├── src/
│   └── Hwr.cs
│
├── libs/
│   ├── win32_x86/
│   │   ├── libspmath.dll
│   │   └── libspmath.lib
│   │
│   └── win32_x86_64/
│       ├── libspmath.dll
│       └── libspmath.lib
│
└── license_key/
    └── license.key

Selvy Pen SDK for Math - Android/
│
├── hdb/
│   ├── ma_CF.hdb
│   └── ma_EX.hdb
│
├── src/
│   └── com/
│       └── selvy/
│           └── spmath/
│               └── DHWR.java
│
├── libs/
│   ├── android_armeabi-v7a/
│   │   ├── libspmath-base.so
│   │   ├── libspmath-core.so
│   │   ├── libspmath.so
│   │   └── libstlport_shared.so
│   │
│   └── android_arm64-v8a/
│       ├── libspmath-base.so
│       ├── libspmath-core.so
│       ├── libspmath.so
│       └── libstlport_shared.so
│
└── license_key/
    └── license.key