# ComputeImageSharpness

ComputeImageSharpness 関数は、In-Sight カメラのレンズのフォーカスを調整する反復プロセスの一部として、入力画像の相対的なフォーカスの基準を計算します。

## ComputeImageSharpness の概要

画像シャープネス得点と呼ばれるこの基準は、「シーン」(その画像でキャプチャされた対象物とその背景) 内で認識可能な最小の特徴が画像または対象領域 (ROI) に含まれる度合いを示します。

操作は簡単で、画像を取り込むと、ComputeImageSharpness ツールが画像シャープネス得点を取得します。その後、レンズのフォーカスが調整され、シーン内には変更が加えられずに、新しい画像が取り込まれて得点が付けられます。得点が高いほど、フォーカスがシャープであることを意味します。フォーカスに満足できるまでこのプロセスを繰り返します。

注: 画像シャープネス得点を 1 回取得するだけでは、画像の絶対的なシャープネスに関する有用な情報は得られません。まったく同じシーンの画像シャープネス得点を複数回取得して比較する必要があります。シーンは同一でなければなりません。

## ComputeImageSharpness の入力

パラメータ | 説明
画像 | このパラメータは、画像データ構造体を含むスプレッドシートセルのセル参照を使用する必要があります。デフォルトでは、このパラメータは、 関数によって返された画像データ構造体を含むセル A0 を参照しています。また、このパラメータは、ビジョンツールの画像フィルタ関数によって返された、その他の画像データ構造体も参照できます。
フィクスチャ | Fixture入力、またはビジョンツール関数の画像座標系の出力に関連する対象領域 (ROI) を定義します。フィクスチャに関連する ROI を設定すると、フィクスチャが回転または移動した場合に、フィクスチャに対応して ROI を確実に回転または移動できます。 デフォルト設定は画像の左上隅で、(0, 0, 0) になります。
X | 画像座標での X オフセット。
Y | 画像座標での Y オフセット。
角度 | 画像座標系での画像の X 軸からの回転 (時計回り +/-360 度)。
領域 | これは対象領域 (ROI) とも呼ばれ、解析の対象となる画像の領域を表します。[領域] パラメータをダブルクリックすると、変換と回転が可能な対話型グラフィックスモードを作成できます。このパラメータを選択して、プロパティシートの [ジョブの編集] ツールバーにある [領域の最大化] ボタンを押すと、画像全体が対象になるように領域が自動的に拡張されます。
X | フィクスチャ座標での原点の X オフセット
Y | フィクスチャ座標での原点の Y オフセット
幅 | 領域の X 軸に沿った寸法
高さ | 領域の Y 軸に沿った寸法
角度 | フィクスチャ座標での角度
カーブ | 辺の間の角度、時計回りに +/- 360 度
操作 | 勾配エネルギー:画像または ROI のローカルグレーレベル勾配のエネルギーに基づいて、画像シャープネスを計算します。ローカルグレーレベル勾配は、指定した領域のグレースケール値の変化率を表します。グレースケールが急激に変化すると、グレーレベル勾配が大きくなり、画像シャープネス得点が高くなります。
スムーズネス | ROI 内に存在する高周波ノイズを除去する、画像平滑化操作を指定します。次の 3 つの設定があります。
0 = なし (デフォルト) | 平滑化は実行されず、処理時間は最速となります。
1 = 平滑化レベル 1 | ROI にある程度の平滑化が適用されます。ROI 内の超高周波ノイズが除去されます。
2 = 平滑化レベル 2 | ROI に強い平滑化が適用されます。ROI 内の高周波ノイズと超高周波ノイズが除去されます。
表示 | 画像の上に表示するグラフィックスオーバーレイを指定します。
0 = 非表示 (デフォルト) | ComputeImageSharpness 関数を含んでいるセルがスプレッドシート内でハイライトされている場合を除き、使用可能なグラフィックス項目は表示されません。
1 = 入力のグラフィックスのみ | 入力画像領域と関連付けられているグラフィックス項目が常に表示されます。

## ComputeImageSharpness の出力

戻り値 | 浮動小数点値で表された画像シャープネス得点。入力パラメータが無効の場合は #ERR が返されます。