ラインを計測

このツールを使用して、最長のライン線分を計測します。

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

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

あるいは、関心領域 (ROI) で計測することもできます。画像に ROI を描画します。現在のパラメーター設定を満たしたライン線分が ROI にある場合、そのライン線分は自動的に決まり、測定が行われます。ROI がない場合、ツールは、画像が接続され次第、画像全体で最長のライン線分を検索します。

パラメーター

基本パラメーター

画像:

このパラメーターは、最長ライン線分を測定する入力画像を表します。

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

ライン幅:

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

ラインコントラスト:

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

ラインプロパティ:

このパラメーターは、ライン線分の推移プロパティを定義します。このパラメーターのデフォルト設定値は「暗い」です。測定用にラインが選択されると、「ラインプロパティ」が直ちに設定され、選択対象に追加された各ラインについて自動的に調整されます。

値	説明
明るい	暗い背景に対して明るいラインです。つまり、ラインのグレイ値は背景のグレイ値よりも大きくなります。 この値が設定されている場合、この推移プロパティを持つラインのみが計測されます。その他のラインは計測から除外されます。
暗い	明るい背景に対して暗いラインです。つまり、ラインのグレイ値は背景のグレイ値よりも小さくなります。 この値が設定されている場合、このプロパティを持つラインのみが計測されます。その他のラインは計測から除外されます。

追加パラメーター

ROI:

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

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

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

アライメントデータ:

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

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

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

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

測定に失敗:

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

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

処理領域:

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

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

結果

基本結果

線分:

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

線分長:

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

線分方向:

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

ツール状態:

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

追加結果

線分輪郭:

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

処理時間:

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