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

1、BenQ明基BenQ版權(quán)所有 2003保留所有權(quán)利.20-2-20明基掃描儀二次開(kāi)發(fā)包使用說(shuō)明明基電通信息技術(shù)有限公司？營(yíng)銷總部目錄一，功能說(shuō)明（3-3 ）二，要求說(shuō)明（3-3 ）三，開(kāi)發(fā)包文件結(jié)構(gòu)說(shuō)明（3-4）四，sean.DII 接口說(shuō)明（4-15）五, ImageRWSB.dll 接口說(shuō)明（15-17）附件：使用授權(quán)協(xié)議明基BenQ版權(quán)所有2003保留所有權(quán)利.所有內(nèi)容如有變化，恕不另行通告所有其它提及之品牌名稱、產(chǎn)品或公司名稱的注冊(cè)商標(biāo)權(quán)歸原公司所有功能說(shuō)明本開(kāi)發(fā)包是為明基掃描儀專門(mén)提供的，可以讓用戶進(jìn)行二次開(kāi)發(fā)的開(kāi)發(fā)包。該開(kāi)發(fā)包是用VC+6.0開(kāi)發(fā)的動(dòng)態(tài)連接庫(kù)（sean.dll）。接

2、口簡(jiǎn)單，調(diào)用方便，讓您可以在最短的時(shí)間內(nèi)實(shí)現(xiàn)對(duì)明基掃描儀的功能定制。另外，本開(kāi)發(fā)包還提供給用戶明基自行開(kāi)發(fā)的影像文件讀寫(xiě)庫(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í)別的演示。要求說(shuō)明此開(kāi)發(fā)包需要配合明基提供

3、之掃描儀設(shè)備以及設(shè)備驅(qū)動(dòng)程序方可使用，使用前，請(qǐng)確認(rèn)掃 描儀設(shè)備已經(jīng)正確安裝并工作。三. 開(kāi)發(fā)包文件結(jié)構(gòu)說(shuō)明SDK:根目錄In clude:頭文件目錄（需要把該目錄添加到你得VC開(kāi)發(fā)環(huán)境中）Twain Export.h: sca n. dll的接口定義twai n.h:標(biāo)準(zhǔn)影像設(shè)備數(shù)據(jù)結(jié)構(gòu)類型定義ImageRW.h :圖像文件讀寫(xiě)接口定義library:庫(kù)文件目錄（需要把該目錄添加到你得VC開(kāi)發(fā)環(huán)境中）ImgRWSB.lib :圖像文件讀寫(xiě)接口庫(kù)Src:源文件目錄Twain Export.cpp :Bi n:動(dòng)態(tài)連接庫(kù)目錄Sca n. dll:掃描儀驅(qū)動(dòng)接口動(dòng)態(tài)連接庫(kù)Formatdll.dll

4、圖像文件讀寫(xiě)動(dòng)態(tài)連接庫(kù)Sample: 例程目錄Page 3 of 18BenQ明基BenQ版權(quán)所有 2003保留所有權(quán)利.20-2-20明基BenQ版權(quán)所有 2003保留所有權(quán)利VC+ 例程docume nt: 說(shuō)明文件目錄明基掃描儀開(kāi)發(fā)包說(shuō)明.doc:本說(shuō)明文件四. Sca n.dll 接口說(shuō)明初始化函數(shù)1. HINSTANCE InitTwainDLL(LPCTSTR szDLLName);返回值如果成功返回Sca n.dll的句柄，失敗為 NULL。參數(shù)szDllName指向scan.dll的絕對(duì)路徑名注解該接口函數(shù)必須第一個(gè)被調(diào)用成功，如果調(diào)用失敗請(qǐng)檢查路徑名是否書(shū)寫(xiě)正確，或文件是否真

5、的存在。2. VOID FreeTwa in DLL(HINSTANCE hln st);返回值無(wú)參數(shù)hI nstSca n.dll的句柄。注解該函數(shù)必須在程序推岀時(shí)被調(diào)用，釋放sca n.dll 資源3. VOID NewTwa in (Htwa in * phTwai n);返回值無(wú)參數(shù)phTwa in指向掃描儀句柄的指針注解創(chuàng)建控制明基掃描儀的句柄4. VOID FreeTwai nDLL(HTwai n hTwai n);返回值無(wú)參數(shù)hTwai n掃描儀句柄注解創(chuàng)建控制明基掃描儀的句柄5. BOOL LoadSM (HTwa in hTwai n);返回值成功TRUE,失敗FALSE參

6、數(shù)hTwai n掃描儀句柄注解載入驅(qū)動(dòng)管理器6. BOOL Un loadSM (HTwa in hTwai n);返回值成功TRUE,失敗FALSE參數(shù)hTwai n掃描儀句柄注解卸載驅(qū)動(dòng)管理器7. BOOL Ope nSM (HTwa in hTwai n);返回值成功TRUE,失敗FALSE參數(shù)hTwai n掃描儀句柄注解打開(kāi)驅(qū)動(dòng)管理器8. BOOL CloseSM (HTwa in hTwai n);返回值成功TRUE,失敗FALSE參數(shù)hTwai n掃描儀句柄注解關(guān)閉驅(qū)動(dòng)管理器9. BOOL Ope nDS (HTwai n hTwai n);返回值成功TRUE,失敗FALSE參數(shù)h

