ファイルへ保存

ファイルには、このツールでテキストを書き込みます。

パラメーター「ファイル名」でのパスおよびファイル名を入力します。コネクター「接続」が 1 に設定され、MVApp が実行されている場合、ファイルは MVApp によって作成されて開かれます。ファイルが MVApp によって開かれている限り、別のプロセスでこのファイルを使用することはできません。「接続」が 1 に設定されている場合、MVApp の各実行に書き込み操作が適用されます。MERLIC を 1 回実行するボタンは、このツールをシングルステップで実行するときに使用します。その場合、テキストを段階ごとに書き込むことができます。ファイルを閉じるには、コネクター「接続」を 0 に設定します。

実行の動作

実行に関するこのツールの動作は、デフォルトの動作とは異なります。通常、MERLIC ツールは以下の場合に実行されます。

MERLIC Vision App は、連続モードで明示的に実行されています。
MERLIC Vision App は、「1 回実行」モードで明示的に実行されています。
MERLIC Vision App とツールが MERLIC Creator で開かれています。
ツールのパラメーター値が MERLIC Creator で変更されました。

ただし、ツール「ファイルへ保存」は、以下の場合にのみ実行されます。

MERLIC Vision App は、連続モードで明示的に実行されています。
MERLIC Vision App は、「1 回実行」モードで明示的に実行されています。

これにより、MVApp の読み込み時または、ツールのパラメーターの変更時に書き込み操作が適用されなくなります。

パラメーター

基本パラメーター

ファイル名:

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

接続:

このパラメーターはファイルとの接続を有効にするか無効にするかを定義します。パラメーターの設定値はデフォルトで 0 です。その場合、ファイルとの接続は無効であり、ファイルが書き込み用に作成されるか、または開かれることはありません。ファイルへのデータ書き込みを開始するには、パラメーターを 1 に設定して、「実行」または「1 回実行」を通じて MVApp を実行する必要があります。

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

テキスト:

このパラメーターには、ファイルに書き込まれたテキストが含まれます。テキストは、文字列、数字、またはその両方を含めた複合タプルとして定義できます。パラメーターはデフォルトで空です。したがって、入力フィールドにテキストを直接入力するか、たとえばテキストや数字の読み取りなど、前のツールから利用できるテキストで希望するテキストを定義してください。

前のツールの結果は、現在のパラメーターのコネクターに 1 つだけ接続できます。したがって、複数のツールの結果を組み合わせてファイルに書き込む場合、最初に、ツール式を判定で複合データを含むタプルを作成する必要があります。

ディレクトリの作成:

このパラメーターは、パラメータ「ファイル名」で指定されたディレクトリがまだ存在しない場合に、MERLIC がそのディレクトリを作成するかどうかを定義します。デフォルトの値は 0 に設定されており、ディレクトリは作成されません。1 に設定し、「ファイル名」で指定されたディレクトリが存在しない場合には、MVAppが実行されるとすぐに、存在しないディレクトリが MERLIC によって作成されます。

追加パラメーター

ファイル処理:

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

モード:

このパラメーターは選択したファイルにデータを書き込むモードを定義します。このパラメーターのデフォルト設定値は「上書き」です。対応するコネクタで以下のモードのいずれかを選択できます。以前のツールと「ファイル処理」が接続されていると、このパラメーターは無効になります。

値	説明
上書き	このモードを選択すると、選択したファイルを書き込み用に開いたときに、そのファイルのすべてのデータがパラメーター「テキスト」のデータで上書きされます。パラメーター「接続」が 1 に設定されている場合、ファイルが書き込み用に開かれます。以前のデータは失われます。ファイルを複数回上書きするには、パラメーター「接続」を 0 に設定し、その都度 1 に戻す必要があります。
追加	このモードを選択すると、パラメーター「テキスト」のデータは選択したファイルのデータの最後に追加されます。以前のデータは失われません。

値

説明

上書き

このモードを選択すると、選択したファイルを書き込み用に開いたときに、そのファイルのすべてのデータがパラメーター「テキスト」のデータで上書きされます。

パラメーター「接続」が 1 に設定されている場合、ファイルが書き込み用に開かれます。以前のデータは失われます。ファイルを複数回上書きするには、パラメーター「接続」を 0 に設定し、その都度 1 に戻す必要があります。

追加

このモードを選択すると、パラメーター「テキスト」のデータは選択したファイルのデータの最後に追加されます。

以前のデータは失われません。

セパレータ:

このパラメーターは、ファイルに書き込まれる「テキスト」の各データ間に挿入されるセパレータのタイプを定義します。このパラメーターのデフォルト設定値は「スペース」です。対応するコネクタで以下のセパレータタイプのいずれかを選択できます。

値	説明
スペース	データは以下の文字で区切られてファイルに書き込まれますスペース。
コンマ	データは以下の文字で区切られてファイルに書き込まれますコンマ。
セミコロン	データは以下の文字で区切られてファイルに書き込まれますセミコロン。
ドット	データは以下の文字で区切られてファイルに書き込まれますドット。
コロン	データは以下の文字で区切られてファイルに書き込まれますコロン。
タビュレーター	データは以下の文字で区切られてファイルに書き込まれますタビュレーター。
なし	データはセパレータなしでファイルに書き込まれます。

新規ラインを追加:

このパラメーターは、ファイルに書き込むテキストの最後に新しい行を追加するかどうかを定義します。パラメーターの設定値はデフォルトで 1 です。その場合、データ間に新しい行が追加されます。同じ行にすべてのデータを書き込むには、値を 0 に設定します。

結果

基本結果

カレントファイル名:

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

ツール状態:

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

追加結果

ファイル処理使用済み:

この結果はデータが書き込まれたファイルの処理を示します。このハンドルは、以下のツールで読み書きに使用できます。予期しない影響が生じる可能性があるため、同じファイルに同時に読み取りまたは書き込みを行う同じハンドルを、複数のツールで使用しないでください。

この結果以外に、このツールは MERLIC で表示される結果はありません。実際の結果はテキストが書き込まれたファイルです。

処理時間:

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

アプリケーションの例

このツール、以下の MERLIC Vision App 例で使用します:

measure_distance_to_center_led.mvapp