一、环境介绍

运行系统环境: xp 、win7、win8、win10。

目前测试支持的是HP Pro 系列的打印机，比如LaserJet Pro， OfficeJet Pro，PageWide等等，理论上支持所有系列打印机、扫描仪。

二、功能说明 

支持实时获取打印机的状态信息。包括耗材数量、已经打印总数量、当前状态、卡纸、缺墨、缺纸信息等等。  

开发工具包下载: https://download.csdn.net/download/xiaolong1126626497/15804834

SDK的接口支持任意语言调用。工具包里的文档里有C#调用示例。下面的截图的测试软件是使用C++编写的。

下面是编写的简单测试软件。

Python 通过pytwain 2.0对含TWAIN 驱动的扫描仪设备进行二次开发，支持Python 3

第一步，安装Pytwain2.0
通过 pip install pytwain
第二步，输入以下示例代码

import twain

sm = twain.SourceManager(0)
ss = sm.OpenSource()
ss.RequestAcquire(0,0)
rv = ss.XferImageNatively()
if rv:
   (handle, count) = rv
twain.DIBToBMFile(handle, 'image.bmp')

该代码默认Python2.7可以运行，并调出扫描仪选择窗口，不会报
twain.excSMLoadFileFailed: Could not find module ‘twain_32.dll’ (or one of its dependencies). Try using the full path with constructor syntax.
错误。
第三步，下载软件并集成64位驱动，支持Python3及以上
如果要支持Python3以上版本，仍需要下载“twain-dsm”，以支持64位系统
下载地址为：“https://download.csdn.net/download/wwwihpccn/56342941”
将下载文件解压下来，将Windows下32及64文件夹拷贝到开发目录下，并通过sm = twain.SourceManager(0, dsm_name=r’dsm_020400\windows\64\TWAINDSM.dll’) 指定64位dll文件所在位置。

明基扫描仪二次开发包

使用说明

明基电通信息技术有限公司·营销总部

0512-68251233-2888

目录

一，功能说明（3-3）

二，要求说明（3-3）

三，开发包文件结构说明（3-4）

四，scan.Dll接口说明（4-15）

五，ImageRWSB.dll 接口说明（15-17）(略)

一．   功能说明
本开发包是为明基扫描仪专门提供的，可以让用户进行二次开发的开发包。该开发包是用VC++ 6.0开发的动态连接库(scan.dll)。接口简单，调用方便，让您可以在最短的时间内实现对明基扫描仪的功能定制。另外，本开发包还提供给用户明基自行开发的影像文件读写库（ImageRW.dll）,提供了多种影像格式的支持，让您可以方便的将扫描得到的影像数据存成各种格式（支持的文件格式有BMP, PCX, JPG, TIF, TGA, PNG）的影像文件。本开发包内还附有开发例程，即使你一点都不了解扫描仪的驱动过程， 也能在很短的时间里定制出符合你要求的应用程序（当然，你需要有一定的VC++编程能力）， 比如说能在某个特定的区域内用特定的分辨率进行扫描。该例程还提供了如何使用汉王OCR实现文字识别的演示。

使用这个开发包，他们可以实现对扫描仪的自主操控，如自行控制预览、扫描的位置、扫描分辨率色彩等各项参数，甚至还提供了常见的几种图形文件格式的读写，让客户很方便的实现扫描仪的控制以及图像的读写操作，把更多的时间用于整个控制管理系统中更具应用价值的部分。

正因为二次开发包具备非常高的可扩展性，所以适用于多种行业多种应用。比如：数字图书馆和数字化档案馆等，如果再配合上光学文字识别软件（OCR）等专门处理软件，应用的领域更大，如：旅店业身份识别、机场及出入境身份识别、警（军）用活体指纹、指纹录入、考勤、录入工厂、银行金融票据、税务、交通、工程测绘、地质考古、公安户籍等等以及行业信息化数字化领域。在这些领域里，通用扫描控制根本没有用武之地，所有的应用系统都需要量身定制、需要灵活自如的控制，这些都只能基于二次开发包的高扩展性。

二．   要求说明

此开发包需要配合明基提供之扫描仪设备以及设备驱动程序方可使用，使用前，请确认扫描仪设备已经正确安装并工作。

三．   开发包文件结构说明

