WriteImageFTP
取り込み中の画像をネットワークの FTP サーバに出力します。画像ファイルとして、画像上にグラフィックスオーバレイを含めた SVG ファイルを作成することもできます。一般的には、検査に失敗した画像を自動保存するために使用します。
- この関数では、画像ファイルと SVG ファイルを送信するために In-Sight ビジョンシステムがオンラインである必要があります。
- In-Sight ビジョンシステムにリモートでログオンしている場合、関数を使用すると、画像取り込みごとに画面の画像が更新されないことがあります。
- 関数を含む、メモリを多く使用するジョブが繰り返し実行されると、FTP コマンド「Get image.jpg」 (または .bmp) は失敗する場合があります。これは、ビジョンシステムのメモリが断片化されすぎるためです。ジョブの実行は正常に継続されます。
- ビジョンシステムをオンラインにしているときに AcquireImage パラメータを変更すると、関数によって現在の画像が送信されます。
- この関数を含むジョブを In-Sight Explorer 3.3.0 以上で保存した場合、このジョブは、In-Sight Explorer 3.3.0 以上とのみ互換性を持ちます。
- FTP サーバ接続のポート番号を変更するには、ホスト名 (または IP アドレス)、コロン (:)、新しいポート番号の順に追記します。例えば、現在のホスト名が PRODUCTION1 である場合、ポート番号をデフォルト (ポート 21 含む) からポート 34 に変更するには、ホスト名パラメータに PRODUCTION1:34 と指定します。
- 保存された画像のデフォルト位置をエミュレータフォルダとして保持し、ディレクトリに 250 以上の画像ファイルの保存を許可する場合、ビジョンシステムはファームウェアの更新を実行することができなくなります。ディレクトリから画像ファイルを削除して、ファームウェアの更新機能を回復させます。
-
In-Sight エミュレータを FTP サーバとして使用している場合、デフォルトで、ファイルは次のエミュレータフォルダに書き込まれます (C:\ProgramData\Cognex\In-Sight\Emulators\x.x.x)。このディレクトリ以外のユーザ指定のロケーションにもファイルを書き込むことができます (FTP ルートディレクトリ)。エミュレータディレクトリおよび FTP ルートディレクトリの詳細については、[オプション] ダイアログのトピック (エミュレーションパネル) を参照してください。
WriteImageFTPの入力パラメータ
Syntax:WriteImageFTP(イベント,ホスト名,ユーザ名,パスワード,画像,ファイル名,最大追記値,リセット,データフォーマット,グラフィックスオーバーレイの保存,解像度,FTP キューを無効にする)
指定した値を読み取るイベントを指定します。このパラメータは、次のいずれかを参照している必要があります。
注 : デフォルトのイベント参照が削除された場合、この値はチェックボックスで置き換えられます。イベントとして別のセルを参照した場合、この関数は、参照されたセルに基づき、条件に従って実行されます。このチェックボックスが ON の場合、関数への入力が更新されると、関数は必ず実行されます。
|
|||||||
画像ファイルの出力先になるネットワーク上のホスト名 (または IP アドレス) を指定します。出力先のデバイスとしては、ネットワーク上の In-Sight エミュレータまたは FTP サーバとして動作するホストがあります。 注 :
|
|||||||
出力先ホストの FTP サーバ用の有効なユーザ名です。このユーザ名は、画像ファイル出力元の In-Sight ビジョンシステムに登録されている必要はありません。 |
|||||||
出力先ホストの FTP サーバ用の有効なパスワードです。パスワードは最大 15 文字で、大文字と小文字の区別があります。 注 :
|
|||||||
画像データ構造体を含むセルへの参照です。デフォルトの参照先は、セル A0 の画像データ構造体です。 |
|||||||
書き込む画像ファイルの名前です。[グラフィックスオーバレイ] パラメータが有効な場合は、SVG ファイルの名前も定義します。ロングファイル名がサポートされ、各ファイルが出力される時、それぞれのファイル名に数値カウンタが付加されます (数値カウンタの最大値は、[最大追記値] で指定します)。パスが指定されていない場合は、画像ファイルは出力先ホストにある FTP サーバのデフォルトディレクトリに出力されます。 注 : ファイルを FTP ルートディレクトリに書き込む場合、ファイル名は [オプション] ダイアログで指定した [FTP ルートディレクトリ] と完全に一致しなければなりません。画像ファイルも、FTP ルートディレクトリ内の任意のサブディレクトリに書き込むことができます (サブディレクトリはあらかじめ存在している必要があります)。例えば、FTP ルートディレクトリが C:\temp で、ファイル名が「Failed」の場合は、ファイル名を「C:\temp\Failed」と指定する必要があります。「Images」サブディレクトリに書き込む場合、ファイル名は「C:\temp\Images\Failed」となります。「Failed」とのみ指定した場合、ファイルはデフォルトのエミュレータディレクトリに書き込まれます。
|
|||||||
指定されたファイル名で出力する画像ファイルの最大数 (0 ~ 9999999、デフォルト = 999)。数値カウンタは指定されたファイル名の後ろに付加され、各画像ファイルが転送されるごとにカウンタは 1 つ増加します。カウンタが最大追記値に達するとリセットされ、出力先のシステムにある画像ファイルは同じ名前の新しいファイルで上書きされます。 数値カウンタの桁数は、最大追記値の桁数と等しくなります。例えば、最大追記値のデフォルト値 999 の場合は、ファイル名に 3 桁の数値が付加されます。0 が指定された場合は、ファイル名にカウンタは付加されません。 |
|||||||
画像ファイルと SVG ファイルの両方に指定したファイル名に付加された数値カウンタを再開します。出力先のシステムに既にある画像ファイルと SVG ファイルは、同じ名前の新しいファイルで上書きされます。
|
|||||||
送信先のホストに書き出される画像のファイルフォーマットです。
|
|||||||
In-Sight ビジョンツール、幾何計測関数および画面表示関数でサポートされているオーバレイグラフィックスデータを含めた SVG ファイルを、各関数の [表示] パラメータでグラフィックスを表示するように設定された場合に、作成するかどうかを指定します。オーバレイグラフィックスは [セルのフォーマット] ダイアログで指定したフォーマットを使用します。SVG ファイルと画像ファイルを表示するには SVG ファイルタイプをサポートする Web ブラウザ (Microsoft Internet Explorer 9.0 など) で SVG ファイルを開きます。SVG ファイルには、このファイルに関連する取得画像へのリンクが含まれており、ブラウザで SVG ファイルを開くと、このリンクを使用して、取得画像と共にオーバレイグラフィックスを表示します。 注 :
|
|||||||
解像度 |
画像がエクスポートされるときの画像解像度を指定します。
|
||||||
FTP キューを無効にする |
FTP 転送の前に画像をキューに入れるかどうかを指定します。
|
WriteImageFTPの出力
戻り値 |
FTP データ構造体を返します。スプレッドシートが更新されるたびに、指定された画像データ構造体に含まれている画像データが出力先システムのファイルに出力されます。 出力先ホスト名、ユーザ名、パスワードなどの入力パラメータが無効な場合、または画像キューが満杯の場合、#ERR を返します。画像キューには、一度に 1 つの画像を含めることができます。WriteImageFTP を実行し、前の画像が送信される前に画像の送信を試みると、関数はエラーを返します。 注 :
|
WriteImageFTP例
WriteImageFTP($A$0,"SYSTEM1","admin","*",$A$0,"\IMAGES\TEST",999,0,0,0,1,0)
画像を取り込んだ後にスプレッドシートが更新されると、上記の式によって、ネットワークにあるホスト名が SYSTEM1 の IMAGES ディレクトリにビットマップ画像が転送されます。ユーザ名が admin で、そのパスワードと IMAGES ディレクトリが SYSTEM1 に存在する必要があります。存在しない場合、スプレッドシートに #ERR が返されます。最初に転送されたファイルは、TEST000.BMP、2 番目が TEST001.BMP というように連続して出力されます。