?

?

明基掃描儀二次開(kāi)發(fā)包

使用說(shuō)明

?

?

?

?

?

?

?

?

?

明基電通信息技術(shù)有限公司·營(yíng)銷總部

0512-68251233-2888

目錄

一，功能說(shuō)明（3-3）

二，要求說(shuō)明（3-3）

三，開(kāi)發(fā)包文件結(jié)構(gòu)說(shuō)明（3-4）

四，scan.Dll接口說(shuō)明（4-15）

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

?

一．?? 功能說(shuō)明
本開(kāi)發(fā)包是為明基掃描儀專門提供的，可以讓用戶進(jìn)行二次開(kāi)發(fā)的開(kāi)發(fā)包。該開(kāi)發(fā)包是用VC++ 6.0開(kāi)發(fā)的動(dòng)態(tài)連接庫(kù)(scan.dll)。接口簡(jiǎn)單，調(diào)用方便，讓您可以在最短的時(shí)間內(nèi)實(shí)現(xiàn)對(duì)明基掃描儀的功能定制。另外，本開(kāi)發(fā)包還提供給用戶明基自行開(kāi)發(fā)的影像文件讀寫庫(kù)（ImageRW.dll）,提供了多種影像格式的支持，讓您可以方便的將掃描得到的影像數(shù)據(jù)存成各種格式（支持的文件格式有BMP, PCX, JPG, TIF, TGA, PNG）的影像文件。本開(kāi)發(fā)包內(nèi)還附有開(kāi)發(fā)例程，即使你一點(diǎn)都不了解掃描儀的驅(qū)動(dòng)過(guò)程， 也能在很短的時(shí)間里定制出符合你要求的應(yīng)用程序（當(dāng)然，你需要有一定的VC++編程能力）， 比如說(shuō)能在某個(gè)特定的區(qū)域內(nèi)用特定的分辨率進(jìn)行掃描。該例程還提供了如何使用漢王OCR實(shí)現(xiàn)文字識(shí)別的演示。

使用這個(gè)開(kāi)發(fā)包，他們可以實(shí)現(xiàn)對(duì)掃描儀的自主操控，如自行控制預(yù)覽、掃描的位置、掃描分辨率色彩等各項(xiàng)參數(shù)，甚至還提供了常見(jiàn)的幾種圖形文件格式的讀寫，讓客戶很方便的實(shí)現(xiàn)掃描儀的控制以及圖像的讀寫操作，把更多的時(shí)間用于整個(gè)控制管理系統(tǒng)中更具應(yīng)用價(jià)值的部分。

正因?yàn)槎伍_(kāi)發(fā)包具備非常高的可擴(kuò)展性，所以適用于多種行業(yè)多種應(yīng)用。比如：數(shù)字圖書館和數(shù)字化檔案館等，如果再配合上光學(xué)文字識(shí)別軟件（OCR）等專門處理軟件，應(yīng)用的領(lǐng)域更大，如：旅店業(yè)身份識(shí)別、機(jī)場(chǎng)及出入境身份識(shí)別、警（軍）用活體指紋、指紋錄入、考勤、錄入工廠、銀行金融票據(jù)、稅務(wù)、交通、工程測(cè)繪、地質(zhì)考古、公安戶籍等等以及行業(yè)信息化數(shù)字化領(lǐng)域。在這些領(lǐng)域里，通用掃描控制根本沒(méi)有用武之地，所有的應(yīng)用系統(tǒng)都需要量身定制、需要靈活自如的控制，這些都只能基于二次開(kāi)發(fā)包的高擴(kuò)展性。

二．?? 要求說(shuō)明

此開(kāi)發(fā)包需要配合明基提供之掃描儀設(shè)備以及設(shè)備驅(qū)動(dòng)程序方可使用，使用前，請(qǐng)確認(rèn)掃描儀設(shè)備已經(jīng)正確安裝并工作。

三．?? 開(kāi)發(fā)包文件結(jié)構(gòu)說(shuō)明

