# ExtractHistogram

画像領域からヒストグラム配列を抽出します。

## ExtractHistogram の概要

ヒストグラム関数は、対象領域のピクセル値の 1 次元表現を返します。ヒストグラムは整数の配列で表され、階層と呼ばれる配列の各要素は、領域内のピクセル数を格納します。ここで、階層 n の値は、ピクセル値 n の領域内のピクセル数です。配列内のすべての階層の合計数は、領域内のピクセル数と等しくなります。

## ExtractHistogram の入力

パラメータ | 説明
画像 | このパラメータは、画像データ構造体を含むスプレッドシートセルのセル参照を使用する必要があります。デフォルトでは、このパラメータは、 関数によって返された画像データ構造体を含むセル A0 を参照しています。また、このパラメータは、ビジョンツールの画像フィルタ関数によって返された、その他の画像データ構造体も参照できます。
フィクスチャ | Fixture入力、またはビジョンツール関数の画像座標系の出力に関連する対象領域 (ROI) を定義します。フィクスチャに関連する ROI を設定すると、フィクスチャが回転または移動した場合に、フィクスチャに対応して ROI を確実に回転または移動できます。 デフォルト設定は画像の左上隅で、(0, 0, 0) になります。
X | 画像座標での X オフセット。
Y | 画像座標での Y オフセット。
角度 | 画像座標系での画像の X 軸からの回転 (時計回り +/-360 度)。
領域 | これは対象領域 (ROI) とも呼ばれ、解析の対象となる画像の領域を表します。[領域] パラメータをダブルクリックすると、変換と回転が可能な対話型グラフィックスモードを作成できます。このパラメータを選択して、プロパティシートの [ジョブの編集] ツールバーにある [領域の最大化] ボタンを押すと、画像全体が対象になるように領域が自動的に拡張されます。
X | フィクスチャ座標での原点の X オフセット
Y | フィクスチャ座標での原点の Y オフセット
幅 | 領域の X 軸に沿った寸法
高さ | 領域の Y 軸に沿った寸法
角度 | フィクスチャ座標での角度
カーブ | 領域の X 軸と反対側の境界線との間の角度変位
注: ピクセルがヒストグラムに計算されるようにするには、ピクセルが画像領域の範囲内に完全に含まれている必要があります。部分的に含まれているピクセルは計算されません。 [フィクスチャ] および [領域] パラメータは、画像の範囲内で定義されている必要があります。画像の範囲内で定義されていない場合、この関数は #ERR を返します。
外部定義領域 | このパラメータは、Annulus、Circle、Region、 EditAnnulus、EditCircle、EditCompositeRegion、EditPolygon、EditRegion へのセル参照を使用します。このパラメータを使用すると、関数は [領域] と [フィクスチャ] の設定を無視し、参照先領域に指定された画像領域を検査します。EditCompositeRegion 関数コントロールを参照している場合は、検査領域がさまざまな形状の混合となることがあります。合成領域内の各形状は、検査領域に対して加算または減算 (マスキング) されるように割り当てることができます。 注: このパラメータが外部定義領域の参照として設定されている場合に、この関数の内部領域を使用するには、セル参照に値 0 を入力し、このパラメータを手動で 0 に設定する必要があります。それ以外の場合、この関数は引き続き外部定義領域を参照します。
表示 | 画像上の ExtractHistogram グラフィックスオーバレイの表示モードを指定します。
0 = 非表示 (デフォルト) | ExtractHistogram 関数を含んでいるセルがスプレッドシート内のアクティブセルである場合を除き、すべてのグラフィックスが表示されません。
2 = 入力のグラフィックスのみ | 入力画像領域が常に表示されます。
3 = すべて表示: 入力とチャート | 入力画像領域とヒストグラムチャートは両方とも常に表示されます。 注: ヒストグラムチャートは、ドッキング可能なウィンドウです。詳細については、「スプレッドシートエディタ – チャート」のトピックを参照してください。

## ExtractHistogram の出力

戻り値 | グレースケール度数分布を含んでいるヒストグラムデータ構造体。入力パラメータが無効であれば #ERR を返します。
結果 | ExtractHistogram 関数を初めてセルに挿入すると、スプレッドシート内に結果テーブルが作成されます。 次のヒストグラムデータアクセス関数がスプレッドシートに自動挿入され、結果テーブルが作成されます。
ラベル | 関数 | 説明
しきい値 | HistThresh(ヒストグラム, 0, 255) | 2 値化しきい値。
コントラスト | HistContrast(ヒストグラム, 0, 255) | グレースケール画像のコントラスト。
暗ピクセル | HistCount(ヒストグラム, 0, しきい値-1) | しきい値を下回るピクセルの数。
明ピクセル | HistCount(ヒストグラム, しきい値, 255) | しきい値を上回るピクセルの数。
平均 | HistMean(ヒストグラム, 0, 255) | グレースケールの平均値。