# キャリブレーションされた画像の操作

ViDi ツールはピクセル値で動作し、ピクセル値で結果を返します。VisionPro ツールは、事前に定義された座標空間または任意の座標空間で動作し、画像の選択された座標空間で結果を返します。そのため、PatMax でキャリブレーションされた画像をフィクスチャするときは、PatMax ツールの結果がピクセルであること、および ViDi ツールの結果がキャリブレーションされた座標空間であることを確認する必要があります。

## PMAlign ツールを使用して解析 (赤) ツール用にキャリブレーションされた画像をフィクスチャする

PMAlign ツールによって生成されたポーズを解析 (赤) ツールで正確に使用するには、そのポーズがピクセルである必要があります。PMAlign ツールは、パターン空間内のポイントを、選択された空間内のポイントにマッピングするポーズを返します。ピクセル空間が選択された (またはルート空間が選択され、ルート空間 = ピクセル空間である) 場合は、ポーズは既にピクセルになっています。

ポーズがピクセルではない場合があります。

- 入力画像が VisionPro ツールによってサブサンプリングされた。
  - 選択された空間: ルート ("@")
  - ルート空間 != ピクセル空間
- 入力画像がキャリブレーションされた。
  - 選択された空間: キャリブレーションされた空間

幸い、選択された空間がキャリブレーションされた空間である画像は、標準的な例で説明されているのと同じ手順で処理されます。

ヒント :

###### API の例

    ICogTransform2D fromSelectedToPixelTransform = cogImage.GetTransform("#", ".");

    CogTransform2DLinear fromPatternToPixelLinearTransform = fromSelectedToPixelTransform.ComposeBase(<Pose>).LinearTransform(0, 0);

変換 "fromPatternToPixelLinearTransform" は、画像がキャリブレーションされている場合でも、デフォルトのビューをフィクスチャするために AddView に渡すことができます。

これらの点に注意しないと、PMAlign ツールによって、キャリブレーションされた空間でのみ有効なポーズが生成されるため、解析 (赤) ツールでビューの位置が大幅にずれることになります。ただし、PMAlign ツールのポーズがピクセル空間に変換された後に、解析 (赤) ツールで画像とそのポーズを使用する手順は変わりません。

## キャリブレーションされた空間での ViDi マーキングの操作

ViDi マーキングは、結果をピクセル座標で示します。具体的には、結果が検出されたビューの原点を基準にしたピクセルです。

1 つのビューと 1 つの (正方形の) 欠陥が含まれたマーキングを返す解析 (赤) ツールについて考えてみます。

- RedMarking
  - RedView
    - Region
      - (0, 0)
      - (1, 0)
      - (1, 1)
      - (0, 1)

画像がキャリブレーションされたかどうかにかかわらず、この Region の領域は 1 つのピクセルです。このラッパーを使用すると、マーキングを、キャリブレーションされた結果が含まれている新しい IMarking の実装に変換できます。変換処理には、マーキングおよびキャリブレーション変換 (CogTransform2DLinear として) が必要です。

上記の例では、1 つのピクセル長が 5 インチにキャリブレーションされます。キャリブレーションされたバージョンは次のとおりです。

- CalibratedRedMarking
  - CalibratedRedView
    - CalibratedRegion
      - (0, 0)
      - (5, 0)
      - (5, 5)
      - (0, 5)

これで、Region.Area プロパティは、ピクセルではなくキャリブレーションされた空間で 25 を返します。これにより、キャリブレーションされた結果とキャリブレーションされていない結果の両方に同じインタフェースを使用できます。

注 :

- キャリブレーション変換は、ICogImage.GetTransform("#", "<CalibrationSpaceName>") を使用してキャリブレーションされた画像から取得できます。

  これは、キャリブレーションされた空間からピクセル空間への変換を返します。

- さまざまな ViDi マーキングのキャリブレーションされた実装は、ViDi2.VisionPro.Calibration 名前空間にあります。

## 要約

キャリブレーションされた画像で PatMax および ViDi を使用する場合、PatMax ツールはポーズをピクセルで返す必要があります。キャリブレーションされた空間で ViDi 結果を解釈するには、(ピクセル) マーキングおよびキャリブレーション変換から CalibratedMarking を作成する必要があります。