コンテンツにスキップ
ステージングサーバー
開発サーバー

vTools#

vToolsは、Workbenchを使用して画像処理デザインを作成するためのビルディングブロックです。

それぞれのvToolは、特定のタスク(数例を挙げるとすれば、カメラのキャリブレーション、画像形式の変換、バーコードの読み取りなど)を実行できます。Workbenchに、必要なvToolsを追加し、必要な順序でそれらを接続してから、そのデザインをレシピファイル(.precipe)として保存します。最後に、レシピをアプリケーションに追加できます。

vToolsの設定時に、画像をロードしてレシピを実行することで、変更内容を素早くテストできます。Workbenchのセクションであるpin data viewでは、実行時の結果を確認できます。設定を調整し、満足いく結果が得られるまでこのプロセスを繰り返します。

アプリケーションへのvToolsの統合#

画像処理デザインをご自身のアプリケーションに統合するには、pylon C++ Data Processing APIを使用します。このAPIには、レシピのロードや実行、プログラムコードでの結果の評価を行うための、さまざまなシンプルで便利な機能が用意されています。

pylon Viewerで行ったレシピ設定の変更は、そのレシピをアプリケーションに再度ロードしたときに有効になります。アプリケーションのコードを変更したり、再コンパイルしたりする必要はありません。

pylon C++ Data Processing APIには、一般的なユースケースを示すいくつかのサンプルが用意されています。サンプルコードには、いくつかのdemo vToolsが組み込まれています。

詳細については、pylon ViewerのHelpメニューまたはpylonのインストールディレクトリ(通常はC:\Program Files\Basler\pylon\Development\Documentation\PylonCppDataProcessingSDK.chm)にあるpylon C++ Data Processing Programmer's Guideを参照してください。

データ生成型vToolsとデータ処理型vTools#

vToolsは、データを生成するものと、データを処理するものの2つのカテゴリのいずれかに分類されます。この特性はレシピに追加された際のvToolsの動作に影響するため、違いを把握しておくことが重要です。

名前が示すように、data-generating vToolsは、それ自体で(つまり入力ピンを持たずに)新しいアップデートごとにデータを生成するか、あるいは入力ピンを介して受け取ったデータを新しいデータに変換することによってデータを生成します。アップデートの概念の詳細については、pylon ViewerのHelpメニューまたはpylonのインストールディレクトリ(通常はC:\Program Files\Basler\pylon\Development\Documentation\PylonCppDataProcessingSDK.chm)にあるpylon C++ Data Processing Programmer's Guideを参照してください。
以下のvToolsはデータを生成します:

  • Array Element Iterator vTool
  • カメラvTool
  • Data Synchronizer vTool
  • Image Loading vTool
  • Multiplexer vTool
  • Test Image Generator vTool

その他のすべてのvToolsはデータを処理するだけです。データ生成型vToolsの出力ピンは三角形状になっており、処理型vToolsと視覚的に区別しやすくなっています。

デフォルトでは、データ生成型ピンからのconnectionsのキューモードはUnlimitedに設定されています。

Data-Generating および Data-Processing vTool ピンの例

使用可能なvTools#

一部の vTool は無料であり、pylon Viewer のセットアップに含まれています。その他の vTool にはライセンスが必要です。ライセンスの取得方法と有効化方法の詳細については、vTool Licensing を参照してください。

個別の vTool のライセンスのほかに、特定のユースケースに必要な vTool など、1 つのライセンスにバンドルされた複数の vTool の組み合わせを購入することもできます。

無料のvTools#

ライセンス可能なvTools#

デモ用 vTool#

デモ用 vTool は、特定の一般的なユースケースを示す pylon 付属のサンプルを実行できるように提供されています。

デモ用 vTool のドキュメントについては、pylon Viewer に含まれている vTool Documentation ペインを参照してください。

  • Test Image Generator vTool
  • Stamp vTool

実験的 vTool#

実験的 vTool は通常、お客様からのご要望に応じて、または汎用的な開発ツールとして作成されます。これらは開発の初期段階で公開されます。ユーザビリティや完成度の面では、他の vTool と同等の高い基準を満たしておらず、今後のリリースで大幅な変更が行われる可能性があります。Basler では、これらの vTool に対するフィードバックを受け付けています(設定ダイアログのフィードバックリンクからお送りください)。