7、Twai n掃描儀句柄注解打開(kāi)驅(qū)動(dòng)程序10. BOOL CloseDS (HTwa in hTwai n);返回值成功TRUE,失敗FALSE參數(shù)hTwai n掃描儀句柄注解關(guān)閉驅(qū)動(dòng)程序Page 8 of 18BenQ明基BenQ版權(quán)所有 2003保留所有權(quán)利.20-2-20明基BenQ版權(quán)所有 2003保留所有權(quán)利.11. BOOL En ableDS (HTwa in hTwai n, BOOL blsShowUI, HWND hWnd);返回值成功TRUE,失敗FALSE參數(shù)hTwai n掃描儀句柄bIsShowUITRUE:顯示驅(qū)動(dòng)程序界面， FALSE:不顯示hWnd驅(qū)動(dòng)程序父窗口句

8、柄注解透過(guò)驅(qū)動(dòng)程序進(jìn)行掃描12. BOOL DisableDS (HTwa in hTwa in, BOOL bIsShowUI, HWND hWnd);返回值成功TRUE,失敗FALSE參數(shù)hTwai n掃描儀句柄bIsShowUITRUE:驅(qū)動(dòng)程序以打開(kāi)界面，F(xiàn)ALSE:沒(méi)有打開(kāi)hWnd驅(qū)動(dòng)程序父窗口句柄注解使驅(qū)動(dòng)程序掃描無(wú)效13. BOOL DoMemXfer(HTwa in hTwai n, LPBITMAPINFO IpBmpI nfo, LPBYTE IpData, LPSCANDATAIpSca nData);返回值成功TRUE,失敗FALSE參數(shù)hTwai n掃描儀句柄lpBm

9、pI nfo指向一個(gè)BMP位圖的頭信息結(jié)構(gòu)lpData指向存放DIB數(shù)據(jù)空間的指針lpSca nData保留注解進(jìn)行數(shù)據(jù)傳送14. BOOL GetDefaultDriverName(HTwa inhTwa in,char *chDrvName, LPCSTRlpszNameFilter/*=NULL*/);返回值成功TRUE,失敗FALSE參數(shù)hTwai n掃描儀句柄chDrvName指向一個(gè)字符串，將返回掃描儀驅(qū)動(dòng)程序名稱lpszNameFilter保留注解得到默認(rèn)的掃描儀驅(qū)動(dòng)程序的名稱15. BOOL GetFirstDriverName(HTwainhTwai n, char *chD

10、rvName, LPCSTRlpszNameFilter/*=NULL*/);返回值成功TRUE,失敗FALSE參數(shù)hTwai n掃描儀句柄chDrvName指向一個(gè)字符串，將返回掃描儀驅(qū)動(dòng)程序名稱lpszNameFilter保留注解得到第一個(gè)掃描儀驅(qū)動(dòng)程序的名稱16. BOOLGetNextDriverName)(HTwai nhTwai n, char *chDrvName, LPCSTRlpszNameFilter/*=NULL*/);返回值成功TRUE,失敗FALSE參數(shù)hTwai n掃描儀句柄chDrvName指向一個(gè)字符串，將返回掃描儀驅(qū)動(dòng)程序名稱lpszNameFilter保留注

11、解Page 12 of 18BenQ明基BenQ版權(quán)所有 2003保留所有權(quán)利.20-2-20明基BenQ版權(quán)所有 2003保留所有權(quán)利. 得到下一個(gè)掃描儀驅(qū)動(dòng)程序的名稱17. BOOL GetCaplmageType(HTwain hTwai n, i nt &type);返回值成功TRUE,失敗FALSE參數(shù)hTwai n掃描儀句柄&type將返回影像類型注解得到影像類型TWPT_BW黑白TWPT_GRAY 灰度TWPT_RGB彩色18. BOOL SetCaplmageType(HTwain hTwai n, int type);返回值成功TRUE,失敗FALSE參數(shù)hTwai n掃描儀

12、句柄type影像類型注解設(shè)置掃描的影像類型TWPT_BW黑白TWPT_GRAY 灰度TWPT_RGB彩色19. BOOL GetResRange(HTwain hTwain, int &tmin,int &tmax);返回值成功TRUE,失敗FALSE參數(shù)hTwai n掃描儀句柄&tmi n返回一個(gè)最小的分辨率&tmax返回一個(gè)最大的分辨率注解得到掃描儀的掃描分辨率的范圍20. BOOL SetCapXRes(HTwai n hTwai n, i nt res);返回值成功TRUE,失敗FALSE參數(shù)hTwai n掃描儀句柄res掃描分辨率注解設(shè)置掃描儀橫向的掃描分辨率21. BOOL Set

