code_app/modules/imgproc/HGOCR.h

#ifndef __HGOCR_H__
#define __HGOCR_H__

#include "../base/HGDef.h"
#include "../base/HGBaseErr.h"
#include "HGImgProcErr.h"
#include "../base/HGImage.h"

HG_DECLARE_HANDLE(HGOCRMgr);
HG_DECLARE_HANDLE(HGOCRRet);

/* algo */
#define HGIMGPROC_OCRALGO_DEFAULT		0L
#define HGIMGPROC_OCRALGO_HANVON		1L
#define HGIMGPROC_OCRALGO_TESSERACT		2L

/* RTF */
#define HGIMGPROC_OCROUTTYPE_RTF		1L
/* XLS */
#define HGIMGPROC_OCROUTTYPE_XLS		2L
/* TXT */
#define HGIMGPROC_OCROUTTYPE_TXT		3L
/* PDF */
#define HGIMGPROC_OCROUTTYPE_PDF		4L
/* OFD */
#define HGIMGPROC_OCROUTTYPE_OFD		5L

/* 未旋转 */
#define HGIMGPROC_OCRTEXTDIRECT_ORI		1L
/* 顺时针旋转了90度 */
#define HGIMGPROC_OCRTEXTDIRECT_RIGHT	2L
/* 逆时针旋转了90度 */
#define HGIMGPROC_OCRTEXTDIRECT_LEFT	3L
/* 旋转了180度 */
#define HGIMGPROC_OCRTEXTDIRECT_180		4L

/* 多页OCR进度
*/
typedef HGInt (HGAPI *HGImageListOcrFunc)(HGUInt total, HGUInt now, HGPointer param);

/* 初始化OCR模块
*/
HGEXPORT HGResult HGAPI HGImgProc_CreateOCRMgr(HGUInt algo, HGOCRMgr *ocrMgr);

/* 反初始化OCR模块
*/
HGEXPORT HGResult HGAPI HGImgProc_DestroyOCRMgr(HGOCRMgr ocrMgr);

/* 图像OCR
*/
HGEXPORT HGResult HGAPI HGImgProc_ImageOCR(HGOCRMgr ocrMgr, HGImage image, HGOCRRet *ocrRet);

/* 销毁OCR结果
*/
HGEXPORT HGResult HGAPI HGImgProc_DestroyOCRRet(HGOCRRet ocrRet);

/* 获取OCR结果块数量
*/
HGEXPORT HGResult HGAPI HGImgProc_GetOCRRetBlockCount(HGOCRRet ocrRet, HGUInt *count);

/* 获取OCR结果块文本
*/
HGEXPORT HGResult HGAPI HGImgProc_GetOCRRetBlockText(HGOCRRet ocrRet, HGUInt index, const HGChar **text);

/* 图像OCR到文件
*/
HGEXPORT HGResult HGAPI HGImgProc_ImageOCRToFile(HGOCRMgr ocrMgr, HGImage image, HGUInt outType, const HGChar *outFileName);

/* 获取图像识别方向
*/
HGEXPORT HGResult HGAPI HGImgProc_ImageTextDirectOCR(HGOCRMgr ocrMgr, HGImage image, HGUInt *direct);

/* 添加到图像OCR列表
*/
HGEXPORT HGResult HGAPI HGImgProc_AddToImageOCRList(HGOCRMgr ocrMgr, HGImage image);

/* 清理图像OCR列表
*/
HGEXPORT HGResult HGAPI HGImgProc_ClearImageOCRList(HGOCRMgr ocrMgr);

/* 图像列表OCR到文件
*/
HGEXPORT HGResult HGAPI HGImgProc_ImageListOCRToFile(HGOCRMgr ocrMgr, HGUInt outType, const HGChar* outFileName, HGImageListOcrFunc func, HGPointer param);

#endif /* __HGOCR_H__ */