[SC]スキャナーを使用します

過去数年間、同僚と私はオフィスで紙を少なくしようとしています。 従業員はデジタルドキュメントをより速く、より適切に操作します-ほこりはずっと少なくなります。



デジタルドキュメントに完全に切り替えるには、最初に紙をスキャンする必要があります。 スキャナーのデスクトップアプリケーションを開発するには、 .NET Frameworkを使用します 。 箱から出してすぐに、彼はスキャナーを操作するためのツールを提供しません。 .NETはCOMと友だちなので、 WIA（Windows Imaging Architecture）コンポーネントを使用できます。



WIAとの便利な作業のために、多くのスキャンアプリケーションの基礎を形成するクラスを作成しました。 例としてScannerクラスを使用して、 スキャナーでの経験を共有したいと思います。



私たちの銀行のいくつかの非常に有用なアプリケーションで使用されています。 たとえば、銀行の顧客のすべてのアプリケーションと契約は、 スキャナークラスを使用するアプリケーションによってデジタル化されます。



次のようになります。









など：

すべてがシンプルであるというわけではありません

開発したアプリケーションからスキャナーの操作を開始するには、最初にスキャナーを選択してから構成し、スキャンする必要があります。 したがって、クラスのパブリックインターフェイスは、 ConfigurationとScanの 2つのメソッドによって制限できます。



設定により、標準のスキャナー設定ダイアログが表示されます。 スキャンはドキュメントをスキャンし、 MemoryStreamに画像を返します。

今、詳細に...

WIAを介してスキャナーを操作します。 これを行うには、 Microsoft Windows Image Acquisition Library v2.0コンポーネントをCOMプロジェクトに接続します 。COMプロジェクトの実装はファイルC：\ Windows \ System32 \ wiaaut.dllにあります。



スキャナーを一度セットアップし、次のアプリケーションのロード時に、スキャナーが既に構成されていることが一般的です。 スキャナーを構成し、構成を保存および復元する機能が必要です。 Scannerクラスを作成し、 WIAを使用してファイルの先頭に追加します。 Scannerクラスのオブジェクトを作成するとき、設定から設定をロードしようとします。 うまくいかない場合は、スキャナーを手動でセットアップすることをお勧めします。



通常、1つのプログラムが1つのスキャナーで動作するため、シングルトンを作成できます。 私の場合、複数のスキャナーが同時に存在する場合があります。

コンストラクタは次のようになります。

public Scanner() { try { LoadConfig(); } catch (Exception) { MessageBox.Show(" ,    "); Configuration(); } }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

ここでMessageBoxは何をしていますか？ ほとんどの場合、スキャンアプリケーションはGUIを意味します。 情報を表示するには、 MessageBoxを使用してメッセージを表示することもできます。さらに、標準のWIAダイアログを使用してスキャナーを構成します。



スキャナーをセットアップすることから始めましょう。 スキャナーは、 設定（）機能を使用して設定されます。この機能は、プログラムの「スキャナー設定」ボタンを押すなど、いつでも呼び出すことができます。

 public void Configuration() { try { var commonDialog = new CommonDialogClass(); _scanDevice = commonDialog.ShowSelectDevice(WiaDeviceType.ScannerDeviceType, true); if (_scanDevice == null) return; var items = commonDialog.ShowSelectItems(_scanDevice); if (items.Count < 1) return; _scannerItem = items[1]; SaveProp(_scanDevice.Properties, ref _defaultDeviceProp); SaveConfig(); } catch (Exception e) { MessageBox.Show(e.Message, "   "); } }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

スキャナーには多くのパラメーターがあり、そのうちのいくつかは他から計算する必要があるため、問題を複雑にしないために、標準のWIAダイアログCommonDialogClassを使用して構成します。 まず、プログラムのユーザーがShowSelectDeviceスキャナー（WiaDeviceType。ScannerDeviceType、true）を選択することをお勧めします。 ダイアログは、 Deviceオブジェクトを返します 。デバイスが選択されていない場合はnullを返します 。









次に、受信したデバイスShowSelectItems（_scanDevice）を構成します。 設定では、 DPI 、用紙サイズ、カラーモード、その他のパラメーターを設定できます。



このセットアップウィンドウの主な欠点は、論理的なOKではなく、[スキャン]ボタンをクリックして確認する必要があることですが、この場合、スキャンは開始されません。









構成が正常に完了したら、SaveConfig（）を呼び出して構成をファイルに保存します。



WIAは設定の保存/復元を提供しません。 私はこの部分を自分でしなければなりませんでした。 複雑なことは何もありませんでした。設定はIPropertyリストの形式で表示され、 DeviceとItemにあります。