SDK:  根目录
/Include: 头文件目录（需要把该目录添加到你得VC开发环境中）
       TwainExport.h: scan.dll的接口定义
       twain.h： 标准影像设备数据结构类型定义
       ImageRW.h：    图像文件读写接口定义
/library:  库文件目录（需要把该目录添加到你得VC开发环境中）
       ImgRWSB.lib：图像文件读写接口库
/Src: 源文件目录
       TwainExport.cpp：
/Bin: 动态连接库目录
        Scan.dll：      扫描仪驱动接口动态连接库
         Formatdll.dll   图像文件读写动态连接库
/Sample: 例程目录
         VC++ 例程
/document: 说明文件目录
         明基扫描仪开发包说明.doc:  本说明文件

四．   Scan.dll接口说明
初始化函数
1. HINSTANCE InitTwainDLL(LPCTSTR szDLLName);

返回值
如果成功返回Scan.dll的句柄，失败为NULL。

参数
szDllName
         指向scan.dll的绝对路径名

注解
该接口函数必须第一个被调用成功，如果调用失败请检查路径名是否书写正确，或文件是否真的存在。


 2. VOID FreeTwainDLL(HINSTANCE hInst);  

返回值
无

参数
 hInst
          Scan.dll的句柄。

注解
该函数必须在程序推出时被调用，释放scan.dll资源。


3. VOID  NewTwain (Htwain * phTwain); 

返回值
无

参数
 phTwain
          指向扫描仪句柄的指针

注解
创建控制明基扫描仪的句柄

4. VOID  FreeTwainDLL(HTwain hTwain);

返回值
无

参数
 hTwain
          扫描仪句柄

注解
创建控制明基扫描仪的句柄






5. BOOL  LoadSM (HTwain hTwain);

返回值
成功TRUE, 失败FALSE

参数
 hTwain
          扫描仪句柄

注解
载入驱动管理器

6.  BOOL  UnloadSM (HTwain hTwain);

返回值
成功TRUE, 失败FALSE

参数
 hTwain
          扫描仪句柄

注解
卸载驱动管理器

7. BOOL OpenSM (HTwain hTwain);

返回值
成功TRUE, 失败FALSE

参数
 hTwain
          扫描仪句柄

注解
打开驱动管理器

8. BOOL CloseSM (HTwain hTwain);

返回值
成功TRUE, 失败FALSE

参数
 hTwain
          扫描仪句柄

注解
关闭驱动管理器
9. BOOL OpenDS (HTwain hTwain);

返回值
成功TRUE, 失败FALSE

参数
 hTwain
          扫描仪句柄

注解
打开驱动程序

10. BOOL CloseDS (HTwain hTwain);

返回值
成功TRUE, 失败FALSE

参数
 hTwain
          扫描仪句柄

注解
关闭驱动程序

11. BOOL EnableDS (HTwain hTwain, BOOL bIsShowUI, HWND hWnd);

返回值
成功TRUE, 失败FALSE

参数
 hTwain
          扫描仪句柄
bIsShowUI
          TRUE: 显示驱动程序界面， FALSE: 不显示
hWnd
          驱动程序父窗口句柄

注解
透过驱动程序进行扫描



12. BOOL DisableDS (HTwain hTwain, BOOL bIsShowUI, HWND hWnd);

返回值
成功TRUE, 失败FALSE

参数
 hTwain
          扫描仪句柄
bIsShowUI
          TRUE:驱动程序以打开界面， FALSE: 没有打开
hWnd
          驱动程序父窗口句柄

注解
使驱动程序扫描无效


13. BOOL DoMemXfer(HTwain hTwain, LPBITMAPINFO lpBmpInfo, LPBYTE lpData, LPSCANDATA lpScanData);

返回值
成功TRUE, 失败FALSE

参数
 hTwain
          扫描仪句柄
lpBmpInfo
          指向一个BMP位图的头信息结构
lpData
          指向存放DIB数据空间的指针
lpScanData
           保留

注解
进行数据传送



14. BOOL GetDefaultDriverName(HTwain hTwain, char *chDrvName, LPCSTR lpszNameFilter/*=NULL*/);
返回值
成功TRUE, 失败FALSE

参数
 hTwain
          扫描仪句柄
chDrvName
          指向一个字符串，将返回扫描仪驱动程序名称
lpszNameFilter
           保留

注解
得到默认的扫描仪驱动程序的名称