SDK:? 根目錄
/Include: 頭文件目錄（需要把該目錄添加到你得VC開(kāi)發(fā)環(huán)境中）
?????? TwainExport.h: scan.dll的接口定義
?????? twain.h： 標(biāo)準(zhǔn)影像設(shè)備數(shù)據(jù)結(jié)構(gòu)類型定義
?????? ImageRW.h：??? 圖像文件讀寫接口定義
/library:? 庫(kù)文件目錄（需要把該目錄添加到你得VC開(kāi)發(fā)環(huán)境中）
?????? ImgRWSB.lib：圖像文件讀寫接口庫(kù)
/Src: 源文件目錄
?????? TwainExport.cpp：
/Bin: 動(dòng)態(tài)連接庫(kù)目錄
??????? Scan.dll：????? 掃描儀驅(qū)動(dòng)接口動(dòng)態(tài)連接庫(kù)
???????? Formatdll.dll?? 圖像文件讀寫動(dòng)態(tài)連接庫(kù)
/Sample: 例程目錄
???????? VC++ 例程
/document: 說(shuō)明文件目錄
???????? 明基掃描儀開(kāi)發(fā)包說(shuō)明.doc:? 本說(shuō)明文件

?

?

四．?? Scan.dll接口說(shuō)明
初始化函數(shù)
1. HINSTANCE InitTwainDLL(LPCTSTR szDLLName);

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

參數(shù)
szDllName
???????? 指向scan.dll的絕對(duì)路徑名

注解
該接口函數(shù)必須第一個(gè)被調(diào)用成功，如果調(diào)用失敗請(qǐng)檢查路徑名是否書寫正確，或文件是否真的存在。


?2. VOID FreeTwainDLL(HINSTANCE hInst);??

返回值
無(wú)

參數(shù)
?hInst
????????? Scan.dll的句柄。

注解
該函數(shù)必須在程序推出時(shí)被調(diào)用，釋放scan.dll資源。


3. VOID? NewTwain (Htwain * phTwain);?

返回值
無(wú)

參數(shù)
?phTwain
????????? 指向掃描儀句柄的指針

注解
創(chuàng)建控制明基掃描儀的句柄

4. VOID? FreeTwainDLL(HTwain hTwain);

返回值
無(wú)

參數(shù)
?hTwain
????????? 掃描儀句柄

注解
創(chuàng)建控制明基掃描儀的句柄






5. BOOL? LoadSM (HTwain hTwain);

返回值
成功TRUE, 失敗FALSE

參數(shù)
?hTwain
????????? 掃描儀句柄

注解
載入驅(qū)動(dòng)管理器

6.? BOOL? UnloadSM (HTwain hTwain);

返回值
成功TRUE, 失敗FALSE

參數(shù)
?hTwain
????????? 掃描儀句柄

注解
卸載驅(qū)動(dòng)管理器

7. BOOL OpenSM (HTwain hTwain);

返回值
成功TRUE, 失敗FALSE

參數(shù)
?hTwain
????????? 掃描儀句柄

注解
打開(kāi)驅(qū)動(dòng)管理器

8. BOOL CloseSM (HTwain hTwain);

返回值
成功TRUE, 失敗FALSE

參數(shù)
?hTwain
????????? 掃描儀句柄

注解
關(guān)閉驅(qū)動(dòng)管理器
9. BOOL OpenDS (HTwain hTwain);

返回值
成功TRUE, 失敗FALSE

參數(shù)
?hTwain
????????? 掃描儀句柄

注解
打開(kāi)驅(qū)動(dòng)程序

10. BOOL CloseDS (HTwain hTwain);

返回值
成功TRUE, 失敗FALSE

參數(shù)
?hTwain
????????? 掃描儀句柄

注解
關(guān)閉驅(qū)動(dòng)程序

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

返回值
成功TRUE, 失敗FALSE

參數(shù)
?hTwain
????????? 掃描儀句柄
bIsShowUI
????????? TRUE: 顯示驅(qū)動(dòng)程序界面， FALSE: 不顯示
hWnd
????????? 驅(qū)動(dòng)程序父窗口句柄

注解
透過(guò)驅(qū)動(dòng)程序進(jìn)行掃描



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

返回值
成功TRUE, 失敗FALSE

參數(shù)
?hTwain
????????? 掃描儀句柄
bIsShowUI
????????? TRUE:驅(qū)動(dòng)程序以打開(kāi)界面， FALSE: 沒(méi)有打開(kāi)
hWnd
????? ????驅(qū)動(dòng)程序父窗口句柄

注解
使驅(qū)動(dòng)程序掃描無(wú)效


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

返回值
成功TRUE, 失敗FALSE

參數(shù)
?hTwain
????????? 掃描儀句柄
lpBmpInfo
????????? 指向一個(gè)BMP位圖的頭信息結(jié)構(gòu)
lpData
????????? 指向存放DIB數(shù)據(jù)空間的指針
lpScanData
?????????? 保留