保存するために、パラメータ名、識別子、値がセミコロンで区切られ、 DeviceとItemの設定が[device]と[item]ヘッダーで区切られた読みやすいテキスト形式を選択しました。

 private void SaveConfig() { var settings = new List<string>(); settings.Add("[device]"); settings.Add(String.Format("DeviceID;{0}", _scanDevice.DeviceID)); foreach (IProperty property in _scanDevice.Properties) { var propstring = string.Format("{1}{0}{2}{0}{3}", ";", property.Name, property.PropertyID, property.get_Value()); settings.Add(propstring); } settings.Add("[item]"); settings.Add(String.Format("ItemID;{0}", _scannerItem.ItemID)); foreach (IProperty property in _scannerItem.Properties) { var propstring = string.Format("{1}{0}{2}{0}{3}", ";", property.Name, property.PropertyID, property.get_Value()); settings.Add(propstring); } File.WriteAllLines(Config, settings.ToArray()); } private enum loadMode {undef, device, item}; private void LoadConfig() { var settings = File.ReadAllLines(Config); var mode = loadMode.undef; foreach (var setting in settings) { if (setting.StartsWith("[device]")) { mode = loadMode.device; continue; } if (setting.StartsWith("[item]")) { mode = loadMode.item; continue; } if (setting.StartsWith("DeviceID")) { var deviceid = setting.Split(';')[1]; var devMngr = new DeviceManagerClass(); foreach (IDeviceInfo deviceInfo in devMngr.DeviceInfos) { if (deviceInfo.DeviceID == deviceid) { _scanDevice = deviceInfo.Connect(); break; } } if (_scanDevice == null) { MessageBox.Show("    "); return; } _scannerItem = _scanDevice.Items[1]; continue; } if (setting.StartsWith("ItemID")) { var itemid = setting.Split(';')[1]; continue; } var sett = setting.Split(';'); switch (mode) { case loadMode.device: SetProp(_scanDevice.Properties, sett[1], sett[2]); break; case loadMode.item: SetProp(_scannerItem.Properties, sett[1], sett[2]); break; } } SaveProp(_scanDevice.Properties, ref _defaultDeviceProp); } private static void SetProp(IProperties prop, object property, object value) { try { prop[property].set_Value(value); } catch (Exception) { //       return; } }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

スキャン手順は簡単です。 ピクチャとともにMemoryStreamを返すか、スキャンが失敗した場合はnullを返します。

 public MemoryStream MemScan() { try { var result = _scannerItem.Transfer(FormatID.wiaFormatJPEG); var wiaImage = (ImageFile)result; var imageBytes = (byte[])wiaImage.FileData.get_BinaryData(); using (var ms = new MemoryStream(imageBytes)) { using (var bitmap = Bitmap.FromStream(ms)) { bitmap.Save(stream, ImageFormat.Jpeg); } } } catch (Exception) { return null; } return stream; }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

私の意見では、スキャンするときは進行状況バーを描画する方が便利なので、標準の進行状況を非表示にします。 進行状況を表示せずにスキャンするには、 Transferメソッドが使用されます。

両面/シンプレックス

多くの長距離スキャナーは、設定ダイアログから選択できる2ページスキャンモードをサポートしています。









ただし、標準ダイアログでは、 二重モードの設定を忘れることがあります。したがって、 二重モードを強制的に有効にして元の設定に戻すことができると便利です。

 public void SetDuplexMode(bool isDuplex) { // WIA property ID constants const string wiaDpsDocumentHandlingSelect = "3088"; const string wiaDpsPages = "3096"; // WIA_DPS_DOCUMENT_HANDLING_SELECT flags const int feeder = 0x001; const int duplex = 0x004; if (_scanDevice == null) return; if (isDuplex) { SetProp(_scanDevice.Properties, wiaDpsDocumentHandlingSelect, (duplex | feeder)); SetProp(_scanDevice.Properties, wiaDpsPages, 1); } else { try { SetProp(_scanDevice.Properties, wiaDpsDocumentHandlingSelect, _defaultDeviceProp[wiaDpsDocumentHandlingSelect]); SetProp(_scanDevice.Properties, wiaDpsPages, _defaultDeviceProp[wiaDpsPages]); } catch (Exception e) { MessageBox.Show(String.Format("   :{0}{1}", Environment.NewLine, e.Message)); } } }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

2ページモードでスキャンするには、1ページ目と2ページ目でMemScan（）を呼び出す必要があります。 最初の呼び出しはシートをスキャンして最初のページの画像を返し、2番目の呼び出しは2ページ目のスキャンを返します。 フィーダースキャナーを使用する場合、 MemScan（）が戻るまでループでスキャンすると便利です！= Null-これは、スキャナーが紙切れになったことを意味します。 スキャナーがどのモードで動作するかを考える必要はありません。文書はとにかくスキャンされます。 カチンコスキャナーのループでスキャンを開始する場合、スキャナーが接続されている間、スキャンプロセスは停止しません。ソフトウェアを開発するとき、このニュアンスを考慮する必要があります。





もちろん、 スキャナーはスキャナーを操作するための本格的なツールとは言えませんが、さまざまなタイプのスキャナーを操作するためのターンキーソリューションです。 この例は、下からWIAを操作する方法を示しています。 NETであり、スキャンプログラムを構築するための基礎となります。



そして、人事部の注文をスキャンします;）









ご清聴ありがとうございました、ハブレでお会いしましょう！