從 TWAIN 設備中掃描圖像

轉自（http://yonsm.net/scan-images-from-a-twain-device/）

1、簡介

TWAIN 數據源管理程序 (DSM) 工業標準的軟件庫，用於從靜態圖像設備提取圖像。絕大部分的掃描儀和數碼相機都提供了 TWAIN 驅動程序，利用統一的 TWAIN 接口，應用程序能夠很是方便地從這些設備中獲取圖像。

 

2、使用步驟

互聯網上關於 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
);

　　

1. 打開 DSM (Data Source Manager: 數據源管理器)

TWAIN 是一個數據源管理程序，應用程序首先要使用 MSG_OPENDSM 消息，打開數據源管理器。這裏須要指定一個窗口句柄，應用程序應該在此窗口的消息循環中處理 TWAIN 消息 (MSG_PROCESSEVENT)。

1. 選擇 DS (Data Source: 數據源)

由於一個系統中可能存在多個 TWAIN 設備，所以必須選擇一個數據源。選擇數據源一般有兩種方式: 選擇默認數據源 (MSG_GETDEFAULT) 和顯示選擇數據源對話框，由用戶來選擇數據源 (MSG_USERSELECT)。

1. 打開 DS

使用 MSG_OPENDS 消息打開數據源。

1. 設置參數

消息爲 MSG_SET，設置各類參數，如獲取方式、圖像數量等。有些參數由設備驅動支持纔有效。

1. 顯示掃描界面

使用 MSG_ENABLEDS 消息，顯示設備驅動提供的用戶界面 (UI)。

1. 獲取圖像

若是用戶選擇掃描什麼的，能夠在窗口的消息循環中獲取到這個事件 (MSG_XFERREADY)。此時，應用程序能夠經過 DAT_SETUPFILEXFER 設置文件名，而後用 DAT_IMAGEFILEXFER 獲取圖像到文件中。

1. 關閉掃描界面

在窗口的消息循環中獲取到 MSG_CLOSEDSREQ 或 MSG_CLOSEDSOK 消息，能夠關閉掃描界面 (MSG_DISABLEDS)。

1. 關閉 DS

消息爲 MSG_CLOSEDS。

1. 關閉數據源

消息爲 MSG_CLOSEDSM。

 

3、CTwainHelper 助手類

爲了使用方便，我寫了一個靜態 TWAIN 助手類 CTwainHelper。使用 CTwainHelper 的五個函數，就能夠簡單地從 TWAIN 設備獲取圖像到文件中。使用方法以下:

1. 調用 CTwainHelper::Initialize() 肯定是否有可用的設備。
2. 在窗口消息循環中，調用 CTwainHelper::ProcessMessage() 處理 TWAIN 消息。
3. 要獲取圖像時，調用 CTwainHelper::GetImage()。
4. 若是圖像已準備好 (如用戶肯定掃描圖像)，窗口會收到 WM_COMMAND 消息，wParam 爲 IDC_TwainHelper。此時應用程序能夠調用 CTwainHelper::TransferImage() 獲取圖像到文件中。

具體使用方法請參看示例代碼。

CTwainHelper 能夠在 Visual C++ 6.x/7.x 工程中使用，支持 UNICODE 編譯。由於是靜態類，要改寫成 C 代碼只須要作一點點少許的工做。

4、後話

固然，上面只是一種經常使用的步驟。其實應用程序徹底能夠自定義全部的步驟，好比不使用 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對話框徹底關閉後纔會返回，適合任何場合使用：