ファイルから読み取り

このツールを使用して、ファイルからテキストを読み取ります。

パラメーターファイル名で読み取るファイルのパスを入力します。パラメーター「接続」を 1 に設定してファイルを読み取りのために開きます。MERLIC を 1 回実行するボタンは、このツールをシングルステップで実行するときに使用します。テキストを段階毎に読み取れるようになります。パラメーター「接続」を 0 に設定してファイルを閉じ、MERLIC を 1 回実行します。MVApp によって開かれている間、ファイルには別のプロセスからもアクセスできます。

パラメーター

基本パラメーター

ファイル名:

このパラメーターはテキストを読み取るファイルの名前およびパスを定義します。デフォルトでは「Me_log.txt」に設定され、それはディレクトリ「%USERPROFILE%\Documents」にあります。対応するコネクターで目的のファイル名とパスの変更や選択ができます。相対ファイルパスを定義すると、ファイルはデフォルトのディレクトリ「%USERPROFILE%\Documents」を基準に検索されます。ただし、相対ファイルパスを定義したときに、すでに MVApp が保存されていた場合は、ファイルは MVApp があるディレクトリを基準に検索されます。

接続:

このパラメーターはファイルとの接続を有効にするか無効にするかを定義します。パラメーターの設定値はデフォルトで 0 です。その場合、ファイルとの接続は無効であり、ファイルが読み取り用に開かれることはありません。選択したファイルの読み取りを開始するには、パラメーターを 1 に設定してファイルを開く必要があります。

値を変更するたびにツールが実行されるため、ツールの構成が完全に終わるまでは、パラメーター「接続」を 0 に設定することをお勧めします。

読み取りモード:

このパラメーターはカ読み取りモードを定義します。このパラメーターのデフォルト設定値は「単語」です。対応するコネクターで「読み取りモード」を変更できます。

値	説明
文字	テキストは文字ごとに読み取られます。
単語	テキストは単語ごとに読み取られます。
直線	テキストは行ごとに読み取られます。

サイクル当たりの読み取りアクセス数:

MERLIC Vision App を一度実行したときに、このパラメーターは読み取りアクセスが何回できるかを定義します。パラメーターの設定値はデフォルトで 1 です。すなわち、「読み取りモード」を「単語」に設定すると、サイクルごとに 1 単語が読み取られます。

追加パラメーター

ファイル処理:

このパラメータでは、「ファイル処理」がすでに定義済みの、前のツールから読み取るファイルのハンドルを指定できます。このパラメーターを設定すると、パラメーター「ファイル名」は無視され、代わりに「ファイル処理」を定義したファイルが適用されます。

結果

基本結果

テキスト:

この結果では、文字列としてファイルから読み取ったテキストが返ります。

ファイル終了:

この結果はファイルの末尾に到達したかどうかの情報を提供します。ブール値として返されます。値が 1 の場合、ファイルの末尾に達しています。

カレントファイル名:

この結果には、最後の反復で読み取られたファイルの名前と絶対ファイルパス、たとえば「C:\Users\Public\Documents\MVTec\MERLIC\Me_log.txt」が含まれます。

ツール状態:

「ツール状態」はツール状態の情報を返します。したがって、エラー処理に使うことができます。さまざまなツールの状態結果の詳細については、ツール状態結果のトピックを参照してください。

追加結果

ファイル処理使用済み:

この結果はテキストを読み取ったファイルのハンドルを示します。このハンドルは、以下のツールで読み書きに使用できます。複数のツールで同じハンドルを使用して同じファイルに対して同時に読み書きをするのは避けてください。予想外の結果になることがあります。

処理時間:

この結果は、ツールの直近の実行の持続時間をミリ秒単位で返します。結果は、追加結果として提供されます。したがって、デフォルトでは非表示になっていますが、ツール結果の横にあるボタンを使用して表示できます。詳細については、ツールリファレンス概要の処理時間の節を参照してください。