# ExtractCalibrationPoints

ExtractCalibrationPoints 関数は、チェッカボードキャリブレーショングリッドパターンの画像からキャリブレーションポイントを抽出します。キャリブレーションポイントは、他のキャリブレーションツールで使用することができます。

## ExtractCalibrationPoints の概要

キャリブレーション画像である、フィデューシャルと既知のスケールを持つチェッカーボードグリッドは、ExtractCalibrationPoints 関数を学習するのに使用されます。解析中に、グリッドセルの交差のピクセル位置を検出し、それらをグリッドパターンのモデルにマッピングし直します。この関数は、グリッド内で検出された点の数とともに CalibPoints データ構造体を返します。一連のキャリブレーションポイントは、後で CalibratePoints などの他のキャリブレーションツールで使用し、歪みを補正したり、画像座標をワールド座標にマッピングしたり (またはその逆) することができます。

注 : フィデューシャルマークが付いたチェッカーボードキャリブレーショングリッドを使用します。ドットのグリッドまたはフィデューシャルのないグリッドを使用したキャリブレーションは、現時点ではサポートされていません。

## ExtractCalibrationPoints の入力

パラメータ | 説明
--- | ---
画像 | この引数は、有効な 画像 データ構造体を含んでいるスプレッドシートのセルを参照している必要があります。デフォルトで参照されるセルは $A$0 で、このセルにはによって返される Image データ構造体が含まれています。
フィクスチャ | Fixture入力、またはビジョンツール関数の画像座標系の出力に関連する対象領域 (ROI) を定義します。フィクスチャに関連する ROI を設定すると、フィクスチャが回転または移動した場合に、フィクスチャに対応して ROI を確実に回転または移動できます。
X | 画像座標での X オフセット。
Y | 画像座標での Y オフセット。
領域 | これは対象領域 (ROI) とも呼ばれ、解析の対象となる画像の領域を表します。[領域] パラメータをダブルクリックすると、変換と回転が可能な対話型グラフィックスモードを作成できます。このパラメータを選択して、プロパティシートの [ジョブの編集] ツールバーにある [領域の最大化] ボタンを押すと、画像全体が対象になるように領域が自動的に拡張されます。
X | フィクスチャ座標での原点の X オフセット
Y | フィクスチャ座標での原点の Y オフセット
幅 | 領域の X 軸に沿った寸法。
高さ | 領域の Y 軸に沿った寸法。
イベントの抽出 | 押すと、画像からキャリブレーションポイントを抽出します。
グリッド間隔単位 | キャリブレーショングリッドパターンの間隔に使用する測定単位を指定します。
ミクロン = 0 | "µm"
ミリメートル = 1 (デフォルト) | "mm"
センチメートル = 2 | "cm"
インチ = 3 | "in"
Xグリッド間隔 | X 軸上のキャリブレーショングリッドパターン間隔の実際の測定値。
Yグリッド間隔 | X 軸上のキャリブレーショングリッドパターン間隔の実際の測定値。
角度範囲 | 選択すると、[許容値] パラメータを有効にし、グリッドの検索に使用する角度範囲を制限できます。(デフォルト = 0、オフ) ヒント : 角度範囲の制限によって、グリッドとカメラの間の相対方向が分かっている場合にポイント抽出を高速化できる場合があります。
許容値 | グリッドの検索に使用する開始および停止角度の範囲。
開始角度 | グリッド水平軸とカメラ水平軸の間の最小可能角度。 (最小 = -180、最大 = 180、デフォルト = -180)
終了角度 | グリッド水平軸とカメラ水平軸の間の最大可能角度。 (最小 = -180、最大 = 180、デフォルト = +180)
注 : デフォルトでは、角度範囲は制限されていません。[許容値] パラメータ内で設定された角度の開始範囲と終了範囲の制限を有効にするには、[角度範囲] チェックボックスをオンにする必要があります。
タイムアウト | ExtractCalibrationPoints 関数を実行する時間をミリ秒単位で指定します。タイムアウトを超えると、関数の実行が停止します。 (最小 = 0、最大 = 9999999、デフォルト = 120000) 注 : [タイムアウト] は、タイムアウトを超えたときに実行時間の長いプロセスを停止するためのフェイルセーフとして使用します。実行時間は指定された時間よりも 2、3 秒長くなることがあるため、きっかり [タイムアウト] の時間になるとは限りません。
表示 | 画像上の ExtractCalibrationPoints グラフィックスオーバレイの表示モードを指定します。
0 = 非表示 (デフォルト) | ExtractCalibrationPoints 関数を含んでいるセルがスプレッドシート内でハイライトされている場合を除き、すべてのグラフィックスが表示されません。
1 = 結果のグラフィックスのみ | 抽出された点の位置を入力画像に重ねて表示します。
2 = 入力と結果のグラフィックス | 抽出された点の位置とサーチ領域を表示します。

## ExtractCalibrationPoints の出力

戻り値 | CalibPoints データ構造体。入力パラメータが無効であれば #ERR を返します。 次の キャリブレーションVision Data Access functions がスプレッドシートに自動挿入され、結果テーブルが作成されます。
ラベル | 関数 | 説明
ポイント | GetNFound() | キャリブレーショングリッド画像で検出された点の数を返します。