【HALCON】copy_metrology_object 関数について - メトロロジーオブジェクトのコピー処理

HALCONのcopy_metrology_object関数は、既存のメトロロジーモデル内のメトロロジーオブジェクトを別のモデルにコピーするためのツールです。この関数を使用することで、計測の設定やパラメータを保持したまま、元のモデルとは異なるモデルを作成し、テストや実験に使用できます。新しいメトロロジーモデルには、コピーされたオブジェクトが元の順序で保持されます。

copy_metrology_object関数の概要

copy_metrology_object関数は、入力されたメトロロジーモデルから選択されたオブジェクトをコピーし、新しいメトロロジーモデルに複製します。元のオブジェクトの全てのパラメータがコピーされ、異なる設定での計測が行えます。例えば、計測プロジェクトの異なるバージョンを作成したり、パラメータを変えて検証を行う際に便利です。

関数のシグネチャ

void copy_metrology_object(HTuple : MetrologyHandle, HTuple : NewMetrologyHandle, HTuple : Index);

• MetrologyHandle
  コピー元のメトロロジーモデルのハンドル。
• NewMetrologyHandle
  コピー先の新しいメトロロジーモデルのハンドル。
• Index
  コピーするメトロロジーオブジェクトのインデックス。

使用例

以下のコードでは、HALCONのcopy_metrology_object関数を使用して、メトロロジーモデル内のオブジェクトを新しいモデルにコピーしています。

HTuple MetrologyHandle, NewMetrologyHandle;

// メトロロジーモデルの読み込み
read_metrology_model("example_model.mdl", &MetrologyHandle);

// 特定のメトロロジーオブジェクトをコピー
copy_metrology_object(MetrologyHandle, &NewMetrologyHandle, 0);

// 新しいモデルを使用した計測処理
apply_metrology_model(NewMetrologyHandle, Image);

このコードでは、メトロロジーモデル内の特定のオブジェクト（Index = 0）をコピーし、新しいモデルに対して計測処理を行っています。

応用例

copy_metrology_object関数は、以下のような応用で使用されています。

• 計測条件の変更
  元のメトロロジーモデルを保持しながら、新しい計測条件で実験を行うために、オブジェクトをコピーします。

• モデルのバージョン管理
  計測プロジェクトの異なるバージョンを管理し、それぞれでオブジェクトを再利用する際に便利です。

• 設定の比較検証
  複数の計測設定での比較検証を行い、最適な計測条件を見つけるために、オブジェクトを複製して異なる設定を試すことができます。

まとめ

HALCONのcopy_metrology_object関数は、メトロロジーモデル内のオブジェクトを簡単に複製して、新しいモデルに転用するための便利なツールです。この機能により、計測プロジェクトの管理や異なる設定でのテストが効率的に行えるようになります。