13、CapYRes(HTwain hTwain, int res);返回值成功TRUE,失敗FALSE參數(shù)hTwai n掃描儀句柄res掃描分辨率注解設(shè)置掃描儀縱向的掃描分辨率22. BOOL GetScaleRa nge(HTwain hTwa in, double & tmi n, double & tmax);返回值成功TRUE,失敗FALSE參數(shù)hTwai n掃描儀句柄&tmi n返回一個(gè)最小的縮放比例&tmax返回一個(gè)最大的縮放比例注解得到影像所反比例的范圍四.23. BOOL SetCapXScale(HTwain hTwai n, float scale);返回值成功TRUE,失敗F

14、ALSE參數(shù)hTwai n掃描儀句柄scale縮放比例注解設(shè)置影像橫向的縮放比例24. BOOL SetCapYScale(HTwain hTwai n, float scale);返回值成功TRUE,失敗FALSE參數(shù)hTwai n掃描儀句柄scale縮放比例注解設(shè)置影像縱向的縮放比例25. BOOL GetMaxScanArea(HTwain hTwain, float &tright,float &tbottom);返回值成功TRUE,失敗FALSE參數(shù)hTwai n掃描儀句柄&tright返回一個(gè)最大掃描的寬度，單位英寸&tbottom返回一個(gè)最大掃描的高度，單位英寸注解得到掃描儀的最

15、大掃描范圍26. BOOLSetScanSize(HTwainhTwain, float fLeft, float fTop, float fRight, float fBottom);返回值成功TRUE,失敗FALSE參數(shù)hTwai n掃描儀句柄fLeft掃描范圍的左邊界fTop掃描范圍的上邊界fRight掃描范圍的右邊界fBottom掃描范圍的下邊界注解設(shè)置掃描范圍，單位英寸27. TW_INT16 Twa in Filter(HTwain hTwai n, LPMSG IpMsg);返回值驅(qū)動(dòng)程序返回的消息MSG_XFERREAD驅(qū)動(dòng)程序已準(zhǔn)備好進(jìn)行數(shù)據(jù)傳輸MSG_CLOSEDSREQ參

16、數(shù)hTwai n掃描儀句柄lpMsg窗口消息注解將窗口消息傳遞給下層驅(qū)動(dòng)程序，并返回狀態(tài)值。五. ImageRWSB.dll 接口說(shuō)明該DLL的接口以類的形式提供給用戶ClmageRW類成員構(gòu)造函數(shù)ClmageRW();ClmageRW(c on st char* file name); CImageRW();屬性DWORD GetlmageSize(co nst char* file name);返回值影像文件的大小，即有多少個(gè)字節(jié)單位參數(shù)file name字符串指針注解得到影像文件的大小VOID GetLastErrorMessage(char* szBuf);返回值參數(shù)szBuf字符串指

17、針注解得到最后的錯(cuò)誤信息執(zhí)行函數(shù)BOOL WriteImage (co nst char* file name, LPBITMAPINFO pI nfo,LPBYTE pData);返回值成功TRUE,失敗FALSE參數(shù)file namePage 19 of 1820-2-20BenQ明基BenQ版權(quán)所有 2003保留所有權(quán)利字符串指針，指向一個(gè)欲生成的影像文件的完全路徑名pl nfoBITMAPINFO 的結(jié)構(gòu)指針pData指向一個(gè)DIB的指針注解根據(jù)文件路徑名及擴(kuò)展名，生成指定格式的圖形文件。提供的文件格式有BMP, PCX, JPG, TIF,TGA, PNG.BOOL Readlmag

18、e(co nst char* file name,LPBITMAPINFO pin fo,LPBYTE pData);返回值成功TRUE,失敗FALSE參數(shù)file name字符串指針，指向一個(gè)欲讀取的影像文件的完全路徑名pI nfoBITMAPINFO的結(jié)構(gòu)指針pData指向一個(gè)DIB的指針，當(dāng)該指針為空時(shí)將只返回pInfo的信息注解根據(jù)文件路徑名及擴(kuò)展名，讀取指定格式的圖形文件。支持的文件格式有BMP, PCX, JPG, TIF,TGA, PNG.五.明基BenQ版權(quán)所有2003保留所有權(quán)利.所有內(nèi)容如有變化，恕不另行通告所有其它提及之品牌名稱、產(chǎn)品或公司名稱的注冊(cè)商標(biāo)權(quán)歸原公司所有明基BenQ版權(quán)所有 2003保留所有權(quán)利.附：明基掃描儀驅(qū)動(dòng)軟件開(kāi)發(fā)包使用授權(quán)書(shū)下載使用之前請(qǐng)仔細(xì)閱讀下列文字！很重要-在下載使用本站提供的任何文檔和程序之前請(qǐng)仔細(xì)閱讀本文！下載或使用任何