15. BOOL GetFirstDriverName(HTwain hTwain, char *chDrvName, LPCSTR lpszNameFilter/*=NULL*/);
返回值
成功TRUE, 失败FALSE

参数
 hTwain
          扫描仪句柄
chDrvName
          指向一个字符串，将返回扫描仪驱动程序名称
lpszNameFilter
           保留

注解
得到第一个扫描仪驱动程序的名称

16. BOOL GetNextDriverName)(HTwain hTwain, char *chDrvName, LPCSTR lpszNameFilter/*=NULL*/);
返回值
成功TRUE, 失败FALSE

参数
 hTwain
          扫描仪句柄
chDrvName
          指向一个字符串，将返回扫描仪驱动程序名称
lpszNameFilter
           保留

注解
得到下一个扫描仪驱动程序的名称
17. BOOL GetCapImageType(HTwain hTwain, int &type);
返回值
成功TRUE, 失败FALSE

参数
 hTwain
          扫描仪句柄
&type
          将返回影像类型
 
注解
得到影像类型
TWPT_BW         黑白
TWPT_GRAY    灰度
TWPT_RGB        彩色

18. BOOL SetCapImageType(HTwain hTwain, int type);
返回值
成功TRUE, 失败FALSE

参数
 hTwain
          扫描仪句柄
type
          影像类型
 
注解
设置扫描的影像类型
TWPT_BW         黑白
TWPT_GRAY    灰度
TWPT_RGB        彩色

19. BOOL GetResRange(HTwain hTwain, int &tmin,int &tmax);
返回值
成功TRUE, 失败FALSE

参数
 hTwain
          扫描仪句柄
&tmin
          返回一个最小的分辨率
&tmax
           返回一个最大的分辨率

注解
得到扫描仪的扫描分辨率的范围
20. BOOL SetCapXRes(HTwain hTwain, int res);
返回值
成功TRUE, 失败FALSE

参数
 hTwain
          扫描仪句柄
res
          扫描分辨率
注解
设置扫描仪横向的扫描分辨率

21. BOOL SetCapYRes(HTwain hTwain, int res);
返回值
成功TRUE, 失败FALSE

参数
 hTwain
          扫描仪句柄
res
          扫描分辨率
注解
设置扫描仪纵向的扫描分辨率

22. BOOL GetScaleRange(HTwain hTwain, double &tmin,double &tmax);
返回值
成功TRUE, 失败FALSE

参数
 hTwain
          扫描仪句柄
&tmin
          返回一个最小的缩放比例
&tmax
           返回一个最大的缩放比例

注解
得到影像所反比例的范围

23. BOOL SetCapXScale(HTwain hTwain, float scale);
返回值
成功TRUE, 失败FALSE

参数
 hTwain
          扫描仪句柄
scale
          缩放比例
 
注解
设置影像横向的缩放比例

24. BOOL SetCapYScale(HTwain hTwain, float scale);
返回值
成功TRUE, 失败FALSE

参数
 hTwain
          扫描仪句柄
scale
          缩放比例
 
注解
设置影像纵向的缩放比例




25. BOOL GetMaxScanArea(HTwain hTwain, float &tright,float &tbottom);
返回值
成功TRUE, 失败FALSE

参数
 hTwain
          扫描仪句柄
&tright
          返回一个最大扫描的宽度，单位英寸
&tbottom
           返回一个最大扫描的高度，单位英寸

注解
得到扫描仪的最大扫描范围



26. BOOL SetScanSize(HTwain hTwain, float fLeft, float fTop, float fRight, float fBottom);
返回值
成功TRUE, 失败FALSE

参数
 hTwain
          扫描仪句柄
fLeft
          扫描范围的左边界
fTop
         扫描范围的上边界 
fRight
         扫描范围的右边界
fBottom
         扫描范围的下边界
注解
设置扫描范围，单位英寸

27. TW_INT16 TwainFilter(HTwain hTwain, LPMSG lpMsg);
返回值
驱动程序返回的消息
MSG_XFERREADY：驱动程序已准备好进行数据传输
MSG_CLOSEDSREQ：
参数
 hTwain
          扫描仪句柄
lpMsg
         窗口消息
注解
将窗口消息传递给下层驱动程序，并返回状态值。

五．  ImageRWSB.dll 接口说明（略）

（完）