




版權(quán)說明:本文檔由用戶提供并上傳,收益歸屬內(nèi)容提供方,若內(nèi)容存在侵權(quán),請進(jìn)行舉報(bào)或認(rèn)領(lǐng)
文檔簡介
1、一、簡介TWAIN 數(shù)據(jù)源管理程序 (DSM) 工業(yè)標(biāo)準(zhǔn)的軟件庫,用于從靜態(tài)圖像設(shè)備提取圖像。絕大部分的掃描儀和數(shù)碼相機(jī)都提供了 TWAIN 驅(qū)動(dòng)程序,利用統(tǒng)一的 TWAIN 接口,應(yīng)用程序可以非常方便地從這些設(shè)備中獲取圖像。二、使用步驟互聯(lián)網(wǎng)上關(guān)于 TWAIN 編程的中文資料很少,代碼更是難找到,因?yàn)槲也坏貌蛔屑?xì)閱讀了 / 提供的 TWAIN Specification。下面說說使用 TWAIN 接口獲取圖像的簡要步驟。 Windows 系統(tǒng)中存在一個(gè) TWAIN_32.dll,所有的 TWAIN 操作都是通過這個(gè) DLL
2、導(dǎo)出的 DSM_Entry 函數(shù)來實(shí)現(xiàn)的 (說實(shí)在話,我個(gè)人覺得 TWAIN 接口設(shè)計(jì)得太差了,看看 MS 的WIA,邏輯上非常清晰)。這個(gè)函數(shù)的聲明如下: TW_UINT16 FAR PASCAL DSM_Entry(pTW_IDENTITY pOrigin, / Source of messagepTW_IDENTITY pDest, / Destination of messageTW_UINT32 DG, / Data group ID: DG_xxxxTW_UINT16 DAT, / Data argument type: DAT_xxxxTW_UINT16 MSG, /
3、Message ID: MSG_xxxxTW_MEMREF pData / Pointer to data); 1. 打開 DSM (Data Source Manager: 數(shù)據(jù)源管理器) TWAIN 是一個(gè)數(shù)據(jù)源管理程序,應(yīng)用程序首先要使用 MSG_OPENDSM 消息,打開數(shù)據(jù)源管理器。這里需要指定一個(gè)窗口句柄,應(yīng)用程序應(yīng)該在此窗口的消息循環(huán)中處理 TWAIN 消息 (MSG_PROCESSEVENT)。 2. 選擇 DS (Data Source: 數(shù)據(jù)源) 因?yàn)橐粋€(gè)系統(tǒng)中可能存在多個(gè) TWAIN 設(shè)備,因此必須選擇一個(gè)數(shù)據(jù)源。選擇數(shù)據(jù)源通常有兩
4、種方式: 選擇默認(rèn)數(shù)據(jù)源 (MSG_GETDEFAULT) 和顯示選擇數(shù)據(jù)源對話框,由用戶來選擇數(shù)據(jù)源 (MSG_USERSELECT)。 3. 打開 DS 使用 MSG_OPENDS 消息打開數(shù)據(jù)源。 4. 設(shè)置參數(shù) 消息為 MSG_SET,設(shè)置各種參數(shù),如獲取方式、圖像數(shù)量等。有些參數(shù)由設(shè)備驅(qū)動(dòng)支持才有效。 5. 顯示掃描界面 使用 MSG_ENABLEDS 消息,顯示設(shè)備驅(qū)動(dòng)提供的用戶界面 (UI)。 6. 獲取圖像 如果用戶選擇掃描什么的,可以在窗口的消息循環(huán)中獲取到這個(gè)事件 (MSG_XFERREADY)
5、。此時(shí),應(yīng)用程序可以通過 DAT_SETUPFILEXFER 設(shè)置文件名,然后用 DAT_IMAGEFILEXFER 獲取圖像到文件中。 7. 關(guān)閉掃描界面 在窗口的消息循環(huán)中獲取到 MSG_CLOSEDSREQ 或 MSG_CLOSEDSOK 消息,可以關(guān)閉掃描界面 (MSG_DISABLEDS)。 8. 關(guān)閉 DS 消息為 MSG_CLOSEDS。 9. 關(guān)閉數(shù)據(jù)源消息為 MSG_CLOSEDSM。 三、CTwainHelper 助手類為了使用方便,我寫了一個(gè)靜態(tài) TWAIN 助手類 CTwainHelper。使用 CTwainH
6、elper 的五個(gè)函數(shù),就可以簡單地從 TWAIN 設(shè)備獲取圖像到文件中。使用方法如下:1. 調(diào)用 CTwainHelper:Initialize() 確定是否有可用的設(shè)備。2. 在窗口消息循環(huán)中,調(diào)用 CTwainHelper:ProcessMessage() 處理 TWAIN 消息。3. 要獲取圖像時(shí),調(diào)用 CTwainHelper:GetImage()。4. 如果圖像已準(zhǔn)備好 (如用戶確定掃描圖像),窗口會(huì)收到 WM_COMMAND 消息,wParam 為 IDC_TwainHelper。此時(shí)應(yīng)用程序可以調(diào)用 CTwainHelper:TransferImage() 獲取圖像到文件中。具
7、體使用方法請參看示例代碼。CTwainHelper 可以在 Visual C+ 6.x/7.x 工程中使用,支持 UNICODE 編譯。因?yàn)槭庆o態(tài)類,要改寫成 C 代碼只需要做一點(diǎn)點(diǎn)少量的工作。四、后話當(dāng)然,上面只是一種常用的步驟。其實(shí)應(yīng)用程序完全可以自定義所有的步驟,比如不使用 TWAIN 驅(qū)動(dòng)提供掃描對話框而直接掃描,或者掃描圖像到內(nèi)存中等等。詳細(xì)情況請參考 TWAIN Specification,步驟大同小異,消息和參數(shù)千差萬別,仔細(xì)看看應(yīng)該很容易的。如果沒有 TWAIN 設(shè)備又要進(jìn)行 TWAIN 程序開發(fā),可以到 TWAIN 官方網(wǎng)站下載 TWAIN Developers Toolki
8、t,安裝后會(huì)有一個(gè)虛擬的 TWAIN 設(shè)備。不過應(yīng)用程序在這個(gè)虛擬 TWAIN 設(shè)備中正常工作,不代表一定能在實(shí)際的 TWAIN 設(shè)備正常使用,這點(diǎn)需要注意。以前 CTwainHelper 就碰到過這樣的情況 在虛擬 TWAIN 設(shè)備中明明是好的,在我的掃描儀上卻不能掃描圖像。檢查后發(fā)現(xiàn),原來設(shè)置了不支持的參數(shù)。最后,TWAIN 是 Technology Without A Interesting Name 縮寫,直譯為沒有“沒有讓人感興趣名字的技術(shù)”,真是一個(gè)讓人摸不著頭腦的名字。TWAIN 助手類: CTwainHelper (包含示例代碼 35K)TWAIN 官方網(wǎng)站
9、: TWAIN 頭文件: /devfiles/twain.hTWAIN Specification: /docs/Spec1_9_197.pdfTWAIN Developers Toolkit: /devfiles/twainkit.exe 2006.2.22 下面是更簡單的版本,其中的 GetImage 函數(shù)內(nèi)部自動(dòng)具有消息循環(huán),直到TWAIN對話框完全關(guān)閉后才會(huì)返回,適合任何場合使用:下載文件點(diǎn)擊這里
10、下載文件轉(zhuǎn) Twain學(xué)習(xí) 2009-05-03 11:34:07| 分類: C語言學(xué)習(xí)|字號 訂閱一、TWAIN的文件組成TWAIN共包括4個(gè)二進(jìn)制文件。如果要使用該接口,就必須要保證他們被成功地安裝在本地計(jì)算機(jī)上。 文 件 名說 明TWAIN_32.DLL32位應(yīng)用程序的支持文件,32位程序使用TWAIN通訊必須使用該文件。TWAIN.DLL16位應(yīng)用程序的支持文件,16位程序使用TWAIN通訊必須使用該文件。TWUNKER_32.EXE實(shí)現(xiàn)32位應(yīng)用程序與32位數(shù)據(jù)源進(jìn)行通訊,它運(yùn)行時(shí)不可見。TWUNKER_16.
11、EXE實(shí)現(xiàn)32位應(yīng)用程序與16位數(shù)據(jù)源進(jìn)行通訊,它運(yùn)行時(shí)不可見。注意:在Windows NT 環(huán)境下16位數(shù)據(jù)源不能夠正常工作。 在Windows 操作系統(tǒng)中(Windows 9x / 2000 / XP ),Microsoft已經(jīng)把這些文件作為系統(tǒng)文件隨同操作系統(tǒng)一起發(fā)布了。你可以在Windows安裝目錄中查找到這些文件。如果我們要編程來實(shí)現(xiàn)對TWAIvN的訪問,還需要最重要的頭文件。你通過訪問該/devfiles/twain.h 地址來獲得TWAIN提供的頭文件。 二、TWAIN的結(jié)構(gòu)TWAIN依靠三個(gè)組件協(xié)同完
12、成與圖像設(shè)備的通訊和數(shù)據(jù)傳輸工作,這三個(gè)組件就是Application、Source Manager和Source。 組件說明Application就是你要編寫的應(yīng)用程序。Source Manager是由TWAIN提供的一個(gè)Source的管理器,它不僅可以收集本地系統(tǒng)已經(jīng)安裝了的圖像設(shè)備,還可以根據(jù)需要去加載設(shè)備。同時(shí),它最重要的功能是擔(dān)任Application 與Source通訊的橋梁。(其實(shí),它就是我們前面提到的組成文件中的dll文件。)Source在這里可以看作是圖像設(shè)備。事實(shí)上它是由設(shè)備廠家提供的一個(gè)dll文件。這個(gè)dll文件是支持twain接口的。(該文不討論關(guān)于
13、twain在Source中的應(yīng)用。) 它們的層次結(jié)構(gòu)圖如下: 從該圖我們可以看到,Application 要從Source獲得圖像數(shù)據(jù),必須通過Source Manager傳遞來實(shí)現(xiàn)。Application與Source Manager 間的通訊是靠調(diào)用TWAIN提供的DSM_Entry( )函數(shù)實(shí)現(xiàn)。而Application不能直接與Source 通訊,Source Manager與Source 間的通訊是靠調(diào)用TWAIN提供的DS_Entry( )函數(shù)實(shí)現(xiàn)(在這里,我們不用關(guān)心Source Manager如何去調(diào)用DS_Entry函數(shù)。 三、TWA
14、IN的用戶界面當(dāng)我們使用TWAIN接口去獲得圖像數(shù)據(jù)的時(shí)候,會(huì)涉及到一些的用戶界面,首先是我們的應(yīng)用程序界面,然后是Source Manager提供的用戶界面以及圖像設(shè)備(Source)所提供的用戶界面。在我們的應(yīng)用程序中,可以通過“選擇設(shè)備”來打開Source Manager的標(biāo)準(zhǔn)用戶界面。Source Manager的界面由Source Manager提供。在這個(gè)界面中可以讓用戶選擇他想要使用的圖像設(shè)備。選中想要的設(shè)備后,再通過“獲取”來打開圖像設(shè)備(Source)提供的用戶界 面進(jìn)行現(xiàn)應(yīng)的操作。(注:Source提供的界面會(huì)因?yàn)槟闶褂玫膱D像設(shè)備不同而有差異。)對于這些界面,TWAIN提供
15、了非常靈活的處理方法。對于Source Manager提供的用戶界面以及圖像設(shè)備(Source)所提供的用戶界面,我們可以選擇是否顯示它們,甚至我們還可以按自己的要求去改寫這些用戶界面。 四、TWAIN的接口函數(shù)要編寫應(yīng)用程序?qū)崿F(xiàn)與支持TWAIN 標(biāo)準(zhǔn)的圖像設(shè)備通訊,只需要了解上面提到的DSM_Entry()接口函數(shù)。TWAIN定義了大約140個(gè)操作消息。你只要把這些消息通過 DSM_Entry()函數(shù)發(fā)給Source Manager,就可以實(shí)現(xiàn)對選定的Source進(jìn)行相應(yīng)的操作。Source Manager會(huì)分辨那些消息屬于自己,那些消息是該轉(zhuǎn)發(fā)給Source。在介紹DSM_Ent
16、ry() 前,我們先來了解一下的TWAIN定義的消息格式。TWAIN把它定義的操作稱為Triplets操作,就是每個(gè)操作用三個(gè)定義的參數(shù)來表示。這個(gè)三個(gè)參 數(shù)用不同前綴名來區(qū)分。每個(gè)Triplets操作都是唯一的,不會(huì)有歧意,它們代表一個(gè)特定的操作行為。這三個(gè)參數(shù)類型分別是Data Group(前綴名DG_ )、 Data Argument(前綴名DAT_ ) 和 Message ID(前綴名MSG_ ),每個(gè)參數(shù)都包含有各自的信息。比如:DG_CONTROL / DAT_PARENT / MSG_OPENDSM 就表示一個(gè)打開Source Manager的操作,這些參數(shù)在TWAIN
17、.H中都有定義。其他的操作(設(shè)置掃描儀的分辨率、獲得設(shè)備支持的功能等等)你可以去查看TWAIN的參考手冊,我將在后面編程應(yīng)用中介紹幾個(gè)最常用的操作?,F(xiàn)在,我們明白了TWAIN定義的Triplets操作,但是這還不夠。在使用DSM_Entry()前,必須要加載TWAIN_32.DLL文件以獲得DSM_Entry()函數(shù)指針。(注意:在你程序中應(yīng)該添加前面提到的TWAIN.H頭文件哦!)DSMENTRYPROC lpDSM_Entry; /* DSM_Entry 入口函數(shù)的指針HMODULE h
18、DSMDLL; /* Twain_32.Dll句柄 /* 加載TWAIN_32.DLL 文件if (hDSMDLL = LoadLibrary("TWAIN_32.DLL") != NULL) if (hDSMDLL) /* 檢查TWAIN_32.DLL是
19、否加載 if ( (lpDSM_Entry =(DSMENTRYPROC) GetProcAddress(hDSMDLL,MAKEINTRESOURCE(1)!=NULL)
20、 /* 成功獲得 DSM_Entry()函數(shù)指針; 現(xiàn)在我們明白了,TWAIN所有的操作都是通過DSM_Entry()函數(shù)來實(shí)現(xiàn)的,所以了解該入口函數(shù)很有必要。它定義如下:TW_UINT16 FAR PASCAL DSM_Entry( pTW_IDENTITY pOr
21、igin, /* 指向操作發(fā)起者的指針pTW_IDENTITY pDest, /* 指向目標(biāo)對象的指針TW_UINT32 DG, /* Triplets 操作的DG參數(shù) : DG_xxxxTW_UI
22、NT16 DAT, /* Triplets 操作的DAT參數(shù): DAT_xxxxTW_UINT16 MSG, /* Triplets 操作的MSG參數(shù): MSG_xxxxTW_MEMREF pData
23、0; /* 指向返回?cái)?shù)據(jù)塊的指針); 其中DG、DAT、MSG參數(shù)表示一個(gè)你想執(zhí)行的Triplets操作。pOrigin表示發(fā)起Triplets操作的對象。pDest表示接收Triplets操作的對象。pData用于獲得執(zhí)行Triplets操作后返回的數(shù)據(jù)。 對于每個(gè)Triplets操作,都是由DG、DAT、MSG三個(gè)參數(shù)組合構(gòu)成的。pOrigin、pDest參數(shù)會(huì)根據(jù)不同的Triple
24、ts操作,而使用不同的值。函數(shù)執(zhí)行后會(huì)返回一個(gè)值來表示操作是否成功。如果返回值為TWRC_SUCCESS表示操作成功,TWRC_FAILURE表示操作失敗。同樣根據(jù)Triplets操作的類型不同,還會(huì)有其他的返回值。比如TWRC_CANCEL、TWCC_LOWMEMORY,具體信息你可以參考TWAIN的說明手冊。 五、TWAIN的操作流程 Application、 Source Manager 和 Source要實(shí)現(xiàn)數(shù)據(jù)傳輸,必須遵循一個(gè)操作流程。你要進(jìn)行的操作應(yīng)該在這個(gè)流程規(guī)定的動(dòng)作隊(duì)列中按邏輯去執(zhí)行。比如,在沒有加載Source Manager前
25、,Application是不能要求Source傳輸數(shù)據(jù)的。為了更好的去描述這個(gè)流程,TWAIN為該流程定義了7個(gè)狀態(tài)(1-7)。 狀態(tài)位 1, 2, 3這幾個(gè)狀態(tài)是用于描述Source Manager的,它們是Source Manager專有的狀態(tài)位,所以Source Manager 的標(biāo)志位是不會(huì)大于3的.狀態(tài)位4, 5, 6, 7這幾個(gè)狀態(tài)是Source專有的。如果Source打開了,Source 的標(biāo)志位就不會(huì)小于4;如果Source關(guān)閉了,Source就沒有了標(biāo)志位。 要注意,我們的應(yīng)用程序可以使用了多個(gè)Source,每個(gè)與Source的連接都是一個(gè)單獨(dú)的
26、會(huì)話,對于打開的每個(gè)Source,他們的標(biāo)志位都是相互獨(dú)立的,不互相關(guān)聯(lián)?,F(xiàn)在就來看看流程圖。流程標(biāo)志位說明狀態(tài) 1 準(zhǔn)備會(huì)話在Application和Source Manager建立會(huì)話前,Source Manager的標(biāo)志位是1.在這個(gè)時(shí)候,Source Manager還沒有被加載到內(nèi)存中。如果Source Manager 被加載到內(nèi)存中,則狀態(tài)位是2或者3。 狀態(tài)2 加載Source ManagerSource Manager現(xiàn)在已經(jīng)被成功地加載到了程序中,但是沒有打開Source Manager。在這個(gè)時(shí)候, Source Manager開始準(zhǔn)備去接受Applica
27、tion的Triplets操作。 狀態(tài)3 打開Source ManagerSource Manager已經(jīng)打開并且準(zhǔn)備去管理Source.Source Manager現(xiàn)在準(zhǔn)備向Source發(fā)送打開操作,去打開指定的Source,并等待所有針對Source的操作結(jié)束后,去關(guān)閉打開的Source. Source Manager在會(huì)話關(guān)閉前,狀態(tài)位將保持為3. 當(dāng)Application打開的Source沒有關(guān)閉時(shí),Source Manager 會(huì)拒絕關(guān)閉。 狀態(tài) 4 打開Source 在響應(yīng)Application
28、 的一個(gè)指定的Triplets操作后,Source被加載到系統(tǒng)中,并且被Source manager 打開。Source在加載前將檢測是否有足夠的系統(tǒng)資源讓自己運(yùn)行(內(nèi)存、設(shè)備是否可用等等)。 Application不僅可以查詢Source的性能參數(shù)(當(dāng)前解析度、是否支持彩色或黑白圖像、自動(dòng)文檔傳送是否可用), Application還可以去設(shè)置的Source的性能參數(shù)。比如,Application可以要求Source按指定的分辨率傳輸黑白圖像。 注意: 可以在Source的狀態(tài)位是4, 5, 6, 或 7時(shí),去查詢Source的性能參數(shù)。但是要想設(shè)置Source的性能參數(shù)必須在狀態(tài)
29、位是4的時(shí)候設(shè)置,除非Application和Source有特殊 的約定,否則在標(biāo)志位為其他數(shù)的時(shí)候都不可以進(jìn)行性能參數(shù)設(shè)置。 狀態(tài) 5 Source可用 現(xiàn)在可以讓Source 工作了,此時(shí)Source開始為數(shù)據(jù)傳輸做準(zhǔn)備。在該狀態(tài)下,可以執(zhí)行一個(gè)Triplets操作,用以選擇是否讓Source顯示它自己的用戶界面 (Source提供的軟件界面)。當(dāng)Source準(zhǔn)備好給Application傳輸數(shù)據(jù)時(shí),標(biāo)志位就從5變?yōu)?了。 狀態(tài) 6 準(zhǔn)備數(shù)據(jù)傳輸
30、該狀態(tài)下,Source 已經(jīng)準(zhǔn)備好了為Application傳輸數(shù)據(jù)。在傳輸工作開始前,Application應(yīng)該查詢將要被傳輸?shù)膱D像的相關(guān)信息(分辨率,圖像大小), 如果Source還要傳輸音頻數(shù)據(jù), 那么在傳輸圖像數(shù)據(jù)前,Application必須要把所有的音頻數(shù)據(jù)先傳完。注:某些數(shù)碼相機(jī)帶有攝像功能,可以記錄一些聲音信息。 狀態(tài) 7 傳輸開始 Source開始進(jìn)行數(shù)據(jù)傳輸,它把獲得的數(shù)據(jù)傳輸給你的應(yīng)用程序。 傳輸工作要么成功完成,要么提前中止。在傳輸工作完成后, Source將會(huì)發(fā)送一個(gè)
31、返回代碼去表示傳輸工作的最終結(jié)果。 七、TWAIN最常用的Triplets操作這里將對TWAIN中最常用的Triplets操作做一個(gè)簡單的介紹,為了便于理解和記憶,我將結(jié)合前面講的操作流程順序去介紹這些常用的Triplets操作。 1加載Source Manager并獲得DSM_Entry入口函數(shù) (狀態(tài)1到2)應(yīng)用程序在調(diào)用DSM_Entry函數(shù)指針前必須加載Source Manager。這里沒有使用Triplets操作。你可以使用LoadLibrary()函數(shù),加載TWAIN_32.DLL文件。并使用GetProcAddress()函數(shù),獲得DSM_Entry函數(shù)指針&
32、#160;2打開Source Manager (狀態(tài)2到3)Triplets 操作:DG_CONTROL / DAT_PARENT / MSG_OPENDSM通過該操作,你可以打開Source Manager,并且還要在你的應(yīng)用程序中,指定一個(gè)窗體作為Source的父窗口。Source Manager 將通過該窗體,把Source的消息傳遞給你的應(yīng)用程序。 3選擇Source (狀態(tài)3期間)Triplets 操作:DG_CONTROL / DAT_IDENTITY / MSG_USERSELECT你的應(yīng)用程序發(fā)送該操作后,將顯示Source Manager的用戶界面,它是一個(gè)對話框。
33、這個(gè)對話框中顯示了系統(tǒng)中所有支持Twain的設(shè)備列表。系統(tǒng)默認(rèn)設(shè)備將高亮顯示在列表框中。你可以通過該列表框選擇你想要的輸入設(shè)備。 4打開Source (狀態(tài)3到4)Triplets 操作:DG_CONTROL / DAT_IDENTITY / MSG_OPENDS該操作可以打開你選擇的Source(圖像輸入設(shè)備),同時(shí),Source Manager會(huì)給該Source分配一個(gè)唯一的標(biāo)識(shí)符。你要把打開的這個(gè)Source放在一個(gè)指定的結(jié)構(gòu)中,以便于在后面和該Source進(jìn)行通訊。 5設(shè)置Source的性能參數(shù) (狀態(tài)4期間)Triplets 操作:DG_CONTROL / DAT
34、_CAPABILITY / MSG_GETDG_CONTROL / DAT_CAPABILITY / MSG_SET這里有兩個(gè)Triplets操作,通過使用這兩個(gè)操作可以去查詢當(dāng)前設(shè)備是否支持的某種功能,如果支持,還可以獲得設(shè)備功能的當(dāng)前值、默認(rèn)值、以及可以重新設(shè)置的范圍。你還可以根據(jù)查詢的結(jié)果,按你的要求去重新設(shè)置該功能的當(dāng)前值。 6請求從Source獲取數(shù)據(jù) (狀態(tài)4到5)Triplets 操作:DG_CONTROL / DAT_USERINTERFACE / MSG_ENABLEDS通過該操作,可以讓Source顯示它的用戶界面,Source會(huì)去為數(shù)據(jù)傳輸作準(zhǔn)備。 7
35、認(rèn)數(shù)據(jù)準(zhǔn)備傳輸 (狀態(tài)5到6)Triplets 操作:DG_CONTROL /DAT_EVENT / MSG_PROCESSEVENT首先要說明一下,從狀態(tài)5到狀態(tài)6的這個(gè)過程,不是由你的應(yīng)用程序通過Triplets操作來發(fā)起的。而是當(dāng)Source準(zhǔn)備好去傳輸數(shù)據(jù)時(shí),它會(huì)發(fā)出一個(gè)事件信號來實(shí)現(xiàn)的。你的應(yīng)用程序應(yīng)該要去檢查這個(gè)事件信號。如何去檢查這個(gè)事件信號?我們在加載Source Manager時(shí),就為Source指定了一個(gè)父窗口,Source會(huì)把它事件信號封裝成一個(gè)Windows的消息結(jié)構(gòu)發(fā)送給它的父窗口。你可以在這個(gè)窗 體的消息循環(huán)中去,使用 DG_CONTROL /DAT_EVENT /
36、 MSG_PROCESSEVENT操作,來判斷Source是否有事件發(fā)生。MSG_XFERREADY就表示這個(gè)過程的狀態(tài)位從5變?yōu)?了。 8開始進(jìn)行數(shù)據(jù)傳輸 (狀態(tài)6到7)Triplets 操作:DG_IMAGE / DAT_IMAGEINFO / MSG_GET DG_IMAGE / DAT_IMAGENATIVEXFER / MSG_GET在開始數(shù)據(jù)傳輸前,可以通過 DG_IMAGE / DAT_IMAGEINFO / MSG_GET 操作,去獲得將要傳輸?shù)膱D像的相關(guān)信息,比如位圖大小、寬度、長度。通過 DG_IMAGE /
37、DAT_IMAGENATIVEXFER / MSG_GET 操作,可以實(shí)現(xiàn)使用本地傳輸模式去傳輸數(shù)據(jù)。傳輸結(jié)束了,Source 將給它的父窗口一個(gè) PM_XFERDONE 的消息。Source將在 DSM_Entry() 中返回為一個(gè)指向 DIB 位圖的指針。 9中止傳輸 (狀態(tài)7到6到5)Triplets 操作:DG_CONTROL / DAT_PENDINGXFERS / MSG_ENDXFER在每次數(shù)據(jù)傳輸結(jié)束(成功、退出)后,可以發(fā)送該操作給Source,去表示應(yīng)用程序已經(jīng)接受完了所有的數(shù)據(jù)了。同時(shí)還可以根據(jù)它的返回值,去檢查是否有其它的圖像等待傳送。 10斷開TW
38、AIN會(huì)話 (狀態(tài)5到4)Triplets 操作:DG_CONTROL / DAT_USERINTERFACE / MSG_DISABLEDS該操作讓打開Source失效。 11關(guān)閉Source (狀態(tài)4到3)Triplets 操作:DG_CONTROL / DAT_IDENTITY / MSG_CLOSEDS該操作可以關(guān)閉指定的Source。 12關(guān)閉Source Manager(狀態(tài)3到2)Triplets 操作: DG_CONTROL / DAT_PARENT/MSG_CLOSEDSM關(guān)閉打開的Source Manager。 七、TWAIN的數(shù)據(jù)傳
39、輸模式TWAIN定義了三種模式用于Source 到Application的數(shù)據(jù)傳輸:本地模式、文件模式,和緩存模式。現(xiàn)在對每種模式進(jìn)行一個(gè)簡單的介紹。注:對于音頻數(shù)據(jù)的傳輸,只能選擇本地模式或者文件模式來進(jìn)行傳輸。 本地模式 所有的輸入設(shè)備都支持這種本地?cái)?shù)據(jù)傳輸模式,同時(shí)它也是TWAIN默認(rèn)的數(shù)據(jù)傳輸模式,并且它還是最容易使用的數(shù)據(jù)傳輸模式。但是,它有一定的局限性,它傳輸?shù)臄?shù)據(jù)必須是DIB 圖像數(shù)據(jù),并且在傳輸時(shí),會(huì)受到系統(tǒng)內(nèi)存大小限制。 傳輸數(shù)據(jù)的格式: DIB (Device-Independent Bitmap)使用該模式,在數(shù)據(jù)傳輸時(shí)
40、Source 分配一塊單獨(dú)的內(nèi)存區(qū)域,并把圖形數(shù)據(jù)寫入這個(gè)內(nèi)存區(qū)域內(nèi)。然后它通過一個(gè)指向該內(nèi)存地址的指針告訴Application,數(shù)據(jù)存放在什么地方。你的應(yīng) 用程序通過訪問該內(nèi)存區(qū)域去獲得具體的圖像數(shù)據(jù)。注意,Application在獲得數(shù)據(jù)后要負(fù)責(zé)去釋放這部分的內(nèi)存。如果你的圖像數(shù)據(jù)大于系統(tǒng)當(dāng)前可用 內(nèi)存,會(huì)導(dǎo)致傳輸失敗。 文件模式 該模式是讓Application 創(chuàng)建一個(gè)文件,這個(gè)文件用于儲(chǔ)存?zhèn)鬏數(shù)臄?shù)據(jù),Source將對該文件進(jìn)行讀寫操作。Source將把要傳輸?shù)臄?shù)據(jù)寫到該文件中,你的應(yīng)用程序通過訪問該文件,就可以獲得傳輸?shù)臄?shù)據(jù)。 在使用本地模式傳輸一個(gè)大
41、的圖像文件時(shí),如果內(nèi)存不夠大,可以考慮使用文件傳輸模式來傳輸。文件傳輸模式與緩存?zhèn)鬏斈J较啾龋谑褂梅椒ㄉ弦唵涡?,但是該模式在傳輸速度上比緩存模式的傳輸速度要慢一些,并且在?shù)據(jù)傳輸完畢后,你的應(yīng)用程序還必須去管理這個(gè)數(shù)據(jù)文件。 緩存模式 緩存模式在整個(gè)傳輸過程中,將使用一個(gè)或多個(gè)內(nèi)存緩存區(qū),內(nèi)存緩存區(qū)的分配和釋放工作由Application來控制。在傳輸過程中,傳輸數(shù)據(jù)被當(dāng)作一個(gè)未知格式的位圖。Application必須使用TW_IMAGEINFO 和 TW_IMAGEMEMXFER操作,去得到各個(gè)緩存區(qū)的信息并把它們正確組織為一個(gè)完整的位圖。 如果
42、使用本地模式 或 文件模式 去傳輸數(shù)據(jù),整個(gè)傳輸過程在只需要一個(gè)Triplets操作就可以完成。如果使用 緩存模式 傳輸數(shù)據(jù), 你的應(yīng)用程序可能需要使用多個(gè)Triplets操作,不停地去獲得緩存區(qū)的數(shù)據(jù)信息。但是,該傳輸模式具有很好的靈活性, 可以很好的去控制獲得的數(shù)據(jù),只不過在編程應(yīng)用上要麻煩一些。 八、TWAIN的應(yīng)用實(shí)現(xiàn)好了,看了前面的對TWAIN的介紹,現(xiàn)在我們就動(dòng)手開始進(jìn)行實(shí)際的編程吧。在這里,只進(jìn)行一個(gè)最簡單的應(yīng)用實(shí)現(xiàn)。我們的應(yīng)用程序不去設(shè)置設(shè)備的性能參數(shù),不選擇其它數(shù)據(jù)傳輸模式,僅僅使用TWAIN的默認(rèn)的本地傳輸模式方式,去獲得圖像數(shù)據(jù)。在進(jìn)行實(shí)際編程應(yīng)用前,我們可以先
43、安裝TWAIN 提供的工具包。它不僅提供了TWAIN應(yīng)用的例程,還可以在你的計(jì)算機(jī)系統(tǒng)上安裝一個(gè)虛擬的圖像輸入設(shè)備(TWAIN_32 Sample Source )。這對于沒有掃描儀、數(shù)碼相機(jī)的開發(fā)者,提供了一個(gè)很好的測試設(shè)備。TWAIN工具包的下載地址: /devfiles/twainkit.exe 。由于TWAIN目前提供的是基于C的編程接口,所以我們這里采用VC作為開發(fā)工具。我們可以建一個(gè)自己的TWAIN類。把一些Triplets操作封裝成這個(gè)類的成員函數(shù)。以便于程序調(diào)用。記?。涸谀愕捻?xiàng)目中要加入TWAIN提供的頭文件。前面已經(jīng)介紹了,在進(jìn)行TWAI
44、N的操作前,如何加載TWAIN_32.dll文件,獲得DSM_Entry()函數(shù)指針。下面僅簡單介紹一下其他的成員函數(shù)。 1 打開Source Managerint CTwain:OpenSourceManager(void) TW_UINT16 rc;. . ./ lpDSM_Entry 是指向DSM_Entry的函數(shù)指針 rc = (*lpDSM_Entry) (&AppID, NULL, &
45、#160; DG_CONTROL,DAT_PARENT,MSG_OPENDSM,
46、60; / hPWnd 是指定為Source的父窗口的句柄 (TW_MEMREF) & (*hPWnd) ; switch (rc)
47、 / 檢查打開Source Manager是否成功 case TWRC_SUCCESS: / 成功 . . . case TWRC_CANCEL: &
48、#160; . . . . . . 2打開Sourceint CTwain:OpenSource(void) TW_UINT16 rc; rc = (*lpDSM_Entry) (&AppID,NULL,
49、160; DG_CONTROL,DAT_IDENTITY,MSG_OPENDS, (TW_MEMREF) &SourceID); / SourceID 是要求打開Source
50、160; switch (rc) / 檢查打開Source Manager是否成功 case TWRC_SUCCESS: / 成功 . . . . . . 3處理Source的事件int CTwain:
51、DealSourceMsg(MSG *pMSG) TW_UINT16 rc = TWRC_NOTDSEVENT; TW_EVENT twEvent; twEvent.pEvent = (TW_MEMREF) pMSG; rc = (*lpDSM_Entry) (&AppID,&SourceID, &
52、#160; DG_CONTROL,DAT_EVENT,MSG_PROCESSEVENT,
53、; (TW_MEMREF) &twEvent); switch (twEvent.TWMessage) case MSG_XFERREADY: / Source準(zhǔn)備好傳輸數(shù)據(jù)了 iStatus=6 iStatus=6;
54、160;GetBmpInfo(); DoNativeTransfer(); case MSG_CLOSEDSREQ: / 關(guān)閉 Source 用戶界面的申請 case MSG_CLOSEDSOK: case MSG_NULL: . .
55、 . 4使用本地模式傳輸數(shù)據(jù)int CTwain:DoNativeTransfer(void) TW_UINT32 hBitMap = NULL; / 指向圖像數(shù)據(jù)地址 TW_UINT16 rc; HANDLE hbm_acq = NULL; rc
56、 = (*lpDSM_Entry)(&AppID,&SourceID, DG_IMAGE,DAT_IMAGENATIVEXFER,MSG_GET,
溫馨提示
- 1. 本站所有資源如無特殊說明,都需要本地電腦安裝OFFICE2007和PDF閱讀器。圖紙軟件為CAD,CAXA,PROE,UG,SolidWorks等.壓縮文件請下載最新的WinRAR軟件解壓。
- 2. 本站的文檔不包含任何第三方提供的附件圖紙等,如果需要附件,請聯(lián)系上傳者。文件的所有權(quán)益歸上傳用戶所有。
- 3. 本站RAR壓縮包中若帶圖紙,網(wǎng)頁內(nèi)容里面會(huì)有圖紙預(yù)覽,若沒有圖紙預(yù)覽就沒有圖紙。
- 4. 未經(jīng)權(quán)益所有人同意不得將文件中的內(nèi)容挪作商業(yè)或盈利用途。
- 5. 人人文庫網(wǎng)僅提供信息存儲(chǔ)空間,僅對用戶上傳內(nèi)容的表現(xiàn)方式做保護(hù)處理,對用戶上傳分享的文檔內(nèi)容本身不做任何修改或編輯,并不能對任何下載內(nèi)容負(fù)責(zé)。
- 6. 下載文件中如有侵權(quán)或不適當(dāng)內(nèi)容,請與我們聯(lián)系,我們立即糾正。
- 7. 本站不保證下載資源的準(zhǔn)確性、安全性和完整性, 同時(shí)也不承擔(dān)用戶因使用這些下載資源對自己和他人造成任何形式的傷害或損失。
最新文檔
- 廣告安裝承包合同
- 旅游產(chǎn)品規(guī)劃與開發(fā)作業(yè)指導(dǎo)書
- 企業(yè)年度工作總結(jié)與報(bào)告手冊
- 億峰地坪施工方案
- 野外鋼架平臺(tái)施工方案
- 多層水泥路面鋪貼施工方案
- 園林圓石鋪路施工方案
- 鋁合金圍墻施工方案
- 小學(xué)一年級家長會(huì)發(fā)言稿
- 幼兒園環(huán)境升級施工方案
- 《Spring框架》教學(xué)課件
- 七年級下冊《平行線的判定》課件與練習(xí)
- 2025年中考英語時(shí)文閱讀 6篇有關(guān)電影哪吒2和 DeepSeek的英語閱讀(含答案)
- 修高速土方合同范例
- 完整版臨時(shí)用水用電施工方案
- 2024年形勢與政策復(fù)習(xí)題庫含答案(綜合題)
- 江蘇省南通市2025屆高三第一次調(diào)研測試數(shù)學(xué)試題(南通一模)(含答案)
- DCMM數(shù)據(jù)管理師練習(xí)測試卷
- 油氣行業(yè)人才需求預(yù)測-洞察分析
- 檢修安全知識(shí)培訓(xùn)課件
- 學(xué)校心理健康教育存在的問題及改進(jìn)措施
評論
0/150
提交評論