ALOCR Ver 1.0 リファレンスマニュアル

1. 定数と構造体
   
   1. 文字種コントロール
   2. 認識結果
   
   
2. 各論
   
   1. パターン辞書の種類
   2. パターン辞書クラスの構築
   3. ユーザ辞書管理
   4. 辞書クラス:CJocrDictリファレンス
   5. パターンクラスの構築
   6. パターンの特徴計算
   7. パターンクラス:CJocrPatternリファレンス
   8. １文字認識クラスの構築
      2000年11月06日更新 ライセンスコードに加えて、ライセンスコードファイルも指定できるようになった
   9. １文字認識
   10. １文字認識クラス:CJocrRecognizeリファレンス
   11. １行認識クラスの構築
   12. １行認識
   13. １行認識クラス:CJocrLineリファレンス
   14. 言語処理付き１行認識クラス:CJocrLangリファレンス
   15. １段落認識クラス:CJocrBlockリファレンス
       2002年07月31日更新 段落のスキューを指定できるようになった。一行のテキストに限定して、イタリック体を認識することができる。
       2005年08月31日更新 新規辞書の追加
       2005年08月31日更新 新バージョン認識メソッド。従来のものと比較して認識率が大幅アップ
       2022年11月30日更新 深層学習対応。カラー画像、グレイスケール画像認識対応。従来のものと比較して認識率が大幅アップ
       
   
   
   
3. サンプルプログラム
   
   1. VC++のサンプルプロジェクト
   
   

// パターンの外接矩形
typedef struct {
    short		x1;			// パターンの左上ｘ座標
    short		y1;			// パターンの左上ｙ座標
    short		x2;			// パターンの右下ｘ座標
    short		y2;			// パターンの右下ｙ座標
} OCRRect;
// 認識候補
typedef struct {
    char*           code;       // パターン文字列へのポインタ
    unsigned char   score;      // 確信度
    unsigned char   filler[3];  // padding
} Candidate;
//////////////////
// OCRの結果構造体
// 128バイト固定
typedef struct {
    Candidate       cand[MAX_CAND]; // 候補データMAX_CAND == 10 80 bytes
    OCRRect         area;           // OCRした領域               8 bytes
    long            fieldtype;
    unsigned long   chartype;       // 文字認識結果の文字種
    unsigned long   maskchartype1;
    unsigned long   maskchartype2;
    unsigned long   space;          // １行認識で文字の後に続くスペースの数
    unsigned char   cgravx;
    unsigned char   cgravy;
    unsigned char   morph;
    unsigned char   size;
    char            newcand[KEYSIZE_MAX];
} OCRResult;

typedef struct {
	short		x1;			// パターンの左上ｘ座標
	short		y1;			// パターンの左上ｙ座標
	short		x2;			// パターンの右下ｘ座標
	short		y2;			// パターンの右下ｙ座標
} OCRRect;

1. 基本辞書形式(２)
2. オプション辞書形式(任意の数)
3. ユーザ辞書形式(０あるいは１)

1. インスタンスの作成
2. 基本辞書名、オプション辞書名、ユーザ辞書名の設定
3. 辞書のロード

基本辞書クラスの構築のコード例

#include	"ocrdef.h"
#include	"ocrco.h"
#include	"cjocrstock.h"
#include	"cjocrdict98.h"
#include	"errcode.h"

.....

// 1...辞書クラスのインスタンス作成
  	CJocrDict* pjocrdict = new CJocrDict;
// 2...基本辞書の設定
	pjocrdict->msetsystemdict("\\dic\\feature\\system");
	pjocrdict->msetsystemdict("\\dic\\feature\\systemfat");
// 3...オプション辞書の設定
	pjocrdict->msetdiffdict("\\dic\\feature\\diff1");
	pjocrdict->msetdiffdict("\\dic\\feature\\diff2");
	pjocrdict->msetdiffdict("\\dic\\feature\\diff3");
	pjocrdict->msetdiffdict("\\dic\\feature\\diff4");
	pjocrdict->msetdiffdict("\\dic\\feature\\diff5");
// 5...ユーザ辞書の設定（オプション）
	m_pJocrDict->msetuserdict("\\dic\\feature\\userpat");
// 6...ロード
	i1 = pjocrdict->mloaddict();
	if(i1 < 0) {
		エラー(errcode.hに定義)
		FILE_OPEN_ERROR	辞書が見つからない
		FILE_READ_ERROR	辞書が読み込めない
		FILE_SEEK_ERROR	辞書のレコードにシークできない
		MEMORY_SHORTAGE	メモリ不足(これ以降の処理はしない)
		FATAL_ERROR		リカバリ不能エラー(これ以降の処理はしない)
	}

