ExtractHistogram
画像領域からヒストグラム配列を抽出します。
ExtractHistogram概要
Histogram 関数は、対象領域内のピクセル値の 1 次元表現を返します。ヒストグラムは整数の配列によって表され、そこで配列の各要素はビンと呼ばれ、領域内のピクセル数のカウントを格納します。そこではビン n 内の値はピクセル値 n の領域内のピクセル数です。配列内のすべてのビンのカウントは、領域内のピクセル数と同じです。
ExtractHistogramの入力パラメータ
Syntax:ExtractHistogram(画像,フィクスチャ.行,フィクスチャ.列,フィクスチャ.角度,領域.X,領域.Y,領域.高さ,領域.幅,領域.角度,領域.カーブ,外部領域,表示)
| 画像 | このパラメータは、スプレッドシートで画像データ構造体を含むセルを参照する必要があります。デフォルトでは、このパラメータは、AcquireImage 画像データ構造体を含むセル A0 を参照しています。また、このパラメータは、ビジョンツールのグラフィックス関数によって返された、そのほかの画像データ構造体も参照できます。 | ||||||||||||
|
|
フィクスチャ入力、またはビジョンツール関数の画像座標系の出力に関連する対象領域 (ROI) を定義します。フィクスチャに関連する ROI を設定すると、フィクスチャが回転または移動した場合に、フィクスチャに対応して ROI を確実に回転または移動できます。 デフォルト設定は画像の左上隅で、(0, 0, 0) になります。
|
||||||||||||
| 領域 |
これは対象領域 (ROI) とも呼ばれ、解析の対象となる画像の領域を表します。変換および回転可能な矩形の画像領域を作成します。このパラメータを選択して、プロパティシートのツールバーにある [領域の最大化] ボタンを押すと、画像全体が対象になるように領域が自動的に拡張されます。
|
||||||||||||
|
注 :
|
|||||||||||||
| 外部領域 |
このパラメータは、Annulus、Circle、Region、EditAnnulus、EditCircle、EditCompositeRegion、EditPolygon、または EditRegion の各関数を含むスプレッドシートセルを参照できます。このパラメータを使用すると、関数は [領域] と [フィクスチャ] の設定を無視し、参照先領域で指定された画像領域を検査します。EditCompositeRegion 関数コントロールを参照している場合は、検査領域がさまざまな形状の混合となることがあります。合成領域内の各形状は、検査領域に対して加算または減算 (マスキング) されるように割り当てることができます。 注 : このパラメータが外部定義領域の参照として設定されている場合に、この関数の内部領域を使用するには、セル参照に値 0 を入力し、このパラメータを手動で 0 に設定する必要があります。それ以外の場合、この関数は引き続き外部定義領域を参照します。
|
||||||||||||
| 表示 |
画像上の ExtractHistogram グラフィックスオーバレイの表示モードを指定します。
|
ExtractHistogramの出力
| 戻り値 | グレースケール度数分布を含んでいるヒストデータ構造体。入力パラメータが無効であれば #ERR を返します。 |
| 結果 | ExtractHistogram 関数を初めてセルに挿入すると、スプレッドシート内に結果テーブルが自動的に作成されます。 |
ExtractHistogramデータアクセス関数
次のデータアクセス関数がスプレッドシートに自動挿入され、結果テーブルが作成されます。
|
しきい値 |
HistThresh(Hist, 0, 255) |
2 値化しきい値 |
|
コントラスト |
HistContrast(Hist, 0, 255) |
グレースケール画像のコントラスト |
|
暗ピクセル |
HistCount(Hist, 0, Thresh-1) |
しきい値を下回るピクセル数 |
|
明ピクセル |
HistCount(Hist, Thresh, 255) |
しきい値を上回るピクセル数 |
|
平均 |
HistMean(Hist, 0, 255) |
平均グレースケール値 |