# ブロブデータアクセス関数

このトピックでは、ブロブ関数から値を取得できるデータアクセス関数のリストを記載します。

注: 次の関数はそれぞれ、最初のパラメータとしてブロブデータ構造体を参照します。インデックス (ゼロから始まる) は、構造体の中でそのインデックスが付いているブロブを指定します。インデックスを指定しない場合、インデックスはデフォルトでゼロになります (つまり、最初のブロブが返されます)。

関数 | 説明
GetAngle(ブロブ, [インデックス]) | ROI の中心に対するブロブの重心の角度を返します。 ブロブの重心は、そのブロブのバランスポイントを表します。均一な材料のシートをブロブの形状に切り取った場合にバランスがとれる点が重心です。ブロブの重心が、実際にブロブ自体の中にあるとは限りません。
GetArea(ブロブ, [インデックス]) | ブロブの面積 (ピクセル単位) を返します。 ブロブの面積は、ブロブ内に含まれるピクセル数をカウントすることによって計算されます。
GetColor(ブロブ, [インデックス]) | ブロブの色の値 (0.0 = 黒、1 = 白) を返します。
GetElongation(ブロブ, インデックス) | 指定されたブロブの伸長を返します。
GetHeight(ブロブ, [インデックス]) | インデックスで指定されたブロブの高さを返します。
GetHoles(ブロブ, [インデックス]) | ブロブに含まれている穴の数を返します。
GetMaxX (ブロブ, [インデックス]) | ブロブの最大 (右端) の X 座標を返します。
GetMaxXY (ブロブ, [インデックス]) | ブロブの最大 (右端) の X 座標での Y 座標を返します。
GetMaxY (ブロブ, [インデックス]) | ブロブの最大 (下端) の Y 座標を返します。
GetMaxYX (ブロブ, [インデックス]) | ブロブの最大 (下端) の Y 座標での X 座標を返します。
GetMinX(ブロブ, [インデックス]) | ブロブの最小 (左端) の X 座標を返します。
GetMinXY (ブロブ, [インデックス]) | ブロブの最小 (左端) の X 座標での Y 座標を返します。
GetMinY (ブロブ、インデックス) | ブロブの最小 (上端) の Y 座標を返します。
GetMinYX (ブロブ, [インデックス]) | ブロブの最小 (上端) の Y 座標での X 座標を返します。
GetNFound (ブロブ) | 指定された ROI 内で検出されたブロブの数を返します。
GetPerimeter(ブロブ, [インデックス]) | ブロブの周囲長 (ピクセル単位) を返します。 ブロブの周囲長は、ブロブに含まれるすべてのピクセルの外部ピクセルエッジ数をカウントすることで計算します。
GetPolygon(ブロブ, インデックス, [表示]) | 指定したブロブの境界点を表すポリゴンデータ構造体を返します。ポリゴンデータ構造体は、[外部定義領域] パラメータのある関数の入力として使用できます。これにより、ブロブの境界内で画像処理を実行できます。 注: 必要に応じて、[表示] パラメータを指定できます。0 (デフォルト) に設定すると、GetPolygon 関数のセルが選択されている場合にのみポリゴングラフィックスが表示されます。1 に設定すると常に表示されます。 ポリゴンの長さが約 4950 ポイントを超えると、グラフィックスで表示されません。
GetScore(ブロブ, [インデックス1], [インデックス2]) | ブロブの得点値 (0 ～ 100) を返します。
GetSpread(ブロブ, [インデックス]) | ブロブの拡散の値を返します。
GetThresh(ブロブ) | ブロブの、手動設定の 2 値化しきい値、または最適化された値 (-1 の場合、自動で指定) のいずれかを返します。
GetWidth(ブロブ, [インデックス]) | インデックスで指定されたブロブの幅を返します。
GetX(ブロブ, [インデックス1], [インデックス2]) | X 座標を返します。
GetY(ブロブ, [インデックス1], [インデックス2]) | Y 座標を返します。