VisualApplets
オペレーターリファレンス

このパラメータは、オブジェクトの内部的なラベリングに使用されるビット数を設定します。また、2^label_bits によって決定される、2 つの画像行内で共存できるオブジェクトの最大数にも影響します。ブロブ解析に必要な Memory リソースは、ビットが 1 つ追加されるごとにほぼ倍増することに注意してください。このパラメータの適切な値の範囲は 7 ～ 9 ビットであり、ほぼすべてのアプリケーションで十分なはずです。

このアドレス空間のオーバーフローが検出された場合、オペレータはポート「ErrorFlagsO」のビット 0 および 1 にエラーフラグを出力します。これらのフラグは、オーバーフローの検出時に設定され、出力フレームの終了時にリセットされます。

Object Detectionに必要な近傍を選択します。ピクセル近傍の詳細な説明については、'Definition'を参照してください。

このパラメータは、オブジェクトの最大高さを指定するために必要です。たとえば、高さを 10 ビットに設定した場合、1024 画像行を超えるオブジェクトは許可されません。

オブジェクトがこの制限を超えた場合、2 つ以上の分離されたオブジェクトに分割されます。これが発生した場合、ErrorFlagsO ポートのビット番号 3 のエラーフラグが、再開されたオブジェクトとともに設定されます。

最大出力フレームサイズ、つまり 1 つの出力フレーム内のオブジェクトの最大数を選択します。

最大出力フレームサイズはパラメータ「max_output_frame_size」で指定します。オブジェクトの数がこのサイズを超える場合、オペレータは新しいフレームを生成するか、制限を超えたオブジェクトを破棄することができます。新しいフレームを生成するとフレームが終了、つまりフレームが完了します。オブジェクトが破棄される場合、オペレータはフレームの最後の有効なオブジェクトとともに、ErrorFlagsO ポートのビット番号 2 にエラーフラグを出力します。

フラッシュ入力によっても新しいフレームが生成されることに注意してください。

このパラメータは、フラッシュ条件やオブジェクトデータがないことに起因する空の出力フレームを抑制するために使用されます。

詳細なタイミング図については、'Generation of Output Frames - Flush, Empty Frames, Discarding Data'を参照してください。

各オブジェクトの "line_marker" は "LineMarkerO"に出力されます。Bit Width は入力の LineMarkerI 入力リンクによって決定されます。ラインマーカーを使用しない場合、Bit Width は出力で定数ゼロの1に設定されます。

バウンディングボックスは、オブジェクトに適合する最小の軸平行矩形を表します。各座標値は画像の左上隅からの相対値です。Bounding box X0 は、各オブジェクトの最も低い x 座標を表します。これは "BoundingX0O" から出力されます。Bit Width は入力画像によって決定されます。バウンディングボックスを使用しない場合、Bit Width は出力で定数ゼロの1ビットに設定されます。

バウンディングボックスは、オブジェクトに適合する最小の軸平行矩形を表します。各座標値は画像の左上隅からの相対値です。Bounding box X1 は、各オブジェクトの最も高い x 座標を表します。これは "BoundingX1O" から出力されます。Bit Width は入力画像から決定されます。バウンディングボックスを使用しない場合、Bit Width は出力で定数ゼロの1ビットに設定されます。

Bounding box y0 は、各オブジェクトの最も低い y 座標を表します。この座標は、オペレータの内部 Counter に基づいています。処理された最初の画像行からカウントを開始します。その最大値は、パラメータ max_object_height_bits で設定された最大高さと等しくなります。オーバーフロー後、Counter は再びゼロからカウントを開始します。

この機能は、ラインマーカーの代わりに使用できます。ただし、ラインマーカーの方がより多くの機能を提供し、複雑な設定が可能です。

この機能は "BoundingY0O" から出力されます。Bit Width は入力画像によって決定されます。バウンディングボックスを使用しない場合、Bit Width は出力で定数ゼロの1に設定されます。

（2Dオペレータとは対照的な）1Dオペレータの場合、Bounding box y1 はオブジェクトの高さを表します。これは "BoundingY1O" から出力されます。Bit Width は入力画像によって決定されます。バウンディングボックスを使用しない場合、Bit Width は出力で定数ゼロの1に設定されます。

オブジェクトの面積は、すべてのオブジェクトの前景ピクセルの合計によって定義されます。このパラメータは、必要な面積モードを選択するために使用されます。「use_area_with_maximum_required_bits」が選択されている場合、オペレータはオブジェクトの最大可能なサイズに必要なビット数を自動的に決定します。オブジェクトの最大可能なサイズは、入力リンク I の最大幅と高さによって異なります。オブジェクトの理論上の最大値は、画像のすべてのピクセルが前景色で構成されている場合、つまり、1つの大きなオブジェクトである白い入力画像の場合に達成されます。

オブジェクトの面積が指定された値より大きくならないことが確実である場合は、これをパラメータ化できます。最大オブジェクトサイズが既知の場合は、「use_area_with_specified_bits」を選択します。パラメータ「area_bits」を使用してビット数を指定します。面積がまったく必要ない場合は、「area_not_used」を選択します。「area_not_used」モードでは、Bit Width は出力で定数ゼロの1に設定されます。

このパラメータは、パラメータ "area_mode" が "use_area_with_specified_bits" に設定されている場合にのみ有効になります。オブジェクトの面積が、選択したビットで許容されるサイズよりも大きい場合、ブロブ解析は出力リンク "ErrorFlagsO" のビット番号 4 でオーバーフローフラグを出力します。

重心の説明については、'Center of Gravity'を参照してください。

正しい結果を得るには、ブロブ解析後に出力結果を面積で割る必要があることに注意してください。

パラメータが「use_cX_width_maximum_required_bits」に設定されている場合、オペレータは自動的に出力ビット数を決定します。大きな入力画像を使用する場合、必要なビット数が非常に多くなることがあります。

パラメータ値に「use_cX_with_specified_bits」を使用している場合、ビット数を調整可能です。

x方向の重心が不要な場合は、「cX_not_used」を選択して無効にすることができます。

「center_of_gravity_x_mode」に「use_cX_with_specified_bits」が設定されている場合、ここでビットを変更できます。それ以外の場合、このパラメータは無効になります。

x方向の重心のビット数を手動で設定した場合、このパラメータが有効になり、「used」に設定できます。オーバーフローが検出された場合、オペレータは出力リンク「ErrorFlagsO」のビット番号5に「1」を出力します。

重心の説明については、'Center of Gravity'を参照してください。

正しい結果を得るには、ブロブ解析後に出力結果を面積で割る必要があることに注意してください。

パラメータが「use_cY_width_maximum_required_bits」に設定されている場合、オペレータは自動的に出力ビット数を決定します。大きな入力画像を使用する場合、必要なビット数が非常に多くなることがあります。

パラメータ値に「use_cY_with_specified_bits」を使用している場合、ビット数を調整可能です。

y方向の重心が不要な場合は、「cY_not_used」を選択して無効にすることができます。

「center_of_gravity_y_mode」に「use_cY_with_specified_bits」が設定されている場合、ここでビットを変更できます。それ以外の場合、このパラメータは無効になります。

y方向の重心のビット数を手動で設定した場合、このパラメータが有効になり、「used」に設定できます。オーバーフローが検出された場合、オペレータは出力リンク「ErrorFlagsO」のビット番号6に「1」を出力します。

オブジェクトの輪郭長には、穴の部分も含め、すべてのエッジが含まれます。詳細な説明については、「Contour Length」を参照してください。

この機能を選択した場合、選択した近傍に応じて、必要なビットをパラメータ "contour_length_bits_orthogonal_connected" および "contour_length_bits_diagonal_connected" で選択できます。4連結近傍が選択されている場合、輪郭長は直交方向のみで決定できます。8連結近傍が選択されている場合、輪郭長は直交方向および対角方向で決定されます。

"contour_length_mode" が "contour_length_used" に設定されている場合、直交接続されたピクセルの輪郭長を表すために必要なビットをここで選択できます。

"contour_length_mode" が "contour_length_used" に設定されている場合、対角接続されたピクセルの輪郭長を表すために必要なビットをここで選択できます。これは、8連結近傍が選択されている場合にのみ可能です。それ以外の場合、このパラメータは無効になります。

輪郭長によりオーバーフローが発生する可能性があります。このフラグを使用すると、オーバーフローが発生した場合にポート "ErrorFlagsO" のビット番号 7 にエラーフラグが設定されます。