明基扫描仪二次开发包教材

1、BenQ明基BenQ版权所有 2003保留所有权利.20-2-20明基扫描仪二次开发包使用说明明基电通信息技术有限公司？营销总部目录一，功能说明（3-3 ）二，要求说明（3-3 ）三，开发包文件结构说明（3-4）四，sean.DII 接口说明（4-15）五, ImageRWSB.dll 接口说明（15-17）附件：使用授权协议明基BenQ版权所有2003保留所有权利.所有内容如有变化，恕不另行通告所有其它提及之品牌名称、产品或公司名称的注册商标权归原公司所有功能说明本开发包是为明基扫描仪专门提供的，可以让用户进行二次开发的开发包。该开发包是用VC+6.0开发的动态连接库（sean.dll）。接

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

3、之扫描仪设备以及设备驱动程序方可使用，使用前，请确认扫 描仪设备已经正确安装并工作。三. 开发包文件结构说明SDK:根目录In clude:头文件目录（需要把该目录添加到你得VC开发环境中）Twain Export.h: sca n. dll的接口定义twai n.h:标准影像设备数据结构类型定义ImageRW.h :图像文件读写接口定义library:库文件目录（需要把该目录添加到你得VC开发环境中）ImgRWSB.lib :图像文件读写接口库Src:源文件目录Twain Export.cpp :Bi n:动态连接库目录Sca n. dll:扫描仪驱动接口动态连接库Formatdll.dll

4、图像文件读写动态连接库Sample: 例程目录Page 3 of 18BenQ明基BenQ版权所有 2003保留所有权利.20-2-20明基BenQ版权所有 2003保留所有权利VC+ 例程docume nt: 说明文件目录明基扫描仪开发包说明.doc:本说明文件四. Sca n.dll 接口说明初始化函数1. HINSTANCE InitTwainDLL(LPCTSTR szDLLName);返回值如果成功返回Sca n.dll的句柄，失败为 NULL。参数szDllName指向scan.dll的绝对路径名注解该接口函数必须第一个被调用成功，如果调用失败请检查路径名是否书写正确，或文件是否真

5、的存在。2. VOID FreeTwa in DLL(HINSTANCE hln st);返回值无参数hI nstSca n.dll的句柄。注解该函数必须在程序推岀时被调用，释放sca n.dll 资源3. VOID NewTwa in (Htwa in * phTwai n);返回值无参数phTwa in指向扫描仪句柄的指针注解创建控制明基扫描仪的句柄4. VOID FreeTwai nDLL(HTwai n hTwai n);返回值无参数hTwai n扫描仪句柄注解创建控制明基扫描仪的句柄5. BOOL LoadSM (HTwa in hTwai n);返回值成功TRUE,失败FALSE参

6、数hTwai n扫描仪句柄注解载入驱动管理器6. BOOL Un loadSM (HTwa in hTwai n);返回值成功TRUE,失败FALSE参数hTwai n扫描仪句柄注解卸载驱动管理器7. BOOL Ope nSM (HTwa in hTwai n);返回值成功TRUE,失败FALSE参数hTwai n扫描仪句柄注解打开驱动管理器8. BOOL CloseSM (HTwa in hTwai n);返回值成功TRUE,失败FALSE参数hTwai n扫描仪句柄注解关闭驱动管理器9. BOOL Ope nDS (HTwai n hTwai n);返回值成功TRUE,失败FALSE参数h

7、Twai n扫描仪句柄注解打开驱动程序10. BOOL CloseDS (HTwa in hTwai n);返回值成功TRUE,失败FALSE参数hTwai n扫描仪句柄注解关闭驱动程序Page 8 of 18BenQ明基BenQ版权所有 2003保留所有权利.20-2-20明基BenQ版权所有 2003保留所有权利.11. BOOL En ableDS (HTwa in hTwai n, BOOL blsShowUI, HWND hWnd);返回值成功TRUE,失败FALSE参数hTwai n扫描仪句柄bIsShowUITRUE:显示驱动程序界面， FALSE:不显示hWnd驱动程序父窗口句

8、柄注解透过驱动程序进行扫描12. BOOL DisableDS (HTwa in hTwa in, BOOL bIsShowUI, HWND hWnd);返回值成功TRUE,失败FALSE参数hTwai n扫描仪句柄bIsShowUITRUE:驱动程序以打开界面，FALSE:没有打开hWnd驱动程序父窗口句柄注解使驱动程序扫描无效13. BOOL DoMemXfer(HTwa in hTwai n, LPBITMAPINFO IpBmpI nfo, LPBYTE IpData, LPSCANDATAIpSca nData);返回值成功TRUE,失败FALSE参数hTwai n扫描仪句柄lpBm

9、pI nfo指向一个BMP位图的头信息结构lpData指向存放DIB数据空间的指针lpSca nData保留注解进行数据传送14. BOOL GetDefaultDriverName(HTwa inhTwa in,char *chDrvName, LPCSTRlpszNameFilter/*=NULL*/);返回值成功TRUE,失败FALSE参数hTwai n扫描仪句柄chDrvName指向一个字符串，将返回扫描仪驱动程序名称lpszNameFilter保留注解得到默认的扫描仪驱动程序的名称15. BOOL GetFirstDriverName(HTwainhTwai n, char *chD

10、rvName, LPCSTRlpszNameFilter/*=NULL*/);返回值成功TRUE,失败FALSE参数hTwai n扫描仪句柄chDrvName指向一个字符串，将返回扫描仪驱动程序名称lpszNameFilter保留注解得到第一个扫描仪驱动程序的名称16. BOOLGetNextDriverName)(HTwai nhTwai n, char *chDrvName, LPCSTRlpszNameFilter/*=NULL*/);返回值成功TRUE,失败FALSE参数hTwai n扫描仪句柄chDrvName指向一个字符串，将返回扫描仪驱动程序名称lpszNameFilter保留注

