轉自(http://yonsm.net/scan-images-from-a-twain-device/)
一、簡介
TWAIN 數據源管理程序 (DSM) 工業標准的軟件庫,用於從靜態圖像設備提取圖像。絕大部分的掃描儀和數碼相機都提供了 TWAIN 驅動程序,利用統一的 TWAIN 接口,應用程序可以非常方便地從這些設備中獲取圖像。
二、使用步驟
互聯網上關於 TWAIN 編程的中文資料很少,代碼更是難找到,因為我不得不仔細閱讀了 http://www.twain.org/ 提供的 TWAIN Specification。下面說說使用 TWAIN 接口獲取圖像的簡要步驟。
Windows 系統中存在一個 TWAIN_32.dll,所有的 TWAIN 操作都是通過這個 DLL 導出的 DSM_Entry 函數來實現的 (說實在話,我個人覺得 TWAIN 接口設計得太差了,看看 MS 的WIA,邏輯上非常清晰)。這個函數的聲明如下:
TW_UINT16 FAR PASCAL DSM_Entry( pTW_IDENTITY pOrigin, // Source of message pTW_IDENTITY pDest, // Destination of message TW_UINT32 DG, // Data group ID: DG_xxxx TW_UINT16 DAT, // Data argument type: DAT_xxxx TW_UINT16 MSG, // Message ID: MSG_xxxx TW_MEMREF pData // Pointer to data );
- 打開 DSM (Data Source Manager: 數據源管理器)
TWAIN 是一個數據源管理程序,應用程序首先要使用 MSG_OPENDSM 消息,打開數據源管理器。這里需要指定一個窗口句柄,應用程序應該在此窗口的消息循環中處理 TWAIN 消息 (MSG_PROCESSEVENT)。
- 選擇 DS (Data Source: 數據源)
因為一個系統中可能存在多個 TWAIN 設備,因此必須選擇一個數據源。選擇數據源通常有兩種方式: 選擇默認數據源 (MSG_GETDEFAULT) 和顯示選擇數據源對話框,由用戶來選擇數據源 (MSG_USERSELECT)。
- 打開 DS
使用 MSG_OPENDS 消息打開數據源。
- 設置參數
消息為 MSG_SET,設置各種參數,如獲取方式、圖像數量等。有些參數由設備驅動支持才有效。
- 顯示掃描界面
使用 MSG_ENABLEDS 消息,顯示設備驅動提供的用戶界面 (UI)。
- 獲取圖像
如果用戶選擇掃描什么的,可以在窗口的消息循環中獲取到這個事件 (MSG_XFERREADY)。此時,應用程序可以通過 DAT_SETUPFILEXFER 設置文件名,然后用 DAT_IMAGEFILEXFER 獲取圖像到文件中。
- 關閉掃描界面
在窗口的消息循環中獲取到 MSG_CLOSEDSREQ 或 MSG_CLOSEDSOK 消息,可以關閉掃描界面 (MSG_DISABLEDS)。
- 關閉 DS
消息為 MSG_CLOSEDS。
- 關閉數據源
消息為 MSG_CLOSEDSM。
三、CTwainHelper 助手類
為了使用方便,我寫了一個靜態 TWAIN 助手類 CTwainHelper。使用 CTwainHelper 的五個函數,就可以簡單地從 TWAIN 設備獲取圖像到文件中。使用方法如下:
- 調用 CTwainHelper::Initialize() 確定是否有可用的設備。
- 在窗口消息循環中,調用 CTwainHelper::ProcessMessage() 處理 TWAIN 消息。
- 要獲取圖像時,調用 CTwainHelper::GetImage()。
- 如果圖像已准備好 (如用戶確定掃描圖像),窗口會收到 WM_COMMAND 消息,wParam 為 IDC_TwainHelper。此時應用程序可以調用 CTwainHelper::TransferImage() 獲取圖像到文件中。
具體使用方法請參看示例代碼。
CTwainHelper 可以在 Visual C++ 6.x/7.x 工程中使用,支持 UNICODE 編譯。因為是靜態類,要改寫成 C 代碼只需要做一點點少量的工作。
四、后話
當然,上面只是一種常用的步驟。其實應用程序完全可以自定義所有的步驟,比如不使用 TWAIN 驅動提供掃描對話框而直接掃描,或者掃描圖像到內存中等等。詳細情況請參考 TWAIN Specification,步驟大同小異,消息和參數千差萬別,仔細看看應該很容易的。
如果沒有 TWAIN 設備又要進行 TWAIN 程序開發,可以到 TWAIN 官方網站下載 TWAIN Developers Toolkit,安裝后會有一個虛擬的 TWAIN 設備。不過應用程序在這個虛擬 TWAIN 設備中正常工作,不代表一定能在實際的 TWAIN 設備正常使用,這點需要注意。以前 CTwainHelper 就碰到過這樣的情況 在虛擬 TWAIN 設備中明明是好的,在我的掃描儀上卻不能掃描圖像。檢查后發現,原來設置了不支持的參數。
最后,TWAIN 是 Technology Without A Interesting Name 縮寫,直譯為沒有“沒有讓人感興趣名字的技術”,真是一個讓人摸不着頭腦的名字。
TWAIN 助手類: CTwainHelper (包含示例代碼 35K)
TWAIN 官方網站: http://www.twain.org
TWAIN 頭文件: http://www.twain.org/devfiles/twain.h
TWAIN Specification: http://www.twain.org/docs/Spec1_9_197.pdf
TWAIN Developers Toolkit: http://www.twain.org/devfiles/twainkit.exe
[2006.2.22] 下面是更簡單的版本,其中的 GetImage 函數內部自動具有消息循環,直到TWAIN對話框完全關閉后才會返回,適合任何場合使用: