ピクセルサイズを決定

このツールでは、関心領域 (ROI) で画像内の既知の長さ (画像内の特定単位のスケール) を定義でき、したがってカメラまでの一定距離のピクセルサイズが決まります。この ROI は、それを決定した前のツールから接続できます。あるいは、ROI ボタンにより、このツールで直接作成できます。その後、パラメーターコネクター「ワールドにおける距離」および「単位」に既知の長さを入力する必要があります。キャリブレーション後、座標系の中心、つまり [0,0] の位置が画像の中心となります。これは右手座標系であり、x 軸を反時計方向に 90°回転させると y 軸に重なります。結果は、その後の処理用のキャリブレーションデータとして使用できます。

パラメーター

基本パラメーター

画像:

このパラメーターは、スケールを定義する画像を表します。

ワールドにおける距離:

このパラメーターは「基準ROI」で示される指定基準距離に対する世界における対応する距離を定義します。距離の単位はパラメーター「単位」で指定します。

単位:

このパラメーターは、キャリブレーション情報の「単位」を設定します。このパラメーターのデフォルト設定値は「mm」です。対応するコネクターでその値を変更できます。

値	説明
nm	キャリブレーション情報を nm 単位で指定します。
μm	キャリブレーション情報を μm 単位で指定します。
mm	キャリブレーション情報を mm 単位で指定します。
cm	キャリブレーション情報を cm 単位で指定します。
m	キャリブレーション情報を m 単位で指定します。
点	キャリブレーション情報を 点 単位で指定します。
パイカ	キャリブレーション情報を パイカ 単位で指定します。
インチ	キャリブレーション情報を インチ 単位で指定します。
フィート	キャリブレーション情報を フィート 単位で指定します。
ヤード	キャリブレーション情報を ヤード 単位で指定します。

追加パラメーター

基準ROI:

このパラメーターには、基準距離 (特定の単位のスケールと対応するピクセルサイズの定義に使用できる既知の長さの距離) をグラフィカルに表現したデータがあります。このパラメーターは、ROI として示されます。

デフォルトで、「基準ROI」は定義されません。キャリブレーションに「基準ROI」を使用する場合、「基準ROI」がこのツールに送信されるよう、適切な前のツールの ROI 結果にこのパラメーターを接続するか、使用可能な ROI ボタンで新しい「基準ROI」を画像に描画します。「基準ROI」を定義したら、パラメーター「ワールドにおける距離」と「単位」に既知の長さを入力してください。

このツールがサポートしているのは、単独 ROI の使用のみです。「基準ROI」に複数の ROI がある場合、処理には、前回作成した ROI のみが適用されます。「基準ROI」を円形 ROI で表すと、円の直径が基準距離として適用されます。(近軸) 長方形を「基準ROI」として使用すると、その長軸方向の主要長さが基準距離として適用されます。

結果

基本結果

キャリブレーションデータ:

この結果には、レンズの歪みの補正と画像平面に対するカメラの位置の補正に必要な決定されたキャリブレーションデータが含まれます。決定された「ピクセルサイズ」のために決定されます。

ピクセルサイズ:

この結果には、 指定された「ワールドにおける距離」と「基準ROI」の決定された「ピクセルサイズ」が含まれます。結果は実数として返ります。

ツール状態:

「ツール状態」はツール状態の情報を返します。したがって、エラー処理に使うことができます。さまざまなツールの状態結果の詳細については、 ツール状態 結果 のトピックを参照してください。

追加結果

X 軸:

この結果は、確定した x 軸を返します。結果は輪郭として返り、赤色で表示されます。

Y 軸:

この結果は、決定した y -軸を返します。結果は輪郭として返り、緑色で表示されます。

処理時間:

この結果は、ツールの直近の実行の持続時間をミリ秒単位で返します。結果は、追加結果として提供されます。したがって、デフォルトでは非表示になっていますが、ツール結果の横にある ボタンを使用して表示できます。詳細については、ツールリファレンス概要の処理時間の節を参照してください。

アプリケーションの例

このツール、以下の MERLIC Vision App 例で使用します:

• measure_distance_segment_circle_calibrated.mvapp
• measure_distance_to_center_led.mvapp