11、解Page 12 of 18BenQ明基BenQ版权所有 2003保留所有权利.20-2-20明基BenQ版权所有 2003保留所有权利. 得到下一个扫描仪驱动程序的名称17. BOOL GetCaplmageType(HTwain hTwai n, i nt &type);返回值成功TRUE,失败FALSE参数hTwai n扫描仪句柄&type将返回影像类型注解得到影像类型TWPT_BW黑白TWPT_GRAY 灰度TWPT_RGB彩色18. BOOL SetCaplmageType(HTwain hTwai n, int type);返回值成功TRUE,失败FALSE参数hTwai n扫描仪

12、句柄type影像类型注解设置扫描的影像类型TWPT_BW黑白TWPT_GRAY 灰度TWPT_RGB彩色19. BOOL GetResRange(HTwain hTwain, int &tmin,int &tmax);返回值成功TRUE,失败FALSE参数hTwai n扫描仪句柄&tmi n返回一个最小的分辨率&tmax返回一个最大的分辨率注解得到扫描仪的扫描分辨率的范围20. BOOL SetCapXRes(HTwai n hTwai n, i nt res);返回值成功TRUE,失败FALSE参数hTwai n扫描仪句柄res扫描分辨率注解设置扫描仪横向的扫描分辨率21. BOOL Set

13、CapYRes(HTwain hTwain, int res);返回值成功TRUE,失败FALSE参数hTwai n扫描仪句柄res扫描分辨率注解设置扫描仪纵向的扫描分辨率22. BOOL GetScaleRa nge(HTwain hTwa in, double & tmi n, double & tmax);返回值成功TRUE,失败FALSE参数hTwai n扫描仪句柄&tmi n返回一个最小的缩放比例&tmax返回一个最大的缩放比例注解得到影像所反比例的范围四.23. BOOL SetCapXScale(HTwain hTwai n, float scale);返回值成功TRUE,失败F

14、ALSE参数hTwai n扫描仪句柄scale缩放比例注解设置影像横向的缩放比例24. BOOL SetCapYScale(HTwain hTwai n, float scale);返回值成功TRUE,失败FALSE参数hTwai n扫描仪句柄scale缩放比例注解设置影像纵向的缩放比例25. BOOL GetMaxScanArea(HTwain hTwain, float &tright,float &tbottom);返回值成功TRUE,失败FALSE参数hTwai n扫描仪句柄&tright返回一个最大扫描的宽度，单位英寸&tbottom返回一个最大扫描的高度，单位英寸注解得到扫描仪的最

15、大扫描范围26. BOOLSetScanSize(HTwainhTwain, float fLeft, float fTop, float fRight, float fBottom);返回值成功TRUE,失败FALSE参数hTwai n扫描仪句柄fLeft扫描范围的左边界fTop扫描范围的上边界fRight扫描范围的右边界fBottom扫描范围的下边界注解设置扫描范围，单位英寸27. TW_INT16 Twa in Filter(HTwain hTwai n, LPMSG IpMsg);返回值驱动程序返回的消息MSG_XFERREAD驱动程序已准备好进行数据传输MSG_CLOSEDSREQ参

16、数hTwai n扫描仪句柄lpMsg窗口消息注解将窗口消息传递给下层驱动程序，并返回状态值。五. ImageRWSB.dll 接口说明该DLL的接口以类的形式提供给用户ClmageRW类成员构造函数ClmageRW();ClmageRW(c on st char* file name); CImageRW();属性DWORD GetlmageSize(co nst char* file name);返回值影像文件的大小，即有多少个字节单位参数file name字符串指针注解得到影像文件的大小VOID GetLastErrorMessage(char* szBuf);返回值参数szBuf字符串指

17、针注解得到最后的错误信息执行函数BOOL WriteImage (co nst char* file name, LPBITMAPINFO pI nfo,LPBYTE pData);返回值成功TRUE,失败FALSE参数file namePage 19 of 1820-2-20BenQ明基BenQ版权所有 2003保留所有权利字符串指针，指向一个欲生成的影像文件的完全路径名pl nfoBITMAPINFO 的结构指针pData指向一个DIB的指针注解根据文件路径名及扩展名，生成指定格式的图形文件。提供的文件格式有BMP, PCX, JPG, TIF,TGA, PNG.BOOL Readlmag

18、e(co nst char* file name,LPBITMAPINFO pin fo,LPBYTE pData);返回值成功TRUE,失败FALSE参数file name字符串指针，指向一个欲读取的影像文件的完全路径名pI nfoBITMAPINFO的结构指针pData指向一个DIB的指针，当该指针为空时将只返回pInfo的信息注解根据文件路径名及扩展名，读取指定格式的图形文件。支持的文件格式有BMP, PCX, JPG, TIF,TGA, PNG.五.明基BenQ版权所有2003保留所有权利.所有内容如有变化，恕不另行通告所有其它提及之品牌名称、产品或公司名称的注册商标权归原公司所有明基BenQ版权所有 2003保留所有权利.附：明基扫描仪驱动软件开发包使用授权书下载使用之前请仔细阅读下列文字！很重要-在下载使用本站提供的任何文档和程序之前请仔细阅读本文！下载或使用任何