20-1-29 明基BenQ版權所有2003 保留所有權利.明基掃描儀二次開發包使用說明明基電通信息技術有限公司營銷總部目錄一，功能說明（3-3）二，要求說明（3-3）三，開發包文件結構說明（3-4）四，scan.Dll接口說明（4-15）五，ImageRWSB.dll 接口說明（15-17）附件：使用授權協議明基BenQ版權所有2003 保留所有權利. 所有內容如有變化，恕不另行通告. 所有其它提及之品牌名稱、 產品或公司名稱的注冊商標權歸原公司所有.一 功能說明本開發包是為明基掃描儀專門提供的，可以讓用戶進行二次開發的開發包。該開發包是用VC+ 6.0開發的動態連接庫(scan.dll)。接口簡單，調用方便，讓您可以在最短的時間內實現對明基掃描儀的功能定制。另外，本開發包還提供給用戶明基自行開發的影像文件讀寫庫（ImageRW.dll）,提供了多種影像格式的支持，讓您可以方便的將掃描得到的影像數據存成各種格式（支持的文件格式有BMP, PCX, JPG, TIF, TGA, PNG）的影像文件。本開發包內還附有開發例程，即使你一點都不了解掃描儀的驅動過程， 也能在很短的時間里定制出符合你要求的應用程序（當然，你需要有一定的VC+編程能力）， 比如說能在某個特定的區域內用特定的分辨率進行掃描。該例程還提供了如何使用漢王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 接口說明該DLL的接口以類的形式提供給用戶CImageRW 類成員 構造函數 CImageRW(); CImageRW(const char* filename); CImageRW();屬性DWORD GetImageSize(const char* filename);返回值影像文件的大小，即有多少個字節單位 參數 filename 字符串指針注解得到影像文件的大小VOID GetLastErrorMessage(char* szBuf);返回值參數 szBuf 字符串指針注解得到最后的錯誤信息執行函數BOOL WriteImage (const char* filename, LPBITMAPINFO pInfo,LPBYTE pData);返回值成功TRUE, 失敗FALSE 參數filename 字符串指針, 指向一個欲生成的影像文件的完全路徑名pInfo BITMAPINFO的結構指針pData 指向一個DIB的指針注解根據文件路徑名及擴展名，生成指定格式的圖形文件。提供的文件格式有BMP, PCX, JPG, TIF, TGA, PNG.BOOL ReadImage(const char* filename,LPBITMAPINFO pInfo,LPBYTE pData);返回值成功TRUE, 失敗FALSE 參數filename 字符串指針, 指向一個欲讀取的影像文件的完全路徑名pInfo BITMAPINFO的結構指針pData 指向一個DIB的指針，當該指針為空時將只返回pInfo的信息注解根據文件路徑名及擴展名，讀取指定格式的圖形文件。支持的文件格式有BMP, PCX, JPG, TIF, TGA, PNG.明基BenQ版權所有2003 保留所有權利. 所有內容如有變化，恕不另行通告. 所有其它提及之品牌名稱、 產品或公司名稱的注冊商標權歸原公司所有.附：明基掃描儀驅動軟件開發包使用授權書下載使用之前請仔細閱讀下列文字！ 很重要在下載使用本站提供的任何文檔和程序之前請仔細閱讀本文！下載或使用任何程序或文檔即表示你已經同意此協議。如果不同意此協議，請不要下載使用本站提供的任何程序或是在線文檔，并刪除已經下載之任何資料和數據。 軟件授權協議 明基電通信息技術有限公司（簡稱“明基BenQ”）根據如下的協議授權你按照本協議下載使用本站提供的程序和在線文檔！ 協議在此協議下，你被明基BenQ授權使用本站提供的程序和文檔，但僅限于隨明基BenQ產品使用，禁止用于其它任何商業用途，禁止再次授權或分發。 你同意不更改或反編譯任何程序和文件的部分或全部，除非得到明基BenQ事先的書面授權或特別申明許可。 你同意不在本協議框架范圍外下載使用本站提供的程序和文檔。 此協議在正式終止前將一直有效。如果你要終止此協議請向明基BenQ提供書