......認識、登録、削除、参照

// インスタンス削除
	delete pjocrdict;

1. シークして登録
   patternはCJocrPatternクラスのインスタンスであるとします。patternに「漢」という漢字のパターンの画像を設定して特徴計算をしてから（pattern->mcalcall(...)を呼んでから）
   

   	int i1 = pjocrdict->mput("漢",pattern);
   	if(i1 < 0) {
   		エラー;
   		FILE_SEEK_ERROR
   		FILE_WRITE_ERROR
   	}
   

2. シークして削除
   ユーザ辞書からキー"漢"に対応するレコードを消去するときは、以下のように、最初にシークしてから、削除関数をコールします。
   

   	int i1 = pjocrdict->mseek("漢");
   	if(i1 < 0) {
   		エラー;
   	}
   	if(i1 == 1) {
   		// 削除
   		i1 = pjocrdict->mdel();
   		if(i1 < 0) {
   			エラー;
   		}
   	}
   

3. 次のレコードへシークして、キーとパターンの画像を取得する。
   

   	int i1 = pjocrdict->mseeknext();
   	// keysizeは入力・出力両方に使われる変数
   	// 入力時には、読み込みバッファ最大サイズ
   	// 出力時には、実際の読み込みサイズ
   	unsigned long	keysize = KEYSIZE_MAX;
   	char			keybuffer[KEYSIZE_MAX];
   	if(i1 == 1) {
   		i1 = pjocrdict->mgetkey(keysize,keybuffer);
   		if(i1 < 0) {
   			エラー;
   		}
   		else {
   			// REG_FONT_SIZEは正規化フォントサイズ（バイト単位）である
   			// ユーザ辞書登録時にREG_FONT_SIZEに縮小・拡大されて保存される
   			// ALOCR Ver.1.0ではｎ正規化フォントは48×48画素で288バイトである
   			// REG_FONT_WIDTH....48
   			// REG_FONT_HEIGHT....48
   			// REG_FONT_SIZE....48*48/8(8ピクセル=1バイト)
   			// recordsizeは入力・出力両方に使われる変数
   			// 入力時には、読み込みバッファ最大サイズ
   			// 出力時には、実際の読み込みサイズ
   			unsigned long	recordsize  = REG_FONT_SIZE;
   			char			record[REG_FONT_SIZE];
   			i1 = mgetpattern(recordsize,record);
   			if(i1 < 0) {
   				エラー;
   			}
   			// 取得したパターンはREG_FONT_WIDTH×REG_FONT_HEIGHTピクセル
   			// のビットマップである。
   		}
   	}
   	else if(i1 == 0) {
   		次のレコードはない;
   	}
   	else {
   		エラー;
   	}
   

1. 基本辞書の設定
   
2. オプション辞書(差分辞書)の設定
   
3. ユーザ辞書の設定
   
4. 設定した辞書のロード
   
5. シーク
   
6. パターン登録キーの取得
   
7. パターン画像の取得
   
8. 登録
   
9. 削除
   
10. レコード数取得
    
11. ユーザ辞書登録数の上限変更
    

• 縦書き中での２〜３桁の数字や単位記号など
• TELや（株）のように１パターンが３文字以上になる場合
• 名刺のロゴのように１つのパターンの呼称を１文字では表せない場合

	// 1...パターンクラスのインスタンス作成
	CJocrPattern* pattern = new CJocrPattern;
	// 2...メモリ確保
	i1 = pattern->mallocmemory();
	if(i1 < 0) {エラーメッセージ表示;delete pattern;}

	.....

	delete pattern;

typedef struct {
	unsigned char* 	top;		// 画像データの先頭アドレス
	short			width;		// 画像データの幅(バイト境界、ピクセル単位)
	short			height;		// 画像データの高さ(ピクセル単位)
} OCRBuffer;
typedef struct {
	short		x1;			// パターンの左上ｘ座標
	short		y1;			// パターンの左上ｙ座標
	short		x2;			// パターンの右下ｘ座標
	short		y2;			// パターンの右下ｙ座標
} OCRRect;

