Leadtools TWAIN(Leadtools.Twainアセンブリ)

フレームを表示

AcquireFastメソッド






収集されたデータを保存する画像ファイルのベース名。
メーカーのユーザーインターフェースを示すべきかどうかについて示すフラグ。
転送モードは、取得するのに用いられます
画像フォーマットは、取得するのに用いられます
取得するのに用いられるBitsPerPixelを表します
マルチページのためのtrueは取得します。そして、単一のページのために間違っています。
イメージを取得するのに用いられるバッファサイズ(バイトの)を指定します。
TWAINドライバで特定された優先バッファサイズを使うべきかどうか指定します。優先バッファサイズを使用する場合はTrue。ユーザー定義のバッファサイズを使用する場合はFalse。(bufferSizeパラメーター)。
(ドキュメント/Medicalのみ)、TWAINソースから一つ以上のイメージを取得して、指定ファイルでイメージを保存します。
構文
'Declaration
 
Public Sub AcquireFast( _
   ByVal baseFileName As String, _
   ByVal flags As TwainFastUserInterfaceFlags, _
   ByVal transferMode As TwainTransferMode, _
   ByVal format As RasterImageFormat, _
   ByVal bitsPerPixel As Integer, _
   ByVal multiPage As Boolean, _
   ByVal bufferSize As Integer, _
   ByVal usePreferredBufferSize As Boolean _
) 
'Usage
 
Dim instance As TwainSession
Dim baseFileName As String
Dim flags As TwainFastUserInterfaceFlags
Dim transferMode As TwainTransferMode
Dim format As RasterImageFormat
Dim bitsPerPixel As Integer
Dim multiPage As Boolean
Dim bufferSize As Integer
Dim usePreferredBufferSize As Boolean
 
instance.AcquireFast(baseFileName, flags, transferMode, format, bitsPerPixel, multiPage, bufferSize, usePreferredBufferSize)

            

            

パラメーター

baseFileName
収集されたデータを保存する画像ファイルのベース名。
フラグ
メーカーのユーザーインターフェースを示すべきかどうかについて示すフラグ。
transferMode
転送モードは、取得するのに用いられます
形式
画像フォーマットは、取得するのに用いられます
bitsPerPixel
取得するのに用いられるBitsPerPixelを表します
multiPage
マルチページのためのtrueは取得します。そして、単一のページのために間違っています。
bufferSize
イメージを取得するのに用いられるバッファサイズ(バイトの)を指定します。
usePreferredBufferSize
TWAINドライバで特定された優先バッファサイズを使うべきかどうか指定します。優先バッファサイズを使用する場合はTrue。ユーザー定義のバッファサイズを使用する場合はFalse。(bufferSizeパラメーター)。
解説
一つ以上のイメージを取得するために、収集メソッドを使います。
一つ以上のイメージを取得して、1つ以上のファイルに保存するために、AcquireFastメソッドを使います。
スキャナ型に基づいて、このメソッドは、使う最善/最速の走査法を決定します。この走査法が、実際にイメージをスキャンするとき、使われます。
このメソッドを呼び出す前に:最善スキャン構成を決定するために、FindFastConfigurationメソッドを呼び出すことができます。Note:AcquireFastメソッドを呼び出す前にFindFastConfigurationメソッドを呼び出さないならば、AcquireFastメソッドは最善走査法を決定します。
形式パラメーターで設定されるファイルフォーマットが複数ページのファイルをサポートしないならば、このメソッドはmultiPageパラメーターを無視して、ファイルを切り離すために自動的にスキャンされたイメージを保存します。ファイルは、baseFileNameのために使われるstringに数を追加することによって挙げられます。たとえば、baseFileNameのstringが「Temp.jpg」であるならば、ファイルの名前にとって、メソッドはimage、0001、0002などの数を追加します。したがって、出力ファイル名は「Temp0001.jpg」、「Temp0002.jpg」などであるでしょう
形式パラメーターで指定されているファイルフォーマットが複数ページのファイルをサポートするならば、このメソッドは複数イメージを保存する方法を決定するためにmultiPageパラメーターを使います。マルチがfalseに設定されるならば、各々のスキャンされたページは別々のファイルに保存されます。そして、上のパラグラフで説明されて同様に名をつけられます。multiPageがtrueに設定されるならば、出力ファイルの名前はbaseFileName(Temp.jpg)の正確なstringであるでしょう、そして、それは複数ページのファイルとして保存されます。
AcquireMultiPageイベントを使うために、AcquireFastメソッドを呼び出す前に、EnableAcquireMultiPageEvent属性値をtrueに設定しなければなりません。AcquireMultiPageイベントは、スキャンされたページごとに二回発生されます。イベントは、TWAINソースでページのスキャンが開始されたときに最初に発生します。イベントは、TWAINソースでページのスキャンが終了したときに2回目が発生します。詳細については、「TWAINソースからの取得方法」を参照してください。
詳細については、「Fast TWAIN(スキャン構成)」を参照してください。
サンプル
Copy Code  
Imports Leadtools
      Imports Leadtools.Twain

      Public Sub twain_AcquireMulti(ByVal sender As Object, ByVal e As TwainAcquireMultiPageEventArgs)
         Dim msg As String
         If e.FinishScan Then
            msg = String.Format("The page # {0} is scanned and saved to file name {1}", e.PageNumber, e.FileName)
            MessageBox.Show(msg)
         End If

         e.Cancel = False
      End Sub


