Grid Creator vTool#
グリッドを設計するには、行数と列数、および個別のセルの高さと幅を指定する必要があります。また、グリッドを画像全体に配置するか、画像の一部のみに配置するかを設定することもできます。デフォルトでは、グリッドは画像の左上のピクセルから始まります。オフセットを指定することで、関心領域（ROI）が始まる場所にグリッドを配置できます。
Grid Creator vToolを使用するには、pylon Software Suiteをダウンロードしてください。
前提条件#
- アプリケーションでは画像サイズが一定である必要があります。画像サイズが変動する場合、グリッドが収まらなくなる可能性があります。
- Grid Creator vToolを設定する前に、そのImage入力ピンを別のvToolのImage出力ピンに接続する必要があります。
ユースケースシナリオ#
関心領域（ROI）に応じて、Grid Creatorを使用するシナリオには2つの異なるパターンがあります。
- ROIが画像全体をカバーしている場合。
- ROIが画像の一部のみをカバーしている場合。
これらのシナリオでは、vToolを設定する際に異なるアプローチが必要になります。
画像全体をカバーする ROI#
これはシンプルなケースです。ソース画像を取得し、行数と列数を数えて、Auto Size Grid機能を有効にします。これはサンプル入力画像です：
列数は5、行数は5です。必要な設定は次のようになります：
ピンデータビューを開き、ImageLoading ImageピンとGridCreator Rectanglesピンを選択します。ここでレシピを実行すると、25個のセルが検出されたことが確認できます：
また、Regions出力ピンを有効にすると、カラーのオーバーレイによってグリッドがより鮮明に表示されます：
画像の一部をカバーする ROI#
このユースケースでは、もう少し手順が必要になります。サンプル画像には、箱に入れられた30本の単3形乾電池が表示されています。一部の電池は向きが逆（つまり、底面が上）になっています。それらの間の間隔は不規則であり、画像全体を満たしていません。
もう一度、列と行を数えます。列は 5、行は 6 です。これらの値を入力し、Auto Size Grid パラメータを有効にすると、結果は次のようになります。
ご覧のとおり、30 個のセルを持つグリッドが画像上に配置されています。ただし、マージンが考慮されていないため、すべてのセルにちょうど 1 つの電池が含まれているわけではありません。特に列 4 では、1 つのセル内に 2 つの電池の一部が映り込んでいるため、結果が曖昧になります。
グリッドのレイアウトを改善するには、Auto Size Grid パラメータを無効にします。その代わりに、セルの幅と高さ（つまり電池の幅と高さ）や、グリッドの開始位置となる垂直方向および水平方向のオフセットを手動で指定する必要があります。デフォルトでは、グリッドの原点は左上隅（0,0）にあります。
画像上のピクセルにマウスを合わせると、画像ウィンドウのステータスバーでそのピクセルの座標を確認できます。
ピクセル座標を使用して、グリッドに必要な Property を決定し、対応するパラメータ値を指定できます。
レシピの実行中に、納得いくまで幅、高さ、寸法を微調整できます。最終的な結果は次のようになります。
各電池がグリッドのセルで覆われていることがわかります。30 個すべての電池が検出されました。
vToolの設定#
Grid Creator vTool を設定するには、Workbench でダブルクリックします。利用可能なすべての設定が表示されたダイアログが開きます。または、Features - All ペインでも同じ設定を見つけることができます。
- Grid Creator の Image 入力ピンを、別の vTool の Image 出力ピンに接続します。
- 画像内の列数と行数を数え、対応する Number of Columns および Number of Rows 入力フィールドに値を入力します。
- グリッドで画像全体をカバーしたい場合は、Auto Size Grid パラメータを選択します。
これにより、指定した列数と行数に基づいて、vTool が画像をセルに分割できます。より小さなグリッドが必要な場合は、次の手順に進みます。 - Auto Size Grid パラメータを無効にします。
- 個々のセルの幅と高さを決定し、対応する Cell Width および Cell Height パラメータに値を入力します。
以下のヒントを参照してください。 - 水平方向および垂直方向のオフセットを指定します。
ヒント
Regions 入力ピンを有効にすると、さまざまな領域（つまりセル）を示すオーバーレイが入力画像上に表示されます。これにより、レシピの実行中にピンデータビューで設定の効果をすぐに確認できます。これを行うには：
- Regions Output Pin パラメータを選択します。
- ピンデータビューを開き、画像ソース vTool の Image ピンと Grid Creator の Regions ピンを選択します。
- レシピを開始します。
グリッドを合わせるために、設定を少し調整する必要がある場合があります。画像内のピクセルにマウスカーソルを合わせると、ピンデータビューのステータスバーにそのピクセルの座標（X/Y）が表示されます。これは適切な設定を見つけるのに役立ちます。
入力#
画像#
Camera vTool または画像を出力するその他の vTool から直接画像を受け入れます。
- データ型：Image
- 画像フォーマット：8ビットおよび16ビットのモノクロまたはカラー画像（Supported Pixel Formatsを参照）
出力#
長方形#
グリッドの各セルに対して長方形を返します。
- データ型：RectangleF Array
領域#
グリッド内の領域数を返し、画像上の領域を視覚化します。
- データ型：Region Array
サポートされているPixel Format#
次の Pixel Format がネイティブでサポートされています。
- Mono 8
- Mono 16
- Bayer XX 8
- Bayer XX 16
- RGB 8
- BGR 8