実験的 vTool のドキュメントについては、pylon Viewer に含まれている vTool Documentation ペインを参照してください。

  • Data Writer vTool
  • Free-Form OCR vTool

ライセンスとバンドル#

vTool には個別で購入できるものもあれば、Color Blob Analysis などの特定のユースケース向けにバンドルの一部として利用できるものもあります。以下に、利用可能なライセンスとライセンスバンドルの概要を示します。

Blob Analysis Basic#

Blob Analysis ライセンスには、グレー値の範囲による領域の特定など、一般的な閾値処理ベースのブロブ解析タスク用の pylon vTools が含まれています。

領域用 vTools と組み合わせて閾値処理用 vTools を使用することで、領域、オブジェクト、構造を優れた堅牢性、精度、パフォーマンスで特定および解析できます。

このライセンスには、以下の vTools が含まれています。

ライセンスを購入するには、Basler ウェブサイトにアクセスしてください。

Color Blob Analysis Basic#

Color Blob Analysis ライセンスには、一般的なグレースケール閾値処理テクニックでは解決できないブロブ解析タスク(色によるオブジェクトの特定など)用の pylon vTools が含まれています。

画像を読み込み(ライブ画像またはディスク上の画像)、興味のあるオブジェクトに属するピクセルをマークしてモデルをトレーニングするだけで、そのモデルを新しい画像に適用できます。領域用 vTools と組み合わせてこのモデルを使用することで、領域、オブジェクト、構造を優れた堅牢性、精度、パフォーマンスで特定および解析できます。

このライセンスには、以下の vTools が含まれています。

ライセンスを購入するには、Basler ウェブサイトにアクセスしてください。

Measurements Pro#

Measurements Pro ライセンスには、1 つの線に沿ったエッジ間の距離の測定や、長方形や円などの幾何学的形状の測定を行うための vTools が提供されています。

測定用 vTools は Calibration vTool と組み合わせて使用できます。vTools を接続すると、測定されたすべての距離が校正された単位で返されます。

このライセンスには、以下の vTools が含まれています。

ライセンスを購入するには、Basler ウェブサイトにアクセスしてください。

Preprocessing Basic#

Preprocessing Basic ライセンスには、画像の算術演算、平滑化、モルフォロジー演算を行うための vTools が提供されています。

これらの高性能アルゴリズムを使用することで、画像の特徴を強調、マスク、または抑制し、後続の処理ステップに向けて画像を改善および最適化できます。

このライセンスには、以下の vTools が含まれています。

ライセンスを購入するには、Basler ウェブサイトにアクセスしてください。

Code Reader Bundle#

Code Reader Bundleライセンスには、BasicおよびProバージョンのすべてのコード読み取り用vToolsが含まれています。

ライセンスを購入するには、Basler ウェブサイトにアクセスしてください。

General vTools Pro Bundle#

General vTools Pro Bundleライセンスを使用すると、さまざまなBasler vToolsを利用できます。次のバンドルおよび個別のvToolsが含まれています。

ライセンスを購入するには、Basler ウェブサイトにアクセスしてください。

入力ピンと出力ピン#

それぞれのvToolには、vToolsにデータを供給し、デザインの次の手順にデータを渡すための入力ピンと出力ピンがあります。vToolsを接続するには、出力ピンをクリックし、同じタイプの別のvToolの入力ピンに接続をドラッグします。すなわち、Camera vToolのImage出力ピンをBarcode Reader vToolのImage入力ピンにドラッグします。

入力端子と出力端子は、レシピの入力/出力ピンと見なすことができます。入力端子を使用して、データをvToolの入力ピンにプッシュし、出力端子を使用して、データをvToolの出力ピンから受信できます。

さらに、入力端子を介してカメラをレシピに直接割り当てることもできます。これにより、Camera vToolを使用せずに、レシピ内でカメラの画像ストリームを使用できます。

次のスクリーンショットは、vToolsと端末の接続方法を示しています。

vToolsの接続

ミニマップ#

レシピに多数のvToolsが含まれている場合、[Workbench]ペインのサイズによっては、すべてが表示されないことがあります。そのような状況では、可視エリアの外側でvToolsを表示するミニマップを確認できます。

vToolsの設定#

vToolに応じて、設定ダイアログまたは[Features - All]ペインのvToolパラメーターを介して、あるいはその両方を組み合わせて、設定することができます。詳細については、設定するvToolのトピックを参照してください。