注解
進(jìn)行數(shù)據(jù)傳送



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

參數(shù)
?hTwain
????????? 掃描儀句柄
chDrvName
????????? 指向一個(gè)字符串，將返回掃描儀驅(qū)動(dòng)程序名稱
lpszNameFilter
?????????? 保留

注解
得到默認(rèn)的掃描儀驅(qū)動(dòng)程序的名稱

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

參數(shù)
?hTwain
????????? 掃描儀句柄
chDrvName
????????? 指向一個(gè)字符串，將返回掃描儀驅(qū)動(dòng)程序名稱
lpszNameFilter
?????????? 保留

注解
得到第一個(gè)掃描儀驅(qū)動(dòng)程序的名稱

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

參數(shù)
?hTwain
????????? 掃描儀句柄
chDrvName
????????? 指向一個(gè)字符串，將返回掃描儀驅(qū)動(dòng)程序名稱
lpszNameFilter
?????????? 保留

注解
得到下一個(gè)掃描儀驅(qū)動(dòng)程序的名稱
17. BOOL GetCapImageType(HTwain hTwain, int &type);
返回值
成功TRUE, 失敗FALSE

參數(shù)
?hTwain
????????? 掃描儀句柄
&type
????????? 將返回影像類型
?
注解
得到影像類型
TWPT_BW???????? 黑白
TWPT_GRAY??? 灰度
TWPT_RGB??????? 彩色

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

參數(shù)
?hTwain
????????? 掃描儀句柄
type
???? ?????影像類型
?
注解
設(shè)置掃描的影像類型
TWPT_BW???????? 黑白
TWPT_GRAY??? 灰度
TWPT_RGB??????? 彩色

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

參數(shù)
?hTwain
????????? 掃描儀句柄
&tmin
????????? 返回一個(gè)最小的分辨率
&tmax
?????????? 返回一個(gè)最大的分辨率

注解
得到掃描儀的掃描分辨率的范圍
20. BOOL SetCapXRes(HTwain hTwain, int res);
返回值
成功TRUE, 失敗FALSE

參數(shù)
?hTwain
????????? 掃描儀句柄
res
????????? 掃描分辨率
注解
設(shè)置掃描儀橫向的掃描分辨率

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

參數(shù)
?hTwain
????????? 掃描儀句柄
res
????????? 掃描分辨率
注解
設(shè)置掃描儀縱向的掃描分辨率

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

參數(shù)
?hTwain
????????? 掃描儀句柄
&tmin
????????? 返回一個(gè)最小的縮放比例
&tmax
?????????? 返回一個(gè)最大的縮放比例

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

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

參數(shù)
?hTwain
????????? 掃描儀句柄
scale
????????? 縮放比例
?
注解
設(shè)置影像橫向的縮放比例

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

參數(shù)
?hTwain
????????? 掃描儀句柄
scale
????????? 縮放比例
?
注解
設(shè)置影像縱向的縮放比例




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

參數(shù)
?hTwain
????????? 掃描儀句柄
&tright
????????? 返回一個(gè)最大掃描的寬度，單位英寸
&tbottom
?????????? 返回一個(gè)最大掃描的高度，單位英寸

注解
得到掃描儀的最大掃描范圍



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

參數(shù)
?hTwain
????????? 掃描儀句柄
fLeft
????????? 掃描范圍的左邊界
fTop
???????? 掃描范圍的上邊界?
fRight
???????? 掃描范圍的右邊界
fBottom
???????? 掃描范圍的下邊界
注解
設(shè)置掃描范圍，單位英寸

27. TW_INT16 TwainFilter(HTwain hTwain, LPMSG lpMsg);
返回值
驅(qū)動(dòng)程序返回的消息
MSG_XFERREADY：驅(qū)動(dòng)程序已準(zhǔn)備好進(jìn)行數(shù)據(jù)傳輸
MSG_CLOSEDSREQ：
參數(shù)
?hTwain
????????? 掃描儀句柄
lpMsg
???????? 窗口消息
注解
將窗口消息傳遞給下層驅(qū)動(dòng)程序，并返回狀態(tài)值。

五．? ImageRWSB.dll 接口說(shuō)明（略）

（完）

總結(jié)

以上是生活随笔為你收集整理的明基扫描仪二次开发包的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。