From 57d9ffc3fe68d87c7dcdc413d10dfe2790105711 Mon Sep 17 00:00:00 2001 From: luoliangyi <87842688@qq.com> Date: Mon, 3 Apr 2023 13:58:43 +0800 Subject: [PATCH] =?UTF-8?q?=E5=BE=AE=E8=B0=83?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- sdk/scannerlib/HGLibDeviceImpl.hpp | 2 +- sdk/scannerlib/HGScannerLib.cpp | 12 +- sdk/scannerlib/HGScannerLib.h | 446 ++++++++++++++--------------- 3 files changed, 230 insertions(+), 230 deletions(-) diff --git a/sdk/scannerlib/HGLibDeviceImpl.hpp b/sdk/scannerlib/HGLibDeviceImpl.hpp index c6e1ffae..07d71f4d 100644 --- a/sdk/scannerlib/HGLibDeviceImpl.hpp +++ b/sdk/scannerlib/HGLibDeviceImpl.hpp @@ -1,4 +1,4 @@ -#ifndef __HGLIBDEVICEIMPL_HPP__ +#ifndef __HGLIBDEVICEIMPL_HPP__ #define __HGLIBDEVICEIMPL_HPP__ #include "HGScannerLib.h" diff --git a/sdk/scannerlib/HGScannerLib.cpp b/sdk/scannerlib/HGScannerLib.cpp index 2bd22abd..48f81a23 100644 --- a/sdk/scannerlib/HGScannerLib.cpp +++ b/sdk/scannerlib/HGScannerLib.cpp @@ -1,4 +1,4 @@ -#include "HGScannerLib.h" +#include "HGScannerLib.h" #include "base/HGInc.h" #include "base/HGImage.h" #include "imgfmt/HGImgFmt.h" @@ -10,11 +10,11 @@ #pragma pack(4) struct HGLibSaveImageParam_V1 { - HGUInt size; /* ṹС */ - HGUInt jpegQuality; /* jpegЧ, 0-100 */ - HGUInt tiffCompression; /* tiffЧ, HGLIB_TIFFCOMPRESSION_* */ - HGUInt tiffJpegQuality; /* tiffHGLIB_TIFFCOMPRESSION_JPEGЧ, 0-100 */ - HGBool ocr; /* ǷOCRpdfofdʽЧ */ + HGUInt size; /* 结构体大小 */ + HGUInt jpegQuality; /* jpeg下有效, 0-100 */ + HGUInt tiffCompression; /* tiff下有效, HGLIB_TIFFCOMPRESSION_* */ + HGUInt tiffJpegQuality; /* tiff且HGLIB_TIFFCOMPRESSION_JPEG下有效, 0-100 */ + HGBool ocr; /* 是否OCR，pdf和ofd格式有效 */ }; #pragma pack(pop) diff --git a/sdk/scannerlib/HGScannerLib.h b/sdk/scannerlib/HGScannerLib.h index a26ba6fb..11f188da 100644 --- a/sdk/scannerlib/HGScannerLib.h +++ b/sdk/scannerlib/HGScannerLib.h @@ -1,4 +1,4 @@ -#ifndef __HGSCANNERLIB_H__ +#ifndef __HGSCANNERLIB_H__ #define __HGSCANNERLIB_H__ #include "HGDef.h" @@ -6,30 +6,30 @@ HG_DECLARE_HANDLE(HGLibImage); HG_DECLARE_HANDLE(HGLibDevice); -/* 1λڰͼ */ +/* 1位黑白图 */ #define HGLIB_IMGTYPE_BINARY 1L -/* 8λҶͼ */ +/* 8位灰度图 */ #define HGLIB_IMGTYPE_GRAY 2L -/* 24λɫB8G8R8ʽ */ +/* 24位真彩色，B8G8R8格式 */ #define HGLIB_IMGTYPE_BGR 3L -/* 24λɫR8G8B8ʽ */ +/* 24位真彩色，R8G8B8格式 */ #define HGLIB_IMGTYPE_RGB 4L -/* 32λɫAlphaͨB8G8R8A8ʽ */ +/* 32位真彩色，带Alpha通道，B8G8R8A8格式 */ #define HGLIB_IMGTYPE_BGRA 5L -/* 32λɫAlphaͨR8G8B8A8ʽ */ +/* 32位真彩色，带Alpha通道，R8G8B8A8格式 */ #define HGLIB_IMGTYPE_RGBA 6L -/* ͼݱ淽ʽ */ +/* 图像数据保存方式 */ #define HGLIB_IMGORIGIN_TOP 1L #define HGLIB_IMGORIGIN_BOTTOM 2L -/* TIFFѹʽ */ +/* TIFF压缩方式 */ #define HGLIB_TIFFCOMPRESSION_NONE 1L #define HGLIB_TIFFCOMPRESSION_CCITTFAX4 2L #define HGLIB_TIFFCOMPRESSION_LZW 3L #define HGLIB_TIFFCOMPRESSION_JPEG 4L -/* 豸 */ +/* 设备操作码 */ #define HGLIB_DEV_OPERATECODE_GOOD 0L #define HGLIB_DEV_OPERATECODE_UNSUPPORTED 1L #define HGLIB_DEV_OPERATECODE_CANCELLED 2L @@ -43,357 +43,357 @@ HG_DECLARE_HANDLE(HGLibDevice); #define HGLIB_DEV_OPERATECODE_NO_MEM 10L #define HGLIB_DEV_OPERATECODE_ACCESS_DENIED 11L -/* 豸Ȱβ¼ */ +/* 设备热拔插事件 */ #define HGLIB_DEVHOTPLUG_EVENT_ARRIVE 1L #define HGLIB_DEVHOTPLUG_EVENT_REMOVE 2L -/* 豸ɨ¼ */ +/* 设备扫描事件 */ #define HGLIB_DEVSCAN_EVENT_BEGIN 1L #define HGLIB_DEVSCAN_EVENT_END 2L #define HGLIB_DEVSCAN_EVENT_INFO 3L -/* */ -// +/* 组名 */ +// 基本设置 #define HGLIB_GROUP_NAME_BASESETTING 1L -// +// 亮度 #define HGLIB_GROUP_NAME_BRIGHTNESS 2L -// ͼ +// 图像处理 #define HGLIB_GROUP_NAME_IMAGEPROCESS 3L -// ֽʽ +// 送纸方式设置 #define HGLIB_GROUP_NAME_PAPERFEEDING 4L -/* */ +/* 配置名 */ #define HGLIB_OPTION_NAME_UNKNOWN 0L -// "" +// "多流输出" #define HGLIB_OPTION_NAME_DLSC 1L -// "" +// "多流输出类型" #define HGLIB_OPTION_NAME_DLSCLX 2L -// "ɫģʽ" +// "颜色模式" #define HGLIB_OPTION_NAME_YSMS 3L -// "ڰͼֵ" +// "黑白图像阈值" #define HGLIB_OPTION_NAME_HBTXYZ 4L -// "ҶȻڰͼ - ɫ" +// "灰度或黑白图像 - 除色" #define HGLIB_OPTION_NAME_HDHHBTX_CS 5L -// "24λɫͼ - " +// "24位彩色图像 - 多流输出除红" #define HGLIB_OPTION_NAME_24WCSTX_DLSCCH 6L -// "24λɫͼ - ⿨" +// "24位彩色图像 - 答题卡除红" #define HGLIB_OPTION_NAME_24WCSTX_DTKCH 7L -// "Ƴ" +// "背景移除" #define HGLIB_OPTION_NAME_BJYC 8L -// "ɫʸΧ" +// "背景色彩浮动范围" #define HGLIB_OPTION_NAME_BJSCFDFW 9L -// "ģ" +// "锐化与模糊" #define HGLIB_OPTION_NAME_RHYMH 10L -// "ȥĦ" +// "去除摩尔纹" #define HGLIB_OPTION_NAME_QCMW 11L -// "" +// "除网纹" #define HGLIB_OPTION_NAME_CWW 12L -// "ɢ" +// "错误扩散" #define HGLIB_OPTION_NAME_CWKS 13L -// "ڰͼŻ" +// "黑白图像噪点优化" #define HGLIB_OPTION_NAME_HBTXZDYH 14L -// "Żߴ" +// "噪点优化尺寸" #define HGLIB_OPTION_NAME_ZDYHCC 15L -// "ֽųߴ" +// "纸张尺寸" #define HGLIB_OPTION_NAME_ZZCC 16L -// "Զɨ" +// "自定义扫描区域" #define HGLIB_OPTION_NAME_ZDYSMQY 17L -// "ɨࣨmm" +// "扫描区域左侧（mm）" #define HGLIB_OPTION_NAME_SMQYZCmm 18L -// "ɨҲࣨmm" +// "扫描区域右侧（mm）" #define HGLIB_OPTION_NAME_SMQYYCmm 19L -// "ɨϲࣨmm" +// "扫描区域上侧（mm）" #define HGLIB_OPTION_NAME_SMQYSCmm 20L -// "ɨ²ࣨmm" +// "扫描区域下侧（mm）" #define HGLIB_OPTION_NAME_SMQYXCmm 21L -// "ߴ" +// "尺寸检测" #define HGLIB_OPTION_NAME_CCJC 22L -// "ɨҳ" +// "扫描页面" #define HGLIB_OPTION_NAME_SMYM 23L -// "հҳ" +// "跳过空白页灵敏度" #define HGLIB_OPTION_NAME_TGKBYLMD 24L -// "ֽǿ" +// "分纸强度" #define HGLIB_OPTION_NAME_FZQD 25L -// "ʱ" +// "休眠时间" #define HGLIB_OPTION_NAME_XMSJ 26L -// "ֱ" +// "分辨率" #define HGLIB_OPTION_NAME_FBL 27L -// "" +// "画质" #define HGLIB_OPTION_NAME_HZ 28L -// "" +// "交换正反面" #define HGLIB_OPTION_NAME_JHZFM 29L -// "ͼ" +// "图像拆分" #define HGLIB_OPTION_NAME_TXCF 30L -// "Զƫ" +// "自动纠偏" #define HGLIB_OPTION_NAME_ZDJP 31L -// "ɫ" +// "启用色调曲线" #define HGLIB_OPTION_NAME_QYSDQX 32L -// "ֵ" +// "亮度值" #define HGLIB_OPTION_NAME_LDZ 33L -// "Աȶ" +// "对比度" #define HGLIB_OPTION_NAME_DBD 34L -// "٤ֵ" +// "伽马值" #define HGLIB_OPTION_NAME_GMZ 35L -// "Ƭģʽ" +// "照片模式" #define HGLIB_OPTION_NAME_ZPMS 36L -// "ڿ" +// "消除黑框" #define HGLIB_OPTION_NAME_XCHK 37L -// "ɫ" +// "深色样张" #define HGLIB_OPTION_NAME_SSYZ 38L -// "ֵ" +// "阈值" #define HGLIB_OPTION_NAME_YZ 39L -// "ȼ" +// "背景抗噪等级" #define HGLIB_OPTION_NAME_BJKZDJ 40L -// "Ե" +// "边缘缩进" #define HGLIB_OPTION_NAME_BYSJ 41L -// "䷽ʽ" +// "背景填充方式" #define HGLIB_OPTION_NAME_BJTCFS 42L -// "ֹ͸" +// "防止渗透" #define HGLIB_OPTION_NAME_FZST 43L -// "ֹ͸ȼ" +// "防止渗透等级" #define HGLIB_OPTION_NAME_FZSTDJ 44L -// "Ƴ" +// "穿孔移除—左侧" #define HGLIB_OPTION_NAME_CKYCZC 45L -// #"ഩΧռ" +// #"左侧穿孔搜索范围占幅面比例" #define HGLIB_OPTION_NAME_ZCCKSSFWZFMBL 46L -// "ƳҲ" +// "穿孔移除—右侧" #define HGLIB_OPTION_NAME_CKYCYC 47L -// #"ҲഩΧռ" +// #"右侧穿孔搜索范围占幅面比例" #define HGLIB_OPTION_NAME_YCCKSSFWZFMBL 48L -// "Ƴϲ" +// "穿孔移除—上侧" #define HGLIB_OPTION_NAME_CKYCSC 49L -// #"ϲഩΧռ" +// #"上侧穿孔搜索范围占幅面比例" #define HGLIB_OPTION_NAME_SCCKSSFWZFMBL 50L -// "Ƴ²" +// "穿孔移除—下侧" #define HGLIB_OPTION_NAME_CKYCXC 51L -// #"²ഩΧռ" +// #"下侧穿孔搜索范围占幅面比例" #define HGLIB_OPTION_NAME_XCCKSSFWZFMBL 52L -// "ɫ" +// "色彩填充" #define HGLIB_OPTION_NAME_SCTC 53L -// "" +// "超声波检测" #define HGLIB_OPTION_NAME_CSBJC 54L -// "˫ͼƬ" +// "双张图片处理" #define HGLIB_OPTION_NAME_SZTPCL 55L -// "װ" +// "装订检测" #define HGLIB_OPTION_NAME_ZDJC 56L -// "ɨ" +// "扫描张数" #define HGLIB_OPTION_NAME_SMZS 57L -// "ɨ" +// "扫描数量" #define HGLIB_OPTION_NAME_SMSL 58L -// "ĸ巽" +// "文稿方向" #define HGLIB_OPTION_NAME_WGFX 59L -// "ת180" +// "背面旋转180°" #define HGLIB_OPTION_NAME_BMXZ180 60L -// "۽Ǽ" +// "折角检测" #define HGLIB_OPTION_NAME_ZJJC 61L -// "۽ǴС" +// "折角大小" #define HGLIB_OPTION_NAME_ZJDX 62L -// "б" +// "歪斜检测" #define HGLIB_OPTION_NAME_WXJC 63L -// "б̶" +// "歪斜容忍度" #define HGLIB_OPTION_NAME_WXRRD 64L -// Զֽǿ +// 自动分纸强度 #define HGLIB_OPTION_NAME_ZDCZQD 65L -// ֽʧ +// 进纸失败率 #define HGLIB_OPTION_NAME_CZYZ 66L -// ֽɨ +// 待纸扫描 #define HGLIB_OPTION_NAME_DZSM 67L -// ڰͼɫɫΪ0 - ɫ1 - ɫ +// 黑白图像反色输出（正常颜色为：0 - 黑色；1 - 白色） #define HGLIB_OPTION_NAME_HBTXFSSC 68L -// ģʽ +// 对折模式 #define HGLIB_OPTION_NAME_DZMS 69L -// ɫƫУ +// 色偏校正 #define HGLIB_OPTION_NAME_SPJZ 70L -// ֽɨ˳ʱ +// 待纸扫描退出时间 #define HGLIB_OPTION_NAME_DZSMTCSJ 71L -/* öֵ */ -// "" +/* 配置枚举值 */ +// "无" #define HGLIB_OPTION_ENUMVALUE_DLSCLX_W 1L -// "ɫ+Ҷ+ڰ" +// "彩色+灰度+黑白" #define HGLIB_OPTION_ENUMVALUE_DLSCLX_CS_HD_HB 2L -// "ɫ+Ҷ" +// "彩色+灰度" #define HGLIB_OPTION_ENUMVALUE_DLSCLX_CS_HD 3L -// "ɫ+ڰ" +// "彩色+黑白" #define HGLIB_OPTION_ENUMVALUE_DLSCLX_CS_HB 4L -// "Ҷ+ڰ" +// "灰度+黑白" #define HGLIB_OPTION_ENUMVALUE_DLSCLX_HD_HB 5L -// "24λɫ" +// "24位彩色" #define HGLIB_OPTION_ENUMVALUE_YSMS_24WCS 6L -// "256Ҷ" +// "256级灰度" #define HGLIB_OPTION_ENUMVALUE_YSMS_256JHD 7L -// "ڰ" +// "黑白" #define HGLIB_OPTION_ENUMVALUE_YSMS_HB 8L -// "ɫԶʶ" +// "颜色自动识别" #define HGLIB_OPTION_ENUMVALUE_YSMS_YSZDSB 9L -// "ɫ" +// "不除色" #define HGLIB_OPTION_ENUMVALUE_HDHHBTX_CS_BCS 10L -// "ɫ" +// "除红色" #define HGLIB_OPTION_ENUMVALUE_HDHHBTX_CS_CHS 11L -// "ɫ" +// "除绿色" #define HGLIB_OPTION_ENUMVALUE_HDHHBTX_CS_CLS 12L -// "ɫ" +// "除蓝色" #define HGLIB_OPTION_ENUMVALUE_HDHHBTX_CS_CHULANSE 13L -// "ɫǿ" +// "红色增强" #define HGLIB_OPTION_ENUMVALUE_HDHHBTX_CS_HSZQ 14L -// "ɫǿ" +// "绿色增强" #define HGLIB_OPTION_ENUMVALUE_HDHHBTX_CS_LSZQ 15L -// "ɫǿ" +// "蓝色增强" #define HGLIB_OPTION_ENUMVALUE_HDHHBTX_CS_LANSEZENGQIANG 16L -// "" +// "无" #define HGLIB_OPTION_ENUMVALUE_RHYMH_W 17L -// "" +// "锐化" #define HGLIB_OPTION_ENUMVALUE_RHYMH_RH 18L -// "һ" +// "进一步锐化" #define HGLIB_OPTION_ENUMVALUE_RHYMH_JYBRH 19L -// "ģ" +// "模糊" #define HGLIB_OPTION_ENUMVALUE_RHYMH_MH 20L -// "һģ" +// "进一步模糊" #define HGLIB_OPTION_ENUMVALUE_RHYMH_JYBMH 21L // "A3" #define HGLIB_OPTION_ENUMVALUE_ZZCC_A3 22L -// "8" +// "8开" #define HGLIB_OPTION_ENUMVALUE_ZZCC_8K 23L // "A4" #define HGLIB_OPTION_ENUMVALUE_ZZCC_A4 24L -// "A4" +// "A4横向" #define HGLIB_OPTION_ENUMVALUE_ZZCC_A4HX 25L -// "16" +// "16开" #define HGLIB_OPTION_ENUMVALUE_ZZCC_16K 26L -// "16" +// "16开横向" #define HGLIB_OPTION_ENUMVALUE_ZZCC_16KHX 27L // "A5" #define HGLIB_OPTION_ENUMVALUE_ZZCC_A5 28L -// "A5" +// "A5横向" #define HGLIB_OPTION_ENUMVALUE_ZZCC_A5HX 29L // "A6" #define HGLIB_OPTION_ENUMVALUE_ZZCC_A6 30L -// "A6" +// "A6横向" #define HGLIB_OPTION_ENUMVALUE_ZZCC_A6HX 31L // "B4" #define HGLIB_OPTION_ENUMVALUE_ZZCC_B4 32L // "B5" #define HGLIB_OPTION_ENUMVALUE_ZZCC_B5 33L -// "B5" +// "B5横向" #define HGLIB_OPTION_ENUMVALUE_ZZCC_B5HX 34L // "B6" #define HGLIB_OPTION_ENUMVALUE_ZZCC_B6 35L -// "B6" +// "B6横向" #define HGLIB_OPTION_ENUMVALUE_ZZCC_B6HX 36L // "Letter" #define HGLIB_OPTION_ENUMVALUE_ZZCC_Letter 37L -// "Letter" +// "Letter横向" #define HGLIB_OPTION_ENUMVALUE_ZZCC_LetterHX 38L // "Double Letter" #define HGLIB_OPTION_ENUMVALUE_ZZCC_DoubleLetter 39L // "LEGAL" #define HGLIB_OPTION_ENUMVALUE_ZZCC_LEGAL 40L -// "ƥԭʼߴ" +// "匹配原始尺寸" #define HGLIB_OPTION_ENUMVALUE_ZZCC_PPYSCC 41L -// "ɨߴԶ" +// "最大扫描尺寸自动裁切" #define HGLIB_OPTION_ENUMVALUE_ZZCC_ZDSMCCZDCQ 42L -// "ɨߴ" +// "最大扫描尺寸" #define HGLIB_OPTION_ENUMVALUE_ZZCC_ZDSMCC 43L -// "Ծ" +// "三联试卷" #define HGLIB_OPTION_ENUMVALUE_ZZCC_SLSJ 44L -// "" +// "单面" #define HGLIB_OPTION_ENUMVALUE_SMYM_DM 45L -// "˫" +// "双面" #define HGLIB_OPTION_ENUMVALUE_SMYM_SM 46L -// "հҳͨã" +// "跳过空白页（通用）" #define HGLIB_OPTION_ENUMVALUE_SMYM_TGKBYTY 47L -// "հҳƱֽ" +// "跳过空白页（发票纸）" #define HGLIB_OPTION_ENUMVALUE_SMYM_TGKBYFPZ 48L -// "" +// "对折" #define HGLIB_OPTION_ENUMVALUE_SMYM_DZ 49L -// "" +// "无" #define HGLIB_OPTION_ENUMVALUE_HZ_W 50L -// "ٶ" +// "速度优先" #define HGLIB_OPTION_ENUMVALUE_HZ_SDYX 51L -// "" +// "画质优先" #define HGLIB_OPTION_ENUMVALUE_HZ_HZYX 52L -// "͹" +// "凸多边形" #define HGLIB_OPTION_ENUMVALUE_BJTCFS_TDBX 53L -// "" +// "凹多边形" #define HGLIB_OPTION_ENUMVALUE_BJTCFS_ADBX 54L -// "" +// "弱" #define HGLIB_OPTION_ENUMVALUE_FZSTDJ_R 55L -// "" +// "较弱" #define HGLIB_OPTION_ENUMVALUE_FZSTDJ_JR 56L -// "һ" +// "一般" #define HGLIB_OPTION_ENUMVALUE_FZSTDJ_YB 57L -// "ǿ" +// "较强" #define HGLIB_OPTION_ENUMVALUE_FZSTDJ_JQ 58L -// "ǿ" +// "强" #define HGLIB_OPTION_ENUMVALUE_FZSTDJ_Q 59L -// "ͼֹͣɨ" +// "丢弃图像并停止扫描" #define HGLIB_OPTION_ENUMVALUE_SZTPCL_DQTXBTZSM 60L -// "ͼ񲢼ɨ" +// "丢弃图像并继续扫描" #define HGLIB_OPTION_ENUMVALUE_SZTPCL_DQTXBJXSM 61L -// "ϴͼֹͣɨ" +// "上传图像并停止扫描" #define HGLIB_OPTION_ENUMVALUE_SZTPCL_SCTXBTZSM 62L -// "ϴͼ񲢼ɨ" +// "上传图像并继续扫描" #define HGLIB_OPTION_ENUMVALUE_SZTPCL_SCTXBJXSM 63L -// "ɨ" +// "连续扫描" #define HGLIB_OPTION_ENUMVALUE_SMZS_LXSM 64L -// "ɨָ" +// "扫描指定张数" #define HGLIB_OPTION_ENUMVALUE_SMZS_SMZDZS 65L -// "0" +// "0°" #define HGLIB_OPTION_ENUMVALUE_WGFX_0 66L -// "90" +// "90°" #define HGLIB_OPTION_ENUMVALUE_WGFX_90 67L -// "180" +// "180°" #define HGLIB_OPTION_ENUMVALUE_WGFX_180 68L -// "-90" +// "-90°" #define HGLIB_OPTION_ENUMVALUE_WGFX__90 69L -// "Զıʶ" +// "自动文本方向识别°" #define HGLIB_OPTION_ENUMVALUE_WGFX_ZDWBFXSB 70L -// "ֽǿ-" +// "分纸强度-弱" #define HGLIB_OPTION_ENUMVALUE_FZQD_R 71L -// "ֽǿ-һ" +// "分纸强度-一般" #define HGLIB_OPTION_ENUMVALUE_FZQD_YB 72L -// "ֽǿ-ǿ" +// "分纸强度-强" #define HGLIB_OPTION_ENUMVALUE_FZQD_Q 73L -// "" +// "不休眠" #define HGLIB_OPTION_ENUMVALUE_XMSJ_BXM 74L -// "" +// "五分钟" #define HGLIB_OPTION_ENUMVALUE_XMSJ_WFZ 75L -// "ʮ" +// "十分钟" #define HGLIB_OPTION_ENUMVALUE_XMSJ_SFZ 76L -// "Сʱ" +// "半小时" #define HGLIB_OPTION_ENUMVALUE_XMSJ_BXS 77L -// "һСʱ" +// "一小时" #define HGLIB_OPTION_ENUMVALUE_XMSJ_YXS 78L -// "Сʱ" +// "两小时" #define HGLIB_OPTION_ENUMVALUE_XMSJ_LXS 79L -// "Сʱ" +// "四小时" #define HGLIB_OPTION_ENUMVALUE_XMSJ_SXS 80L -// Ҷ +// 左右对折 #define HGLIB_OPTION_ENUMVALUE_ZYDZ 81L -// ¶ +// 上下对折 #define HGLIB_OPTION_ENUMVALUE_SXDZ 82L -// Զ +// 自动对折 #define HGLIB_OPTION_ENUMVALUE_ZDDZ 83L -// ֽɨ˳ʱ15s +// 待纸扫描退出时间15s #define HGLIB_OPTION_ENUMVALUE_DZSMTCSJ_15S 84L -// ֽɨ˳ʱ30s +// 待纸扫描退出时间30s #define HGLIB_OPTION_ENUMVALUE_DZSMTCSJ_30S 85L -// ֽɨ˳ʱ60s +// 待纸扫描退出时间60s #define HGLIB_OPTION_ENUMVALUE_DZSMTCSJ_60S 86L -// ֽɨ˳ʱ2min +// 待纸扫描退出时间2min #define HGLIB_OPTION_ENUMVALUE_DZSMTCSJ_2MIN 87L -// ֽɨ˳ʱ4min +// 待纸扫描退出时间4min #define HGLIB_OPTION_ENUMVALUE_DZSMTCSJ_4MIN 88L -// ֽɨ˳ʱ8min +// 待纸扫描退出时间8min #define HGLIB_OPTION_ENUMVALUE_DZSMTCSJ_8MIN 89L -/* ֵ */ +/* 配置值类型 */ #define HGLIB_OPTION_VALUETYPE_INT 1L #define HGLIB_OPTION_VALUETYPE_ENUM 2L #define HGLIB_OPTION_VALUETYPE_DOUBLE 3L #define HGLIB_OPTION_VALUETYPE_BOOL 4L -/* ֵΧ */ +/* 配置值范围类型 */ #define HGLIB_OPTION_VALUERANGETYPE_NULL 0L #define HGLIB_OPTION_VALUERANGETYPE_INTLIST 1L #define HGLIB_OPTION_VALUERANGETYPE_ENUMLIST 2L @@ -406,21 +406,21 @@ HG_DECLARE_HANDLE(HGLibDevice); typedef struct { - HGUInt size; /* ṹСʼΪsizeof(HGLibSaveImageParam) */ - HGUInt jpegQuality; /* jpegЧ, 0-100 */ - HGUInt tiffCompression; /* tiffЧ, HGLIB_TIFFCOMPRESSION_* */ - HGUInt tiffJpegQuality; /* tiffHGLIB_TIFFCOMPRESSION_JPEGЧ, 0-100 */ - HGBool ocr; /* ǷOCRpdfofdʽЧ */ + HGUInt size; /* 结构体大小，必须初始化为sizeof(HGLibSaveImageParam) */ + HGUInt jpegQuality; /* jpeg下有效, 0-100 */ + HGUInt tiffCompression; /* tiff下有效, HGLIB_TIFFCOMPRESSION_* */ + HGUInt tiffJpegQuality; /* tiff且HGLIB_TIFFCOMPRESSION_JPEG下有效, 0-100 */ + HGBool ocr; /* 是否OCR，pdf和ofd格式有效 */ }HGLibSaveImageParam; -/* ͼϢ */ +/* 图像信息 */ typedef struct { - HGUInt width; /* () */ - HGUInt height; /* () */ - HGUInt type; /* ͣμHGLIB_IMGTYPE_* */ - HGUInt widthStep; /* ÿеֽ */ - HGUInt origin; /* зʽμHGLIB_IMGORIGIN_* */ + HGUInt width; /* 宽(像素)，列数 */ + HGUInt height; /* 高(像素)，行数 */ + HGUInt type; /* 类型，参见HGLIB_IMGTYPE_* */ + HGUInt widthStep; /* 每行的字节数 */ + HGUInt origin; /* 数据排列方式，参见HGLIB_IMGORIGIN_* */ }HGLibImageInfo; typedef struct @@ -455,9 +455,9 @@ typedef struct typedef struct { - HGUInt option; /* , μHGLIB_OPTION_NAME_* */ + HGUInt option; /* 配置名, 参见HGLIB_OPTION_NAME_* */ - HGUInt type; /* ֵ, μHGLIB_OPTION_VALUETYPE_* */ + HGUInt type; /* 值类型, 参见HGLIB_OPTION_VALUETYPE_* */ union { HGInt intValue; @@ -466,7 +466,7 @@ typedef struct HGBool boolValue; }; - HGUInt rangeType; /* ֵΧ, μHGLIB_OPTION_VALUERANGETYPE_* */ + HGUInt rangeType; /* 值范围类型, 参见HGLIB_OPTION_VALUERANGETYPE_* */ union { HGLibDeviceIntValueList intValueList; @@ -479,112 +479,112 @@ typedef struct typedef struct { - HGUInt group; /* , μHGLIB_GROUP_NAME_* */ + HGUInt group; /* 组名, 参见HGLIB_GROUP_NAME_* */ HGLibDeviceParam* param; HGUInt paramCount; }HGLibDeviceParamGroup; #pragma pack(pop) -/* 豸Ȱβص +/* 设备热拔插回调 * event: HGLIB_DEVHOTPLUG_EVENT_* -* deviceName: 豸 -* param: ص +* deviceName: 设备名 +* param: 回调参数 */ typedef void (HGAPI *HGLibDeviceHotPlugEventFunc)(HGUInt event, const HGChar *deviceName, HGPointer param); -/* 豸ɨ¼ص -* device: 豸 +/* 设备扫描事件回调 +* device: 设备句柄 * event: HGLIB_DEVSCAN_EVENT_* -* err: ǷǴϢ, HGLIB_DEVSCAN_EVENT_INFOЧ -* info: ɨϢ, HGLIB_DEVSCAN_EVENT_INFOЧ -* param: ص +* err: 是否是错误信息, HGLIB_DEVSCAN_EVENT_INFO下有效 +* info: 扫描信息, HGLIB_DEVSCAN_EVENT_INFO下有效 +* param: 回调参数 */ typedef void (HGAPI *HGLibDeviceScanEventFunc)(HGLibDevice device, HGUInt event, HGBool err, const HGChar *info, HGPointer param); -/* 豸ɨͼص -* device: 豸 -* image: ͼ, ҪHGLib_ReleaseImageͷ, صִкԶͷ -* param: ص +/* 设备扫描图像回调 +* device: 设备句柄 +* image: 图像句柄, 不要调用HGLib_ReleaseImage释放, 回调执行后会自动释放 +* param: 回调参数 */ typedef void (HGAPI *HGLibDeviceScanImageFunc)(HGLibDevice device, HGLibImage image, HGPointer param); -/* ͼ */ +/* 加载图像 */ HGEXPORT HGLibImage HGAPI HGLib_LoadImage(const HGChar *filePath); -/* ȡͼ */ +/* 获取图像数据 */ HGEXPORT HGByte* HGAPI HGLib_GetImageData(HGLibImage image); -/* ȡͼϢ */ +/* 获取图像信息 */ HGEXPORT HGBool HGAPI HGLib_GetImageInfo(HGLibImage image, HGLibImageInfo* imageInfo); -/* ͼ */ +/* 保存图像 */ HGEXPORT HGBool HGAPI HGLib_SaveImage(HGLibImage image, const HGChar* savePath, const HGLibSaveImageParam* saveParam); -/* ͷͼ */ +/* 释放图像 */ HGEXPORT HGBool HGAPI HGLib_ReleaseImage(HGLibImage image); -/* ʼɨ */ +/* 初始化扫描仪 */ HGEXPORT HGBool HGAPI HGLib_InitDevice(HGLibDeviceHotPlugEventFunc func, HGPointer param); -/* ʼɨ */ +/* 反初始化扫描仪 */ HGEXPORT HGBool HGAPI HGLib_DeinitDevice(); -/* ȡɨб */ +/* 获取扫描仪名称列表 */ HGEXPORT HGChar** HGAPI HGLib_GetDeviceNameList(); -/* ɨб */ +/* 销毁扫描仪名称列表 */ HGEXPORT HGBool HGAPI HGLib_ReleaseDeviceNameList(HGChar** deviceName); -/* 豸 */ +/* 打开设备 */ HGEXPORT HGLibDevice HGAPI HGLib_OpenDevice(const HGChar *deviceName); -/* ر豸 */ +/* 关闭设备 */ HGEXPORT HGBool HGAPI HGLib_CloseDevice(HGLibDevice device); -/* ȡ豸к */ +/* 获取设备序列号 */ HGEXPORT HGBool HGAPI HGLib_GetDeviceSN(HGLibDevice device, HGChar *sn, HGUInt maxLen); -/* ȡ豸̼汾*/ +/* 获取设备固件版本号*/ HGEXPORT HGBool HGAPI HGLib_GetDeviceFWVersion(HGLibDevice device, HGChar* fwVersion, HGUInt maxLen); -/* 豸 */ +/* 设置设备参数 */ HGEXPORT HGBool HGAPI HGLib_SetDeviceParam(HGLibDevice device, HGUInt option, const HGVoid *data); -/* ȡ豸 */ +/* 获取设备参数 */ HGEXPORT HGLibDeviceParamGroup* HGAPI HGLib_GetDeviceParamGroupList(HGLibDevice device, HGUInt *count); HGEXPORT HGLibDeviceParam* HGAPI HGLib_GetDeviceParam(HGLibDevice device, HGUInt option); -/* 豸 */ +/* 销毁设备参数 */ HGEXPORT HGBool HGAPI HGLib_ReleaseDeviceParamGroupList(HGLibDeviceParamGroup* paramGroup, HGUInt count); HGEXPORT HGBool HGAPI HGLib_ReleaseDeviceParam(HGLibDeviceParam* param); -/* 豸 */ +/* 重置设备参数 */ HGEXPORT HGBool HGAPI HGLib_ResetDeviceParam(HGLibDevice device); -/* 豸Ƿֽ */ +/* 设备是否有纸 */ HGEXPORT HGBool HGAPI HGLib_DeviceIsPaperOn(HGLibDevice device); -/* ȡ豸״̬, -1ʾ쳣0ʾֽ1ʾֽ */ +/* 获取设备状态, -1表示异常，0表示无纸，1表示有纸 */ HGEXPORT HGInt HGAPI HGLib_GetDeviceStatus(HGLibDevice device); -/* 豸 */ +/* 重启设备 */ HGEXPORT HGBool HGAPI HGLib_DeviceRestart(HGLibDevice device); -/* ر豸 */ +/* 关闭设备 */ HGEXPORT HGBool HGAPI HGLib_DeviceShutDown(HGLibDevice device); -/* ʼɨ */ +/* 开始扫描 */ HGEXPORT HGBool HGAPI HGLib_StartDeviceScan(HGLibDevice device, HGLibDeviceScanEventFunc eventFunc, HGPointer eventParam, HGLibDeviceScanImageFunc imageFunc, HGPointer imageParam); -/* ֹͣɨ */ +/* 停止扫描 */ HGEXPORT HGBool HGAPI HGLib_StopDeviceScan(HGLibDevice device); -/* ֹͣɨ-첽 */ +/* 停止扫描-异步 */ HGEXPORT HGBool HGAPI HGLib_StopDeviceScanAsyn(HGLibDevice device); -/* ȡ豸루ڵ豸Ժ */ +/* 获取设备操作码（在调用设备操作函数以后） */ HGEXPORT HGInt HGAPI HGLib_GetDeviceOperateCode(HGLibDevice device); #endif /* __HGSCANNERLIB_H__ */ \ No newline at end of file