一、TWAIN的文件組成

TWAIN共包括4個二進制文件。如果要使用該接口，就必須要保證他們被成功地安裝在本地計算機上。

?

文 件 名	說 明
TWAIN_32.DLL	32位應用程序的支持文件，32位程序使用TWAIN通訊必須使用該文件。
TWAIN.DLL	16位應用程序的支持文件，16位程序使用TWAIN通訊必須使用該文件。
TWUNKER_32.EXE	實現32位應用程序與32位數據源進行通訊，它運行時不可見。
TWUNKER_16.EXE	實現32位應用程序與16位數據源進行通訊，它運行時不可見。 注意：在Windows NT 環境下16位數據源不能夠正常工作。

?

在Windows 操作系統中(Windows 9x / 2000 / XP )，Microsoft已經把這些文件作為系統文件隨同操作系統一起發布了。你可以在Windows安裝目錄中查找到這些文件。如果我們要編程來實現對TWAIN的訪問，還需要最重要的頭文件。你通過訪問該http://www.twain.org/devfiles/twain.h 地址來獲得TWAIN提供的頭文件。

?

二、TWAIN的結構

TWAIN依靠三個組件協同完成與圖像設備的通訊和數據傳輸工作，這三個組件就是 Application、Source Manager和Source。

?

組件	說明
Application	就是你要編寫的應用程序。
Source Manager	是由TWAIN提供的一個Source的管理器，它不僅可以收集本地系統已經安裝了的圖像設備，還可以根據需要去加載設備。同時，它最重要的功能是擔任Application 與Source通訊的橋梁。（其實，它就是我們前面提到的組成文件中的dll文件。）
Source	在這里可以看作是圖像設備。事實上它是由設備廠家提供的一個dll文件。這個dll文件是支持twain接口的。(該文不討論關于twain在Source中的應用。)

?

它們的層次結構圖如下：

?

?

?

從該圖我們可以看到，Application要從Source獲得圖像數據，必須通過Source Manager傳遞來實現。Application與Source Manager 間的通訊是靠調用TWAIN提供的DSM_Entry( )函數實現。而Application不能直接與Source 通訊，Source Manager與Source 間的通訊是靠調用TWAIN提供的DS_Entry( )函數實現（在這里，我們不用關心Source Manager如何去調用DS_Entry函數。

?

三、TWAIN的用戶界面

當我們使用TWAIN接口去獲得圖像數據的時候，會涉及到一些的用戶界面，首先是我們的應用程序界面，然后是Source Manager提供的用戶界面以及圖像設備(Source)所提供的用戶界面。

?

在我們的應用程序中，可以通過“選擇設備”來打開Source Manager的標準用戶界面。Source Manager的界面由Source Manager提供。在這個界面中可以讓用戶選擇他想要使用的圖像設備。選中想要的設備后，再通過“獲取…”來打開圖像設備（Source）提供的用戶界面進行現應的操作。（注：Source提供的界面會因為你使用的圖像設備不同而有差異。）

對于這些界面，TWAIN提供了非常靈活的處理方法。對于Source Manager提供的用戶界面以及圖像設備(Source)所提供的用戶界面，我們可以選擇是否顯示它們，甚至我們還可以按自己的要求去改寫這些用戶界面。

?

四、TWAIN的接口函數

要編寫應用程序實現與支持TWAIN標準的圖像設備通訊，只需要了解上面提到的DSM_Entry()接口函數。TWAIN定義了大約140個操作消息。你只要把這些消息通過DSM_Entry()函數發給Source Manager，就可以實現對選定的Source進行相應的操作。Source Manager會分辨那些消息屬于自己，那些消息是該轉發給Source。

在介紹DSM_Entry()前，我們先來了解一下的TWAIN定義的消息格式。TWAIN把它定義的操作稱為Triplets操作，就是每個操作用三個定義的參數來表示。這個三個參數用不同前綴名來區分。每個Triplets操作都是唯一的，不會有歧意，它們代表一個特定的操作行為。這三個參數類型分別是Data Group(前綴名DG_ )、 Data Argument(前綴名DAT_ ) 和 Message ID(前綴名MSG_ )，每個參數都包含有各自的信息。比如：DG_CONTROL / DAT_PARENT / MSG_OPENDSM 就表示一個打開Source Manager的操作，這些參數在TWAIN.H中都有定義。其他的操作(設置掃描儀的分辨率、獲得設備支持的功能等等…)你可以去查看TWAIN的參考手冊，我將在后面編程應用中介紹幾個最常用的操作。

現在，我們明白了TWAIN定義的Triplets操作，但是這還不夠。在使用DSM_Entry()前，必須要加載TWAIN_32.DLL文件以獲得DSM_Entry()函數指針。(注意：在你程序中應該添加前面提到的TWAIN.H頭文件哦!)

DSMENTRYPROC lpDSM_Entry;???//* DSM_Entry 入口函數的指針

HMODULE??????hDSMDLL;???????//* Twain_32.Dll句柄

????……

//* 加載TWAIN_32.DLL 文件

if ((hDSMDLL = LoadLibrary("TWAIN_32.DLL")) != NULL)

{

????if (hDSMDLL)???????????//* 檢查TWAIN_32.DLL是否加載

????{

????????????if ( (lpDSM_Entry =(DSMENTRYPROC) GetProcAddress(hDSMDLL,MAKEINTRESOURCE(1)))!=NULL)

????????{

??????????????????????????//* 成功獲得 DSM_Entry()函數指針;

????????}

????}

}

