エッジを計測

このツールを使用して、エッジを計測します。

これらは、ツール 円から線分への計測、線分から点への計測 および 線分から線分への計測 で使用可能な線分 ROI として返されます。このツールは、仮想水平ラインを基準にした「線分長」および「線分方向」も返します。このツールは、画像に完全またはスムーズなエッジが含まれていない場合でも線分 ROI を返すことができます。

このツールには easyTouch および easyTouch+ を利用することができます。 したがって、画像では、計測する最長エッジ線分を対話的に選択できます。最長線分を計測するエッジにマウスを合わせます。MERLIC には、提案される最長エッジ線分のプレビューが表示されます。プレビューした線分を計測するには、エッジをクリックして選択結果を確定します。パラメーターは、選択した線分に合わせて自動的に調整されます。ただし、対応するコネクターでは、手動でも調整できます。

あるいは、関心領域 (ROI) で計測することもできます。 画像に ROI を描画します。現在のパラメーター設定を満たしたエッジ線分が ROI にある場合、エッジ線分は自動的に決まり、計測が行われます。ROI がない場合、ツールは、画像が接続され次第、画像全体で最長のエッジ線分を検索します。ROI は、開始点および終了点、つまりエッジの長さも決定します。曲線上のエッジを検出するには、小さな ROI を使用します。

パラメーター

基本パラメーター

画像:

このパラメーターは、最長エッジ線分を計測する入力画像を表します。前のツールの結果として画像が利用できる場合、自動的に接続され、入力画像になります。

色画像をこのツールの入力として使用すると、最初のチャンネル (赤いチャンネル) のみが処理の対象になります。

エッジコントラスト:

このパラメーターは、背景を基準にした最長エッジ線分のコントラストを定義します。これはグレイ値で定義され、デフォルト設定値は 20 です。計測用にエッジが選択されると、このエッジの「エッジコントラスト」が直ちに設定され、使用されます。easyTouch+ でさらにエッジ線分を追加すると、選択対象に追加された各エッジ線分に対して「エッジコントラスト」が自動的に調整されます。しかし、対応するコネクターで値を手動で変更することもできます。

エッジ幅:

このパラメーターは、最長エッジ線分の幅を設定します。このパラメータはピクセル単位で定義され、デフォルト設定値は 2 ピクセルです。計測用にエッジが選択されると、このエッジの「エッジ幅」が直ちに設定され、使用されます。easyTouch+ でさらにエッジ線分を追加すると、選択対象に追加された各線分に対して「エッジ幅」が自動的に調整されます。しかし、対応するコネクターで値を手動で変更することもできます。

追加パラメーター

ROI:

このパラメーターは、処理用の関心領域 (ROI) を定義します。ROI と「処理領域」の結合部分の外側にある画像部分は処理の対象外になります。また、そのどちらかが空の場合、他の一方の内部にある画像部分は処理されます。どちらも空の場合、画像全体が処理されます。 ただし、easyTouch でパラメーターを確定すると、計測には「処理領域」のみが適用されます。

デフォルトで、「ROI」は空 ROI として定義されます。空でない ROI を処理に使用する場合は、前のツールの適切な ROI 結果にパラメーターを接続するか、使用可能な ROI ボタンで新しい ROI を画像に描画します。

定義済みの「ROI」と「処理領域」の結合では、現在のパラメーター設定を満たすエッジ線分がないかチェックが行われます。すなわち、「エッジ推移」を「暗から明へ」に設定すると、このツールは暗から明に変化するエッジ線分がないか ROI 方向に検索を行います。適切なエッジ線分が見つかると、それらは計測に使用されます。

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

このパラメータでは、レンズの歪みの補正と画像平面を基準にしたカメラの位置の補正に必要なキャリブレーションデータを定義します。デフォルトで、キャリブレーションデータは定義されません。キャリブレーションデータを使用するには、キャリブレーションデータがこのツールに送信されるよう、このパラメータを カメラキャリブレーション など、前のツールの適切な結果に接続します。結果は直ちに画像に適用されます。

このツールで「キャリブレーションデータ」を使用する場合、ピクセル値を表すすべての結果は、対応するワールド座標に自動的に変換されます。

アライメントデータ:

このパラメータは、ROI のアライメントに使用するアライメントデータを表します。デフォルトでは、アライメントデータが接続されていないため、効果はありません。特定のアライメントデータを使用するには、マッチングによるアライメント、直線境界でアライメントを決定、画像をアライメント、あるいは 画像を回転 など、パラメータを適切な前のツールの結果に接続します。

測定に失敗:

このパラメーターでは、計測を実行できない場合に「線分長」および「線分方向」の結果で返す値を指定します。パラメーターの設定値はデフォルトで「無視」です。このパラメータは対応するコネクターで以下の値に設定できます。

値	説明
無視	計測を実行できない場合、値を返しません。
-1	計測を実行できない場合、-1 を返します。 この値は、返す任意の数字や文字列を、コネクターの入力フィールドに直接置き換えることができます。
*	計測を実行できない場合、* を返します。 この値は、返す任意の数字や文字列を、コネクターの入力フィールドに直接置き換えることができます。

処理領域:

このパラメーターは、処理する領域を定義します。ROI と「処理領域」の結合部分の外側にある画像部分は処理の対象外になります。また、そのどちらかが空の場合、他の一方の内部にある画像部分は処理されます。どちらも空の場合、画像全体が処理されます。

デフォルトで、「処理領域」は空の領域として定義されます。「処理領域」を指定するには、領域が現在のツールに渡されるよう、パラメーターを前のツールの適切な領域結果に接続します。

easyTouch でパラメータを確定する場合、計測には「処理領域」のみが適用されます。「処理領域」を未定義の場合、画像全体を計測に使用します。

結果

基本結果

線分:

この結果では、計測した最長エッジ線分のグラフィック表示が返ります。結果は線分 ROI として返ります.1 本以上のエッジ線分を計測した場合、「線分」にはすべての最長エッジ線分 ROI が含まれます。

線分長:

この結果では、計測した最長エッジ線分の長さが返ります。結果はピクセル単位の実数で返ります。「キャリブレーションデータ」を使用すると、ワールド座標で長さが返ります。1 本以上の最長エッジ線分を計測した場合、対応する長さがタプルで返ります。

線分方向:

この結果では、計測した最長エッジ線分と、線分の中心点を通る仮想的な水平ラインの間の角度が返ります。度数単位の実数が返ります線分の中心点は、回転の中心です。線分の終点が水平軸よりも上にある場合、水平ラインをエッジに向かって反時計方向に回転させた結果の角度 (符号は正) となります。終点が水平軸よりも下にある場合、水平ラインをエッジに向かって時計方向に回転させた結果の角度 (符号は負) となります。

ツール状態:

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

追加結果

エッジ輪郭:

この結果では、計測に使用したエッジ線分の輪郭が返ります。

処理時間:

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

アプリケーションの例

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

• measure_distance_segment_circle_calibrated.mvapp