Image Loading vTool#

Image Loading vToolを使用すると、ディスクから画像ファイルを読み込んで、他のvToolの入力として使用できます。

Image Loading vToolは出力ピンを介して読み込まれた画像に関する情報を出力します。

仕組み#

vToolを使用すると、コンピューター上の画像ファイルが含まれているディレクトリーを指定できます。

設定に応じて、このディレクトリー内の一部またはすべての画像ファイルが読み込まれ、Image出力ピンを介して出力されます。

また、出力画像の頻度（フレームレート）と順序を指定して、vToolを基本的にカメラデバイスのように動作させることができます。

サポートされているファイルタイプ#

Windows：BMP、JPG、PNG、TIF
Linux：PNG、TIF

vToolの設定#

Image Loading vToolを設定するには：

[vToolの設定]エリアの[レシピ管理]ペインで、[設定を開く]をクリックするか、[vTool]をダブルクリックします。
[画像のロード]ダイアログが開きます。
[ソース]エリアに、画像ファイルを含んでいるディレクトリーのパスを入力します。または、[...]ボタンをクリックしてファイルを参照します。
vToolは、すべてのサポートされているファイルタイプの画像を検索します。サブディレクトリーは無視されます。

情報

ファイル名を含むフルパスを指定することもできます（例：c:\images\test.png）。

これにより、単一の画像をロードできます。このとき、テキストボックスにフルパスを入力するとロードできますが、[...]ボタンを使用した場合は読み込めないので注意してください。
[設定]エリアで、必要に応じて次の設定を指定します。
- 並べ替え規準：ディレクトリー内の画像をアルファベット順（A-ZまたはZ-A）で読み込むか、ランダムな順序で読み込むかを指定します。
- 画像数：読み込む画像の数。最大画像数は99999999枚です。
  デフォルトでは、vToolはディレクトリー内で見つかったすべての画像を読み込みます。設定を変更すると、アルファベット順で最初のn枚の画像（またはランダムに選択されたn枚の画像）のみが出力されます。
- フレーム／秒：レシピの実行中に1秒あたりに出力される画像の数。最大数は500フレーム／秒です。
- 実行回数：画像出力を繰り返す回数を指定します。例えば、ディレクトリーに10枚の画像が含まれており、実行数を3に設定した場合、vToolは30枚の画像を出力します。値の範囲は1～999999999です。
- レシピの実行中は継続的に実行：選択すると、画像出力が無期限に繰り返されます。[実行回数]オプションは使用できなくなります。
- Save absolute image source path: If selected, the folder path is saved in the recipe using its absolute path.
[出力]エリアで、表示された情報を確認し、設定が要件を満たしていることを確認します。

例#

指定されたディレクトリーに、次の3つの画像ファイルが含まれているとします。

bar.bmp
baz.png
foo.jpg

次の設定を指定します。

並べ替え規準：Z-A
画像数：2
フレーム／秒：1
実行回数：5
レシピの実行中は継続的に実行：False

これで、レシピの実行中に、vToolは1秒ごとにbaz.pngとfoo.jpgの画像を交互に出力し、10枚の画像を出力すると停止します（画像2枚 x 5回の実行）。

出力#

画像#

読み込んだ画像を返します。画像を入力として受け入れる任意のvToolで使用できます。

データ型：Image
画像形式：カラーまたはモノクロ画像（入力画像に応じる）

ImagePath#

現在出力されている画像のフルパス（ファイル名も含む）を返します。

データタイプ：文字列

RunCount#

現在の実行回数を返します。例えば、vToolが現在3回目の画像出力を実行している場合、RunCountは3を返します。値の範囲は1～2⁶⁴ - 1です。最大実行数に達すると、カウントは1から再開されます。

データタイプ：整数