#If Not LEADTOOLS_V19_OR_LATER Then
      Public Sub AcquireFastExample(ByVal parent As IWin32Window)
#Else
      Public Sub AcquireFastExample(ByVal parent As IntPtr)
#End If ' #If LEADTOOLS_V19_OR_LATER Then
         Dim session As TwainSession = New TwainSession()
         session.Startup(parent, "manufacturer", "productFamily", "version", "application", TwainStartupFlags.None)

         session.EnableAcquireMultiPageEvent = True
         AddHandler session.AcquireMultiPage, AddressOf twain_AcquireMulti

         session.AcquireFast(Path.Combine(LEAD_VARS.ImagesDir, "test.tif"), TwainFastUserInterfaceFlags.Show, TwainTransferMode.Buffer, RasterImageFormat.Tif, 1, True, 0, True)
         session.Shutdown()
      End Sub

      Public NotInheritable Class LEAD_VARS
      Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images"
      End Class
using Leadtools;
      using Leadtools.Twain;

      public void twain_AcquireMulti(object sender, TwainAcquireMultiPageEventArgs e)
      {
         string msg;
         if (e.FinishScan)
         {
            msg = String.Format("The page # {0} is scanned and saved to file name {1}", e.PageNumber, e.FileName);
            MessageBox.Show(msg);
         }

         e.Cancel = false;
      }

#if !LEADTOOLS_V19_OR_LATER
      public void AcquireFastExample(IWin32Window parent)
#else
      public void AcquireFastExample(IntPtr parent)
#endif // #if !LEADTOOLS_V19_OR_LATER
      {
         TwainSession session = new TwainSession();
         session.Startup(parent, "manufacturer", "productFamily", "version", "application", TwainStartupFlags.None);

         session.EnableAcquireMultiPageEvent = true;
         session.AcquireMultiPage += new  EventHandler<TwainAcquireMultiPageEventArgs>(twain_AcquireMulti);

         session.AcquireFast(Path.Combine(LEAD_VARS.ImagesDir, "Out_test.tif"),
                             TwainFastUserInterfaceFlags.Show,
                             TwainTransferMode.Buffer,
                             RasterImageFormat.Tif, 1, true, 0, true);
         session.Shutdown();
      }

      static class LEAD_VARS
      {
      public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images";
      }
必要条件

ターゲットプラットホーム

参照

参照

TwainSessionクラス
TwainSessionメンバ
Startupメソッド
Shutdownメソッド
Leadtools.Twain.TwainSession.AcquireMultiPage
FindFastConfigurationメソッド
EnableAcquireMultiPageEventプロパティ