1. 特徴計算
   

	// 1...認識クラスのインスタンス作成
	// ライブラリライセンサーから供給される20桁のコードを指定してインスタンスを構築します。

	// 2000年11月06日更新
	// あるいはライブラリライセンサーから供給されるライセンスコードファイルのパスを指定します。

	CJocrRecognize* precognize = new CJocrRecognize("ABCDEFGHJKLMNPQ23456");
	// ライセンスコードファイルの場合 CJocrRecognize* precognize = new CJocrRecognize("C:\\Program Files\\Foo\\jocr.kcd");
	// 2...パターン設定
	// patternをCJocrPatternクラスのインスタンスとする
	// .....patternの生成と初期化
	precognize->msetpatter(pattern);
	// 3...辞書設定
	// pjocrdictをCJocrDictクラスのインスタンスとする
	// .....pjocrdictの生成と初期化
	precognize->msetdict(pjocrdict);
	// 4...メモリ確保
	i1 = precognize->mallocmemory();
	if(i1 < 0) {
		MEMORY_SHORTAGE....メモリ不足(errcode.hに定義)
		エラーメッセージ表示;delete pattern;
	}
	....
	１文字認識処理をくり返す
	....
	delete pattern;

• CHAR_SET_ALL 全ての文字種
• CHAR_SET_ALPHABET 英字辞書
• CHAR_SET_NUMBER 数字

	pattern->mrecognize(CHAR_SET_ALL);
	// 認識結果の取得
	// OCRResultについては、リファレンスマニュアルの2-2を参照して下さい。
	OCRResult	aresult;
	mgetresult(&aresult);

1. 初期化
   
2. 認識、識別、認識結果の取得
   

	// 1...行クラスのインスタンス作成
  	CJocrLine* pjocrline = new CJocrLine;
	// 2...行クラスにパターンクラスのインスタンスを設定(patternは他で構築済み)
	//     mallocmemoryまで実行が済んでいる必要がある
	pjocrline->msetpattern(pattern);
	// 3...行クラスに認識クラスのインスタンスを設定(precognizeは他で構築済み)
	//     msetpattern,msetdict,mallocmemoryまで実行が済んでいる必要がある
	pjocrline->msetrecognize(precognize);
	// 4...ドキュメントの初期化
	// 認識対象のイメージバッファが変化するたびにコールする
	typedef struct {
		unsigned char* 	top;		// 画像データの先頭アドレス
		short			width;		// 画像データの幅(バイト境界、ピクセル単位)
		short			height;		// 画像データの高さ(ピクセル単位)
	} OCRBuffer;
	OCRBuffer aocrbuffer;
	aocrbuffer.top = ...;		// バッファアドレス
	aocrbuffer.width = ...;		// バッファ横幅(ピクセル単位、８の倍数)
	aocrbuffer.height = ...;	// バッファ縦幅（ピクセル単位）
	int i1 = pjocrline->msetdocument(&aocrbuffer);
	if(i1 < 0) {
		// MEMORY_SHORTAGE....メモリ不足
		エラーメッセージ表示;
		delete pjocrline;
	}
    pjocrline->msetdpi(400);    // 解像度400dpi
	１行認識をくり返す。認識対象のイメージバッファが変わったときに、
	msetdocumentを呼ぶ。

	delete pjocrline;

	// 行の設定
	OCRRect aocrrect;
	aocrrect.x1;		// 行の外接矩形の左上Ｘ座標
	aocrrect.y1;		// 行の外接矩形の左上Ｙ座標
	aocrrect.x2;		// 行の外接矩形の右下Ｘ座標
	aocrrect.y2;		// 行の外接矩形の右下Ｙ座標
#if 横書き
	msetlineuser(&aocrrect,HORIZONTAL_LINE);	// 横書き
#else
	msetlineuser(&aocrrect,VERTICAL_LINE);		// 縦書き
#endif
	// １行認識
	i1 = pjocrline->mrecognize(CHAR_SET_ALL);
	if(i1 < 0) {エラーメッセージ表示;}
	else {
		int			resultnum;
		OCRResult	pocrresult[resultnum];
		// 結果の取得
		i1 = pjocrline->mgetresult(resultnum,pocrresult);
		if(i1 < 0) {エラーメッセージ表示;}
	}

1. 初期化
   
2. ドキュメントの設定
   
3. 行の設定、行認識、認識結果の取得
   

1. 初期化
   

1. 初期化
   
2. ドキュメントの設定
   段落のスキューを指定できるようになった。一行のテキストに限定して、イタリック体を認識することができる。
   
3. 段落の設定、正規化画像の作成と取得
   
4. 段落認識、認識結果の取得
   
5. 新バージョン認識メソッド
   
6. 深層学習対応認識メソッド