?

現在我們明白了，TWAIN所有的操作都是通過DSM_Entry()函數來實現的，所以了解該入口函數很有必要。它定義如下：

TW_UINT16 FAR PASCAL DSM_Entry

( pTW_IDENTITY pOrigin,????????//* 指向操作發起者的指針

pTW_IDENTITY pDest,??????????//* 指向目標對象的指針

TW_UINT32 DG,????????????????//* Triplets 操作的DG參數 : DG_xxxx

TW_UINT16 DAT,???????????????//* Triplets 操作的DAT參數: DAT_xxxx

TW_UINT16 MSG,???????????????//* Triplets 操作的MSG參數: MSG_xxxx

TW_MEMREF pData??????????????//* 指向返回數據塊的指針

);

????其中DG、DAT、MSG參數表示一個你想執行的Triplets操作。pOrigin表示發起Triplets操作的對象。pDest表示接收Triplets操作的對象。pData用于獲得執行Triplets操作后返回的數據。

????對于每個Triplets操作，都是由DG、DAT、MSG三個參數組合構成的。pOrigin、pDest參數會根據不同的Triplets操作，而使用不同的值。

函數執行后會返回一個值來表示操作是否成功。如果返回值為TWRC_SUCCESS表示操作成功，TWRC_FAILURE表示操作失敗。同樣根據Triplets操作的類型不同，還會有其他的返回值。比如TWRC_CANCEL、TWCC_LOWMEMORY…，具體信息你可以參考TWAIN的說明手冊。

???

五、TWAIN的操作流程

?

Application、 Source Manager 和 Source要實現數據傳輸，必須遵循一個操作流程。你要進行的操作應該在這個流程規定的動作隊列中按邏輯去執行。比如，在沒有加載Source Manager前，Application是不能要求Source傳輸數據的。為了更好的去描述這個流程，TWAIN為該流程定義了7個狀態(1-7)。

?

狀態位 1, 2, 3

這幾個狀態是用于描述Source Manager的，它們是Source Manager專有的狀態位，所以Source Manager 的標志位是不會大于3的.

狀態位4, 5, 6, 7

這幾個狀態是Source專有的。如果Source打開了，Source 的標志位就不會小于4；如果Source關閉了，Source就沒有了標志位。

?

要注意，我們的應用程序可以使用了多個Source，每個與Source的連接都是一個單獨的會話,對于打開的每個Source，他們的標志位都是相互獨立的，不互相關聯。現在就來看看流程圖。

流程標志位說明

狀態 1 – 準備會話

在Application和Source Manager建立會話前，Source Manager的標志位是1.

在這個時候，Source Manager還沒有被加載到內存中。如果Source Manager 被加載到內存中,則狀態位是2或者3。

?

狀態2 –加載Source Manager

Source Manager現在已經被成功地加載到了程序中，但是沒有打開Source Manager。

在這個時候, Source Manager開始準備去接受Application的Triplets操作。

?

狀態3 – 打開Source Manager

Source Manager已經打開并且準備去管理Source.Source Manager現在準備向Source發送打開操作，去打開指定的Source，并等待所有針對Source的操作結束后，去關閉打開的Source. Source Manager在會話關閉前，狀態位將保持為3. 當Application打開的Source沒有關閉時，Source Manager 會拒絕關閉。

?

狀態 4 – 打開Source?????

在響應Application的一個指定的Triplets操作后,Source被加載到系統中，并且被Source manager 打開。Source在加載前將檢測是否有足夠的系統資源讓自己運行(內存、設備是否可用等等…)。 Application不僅可以查詢Source的性能參數(當前解析度、是否支持彩色或黑白圖像、自動文檔傳送是否可用), Application還可以去設置的Source的性能參數。比如，Application可以要求Source按指定的分辨率傳輸黑白圖像。

?

注意: 可以在Source的狀態位是4, 5, 6, 或 7時，去查詢Source的性能參數。但是要想設置Source的性能參數必須在狀態位是4的時候設置，除非Application和Source有特殊的約定，否則在標志位為其他數的時候都不可以進行性能參數設置。

?

狀態 5 – Source可用?????????

現在可以讓Source工作了，此時Source開始為數據傳輸做準備。在該狀態下，可以執行一個Triplets操作，用以選擇是否讓Source顯示它自己的用戶界面（Source提供的軟件界面）。當Source準備好給Application傳輸數據時，標志位就從5變為6了。

?

狀態 6 –準備數據傳輸

該狀態下，Source已經準備好了為Application傳輸數據。在傳輸工作開始前，Application應該查詢將要被傳輸的圖像的相關信息(分辨率，圖像大小…), 如果Source還要傳輸音頻數據, 那么在傳輸圖像數據前，Application必須要把所有的音頻數據先傳完。注：某些數碼相機帶有攝像功能，可以記錄一些聲音信息。

?

狀態 7 –傳輸開始???????

Source開始進行數據傳輸，它把獲得的數據傳輸給你的應用程序。 傳輸工作要么成功完成，要么提前中止。在傳輸工作完成后， Source將會發送一個返回代碼去表示傳輸工作的最終結果。

?

?

轉載于:https://blog.51cto.com/chujiu/851917

總結

以上是生活随笔為你收集整理的Twain 学习纪录的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。