# Stitch

Stitch は、複数の入力画像の対象領域 (ROI) をつなぎ合わせて 1 つの出力画像を生成します。この関数を使用すると、多面的な対象物の領域全体を取り込むことができます。例えば、Stitch 関数を使用して、回転する円筒形の対象物に付いているラベルを検査することができます。

## Stitch の入力

パラメータ | 説明
画像 | このパラメータは、画像 データ構造体を含むスプレッドシートセルのセル参照を使用する必要があります。デフォルトでは、このパラメータは、 関数によって返された Image データ構造体を含むセル A0 を参照しています。また、このパラメータは、ビジョンツールの画像フィルタ関数によって返された、その他の Image データ構造体も参照できます。
イベント | このパラメータは、例えば、次のいずれかのタイムスタンプが含まれているイベントの参照である必要があります。 イベント 関数を含むセル。 Button 関数を含むセル。
フィクスチャ | Fixture入力、またはビジョンツール関数の画像座標系の出力に関連する対象領域 (ROI) を定義します。フィクスチャに関連する ROI を設定すると、フィクスチャが回転または移動した場合に、フィクスチャに対応して ROI を確実に回転または移動できます。 デフォルト設定は画像の左上隅で、(0, 0, 0) になります。
X | 画像座標での X オフセット。
Y | 画像座標での Y オフセット。
角度 | 画像座標系での画像の X 軸からの回転 (時計回り +/-360 度)。
領域 | これは対象領域 (ROI) とも呼ばれ、解析の対象となる画像の領域を表します。[領域] パラメータをダブルクリックすると、変換と回転が可能な対話型グラフィックスモードを作成できます。このパラメータを選択して、プロパティシートの [ジョブの編集] ツールバーにある [領域の最大化] ボタンを押すと、画像全体が対象になるように領域が自動的に拡張されます。
X | フィクスチャ座標での原点の X オフセット
Y | フィクスチャ座標での原点の Y オフセット
幅 | 領域の X 軸に沿った寸法。
高さ | 領域の Y 軸に沿った寸法。
角度 | フィクスチャ座標での角度
ピクセルシフト X | 連続する画像間の水平方向のシフトをピクセル単位で指定します。
ピクセルシフト Y | 連続する画像間の垂直方向のシフトをピクセル単位で指定します。
出力画像あたりのスティッチ数 | 出力画像を構成する画像の数を指定します。
リセット | 入力画像をクリアします。 注 : 連続スティッチジョブを実行する場合は、最初の入力画像をリセットする必要はありません。
表示 | 画像の上に表示するグラフィックスオーバーレイを指定します。
0 = 非表示 (デフォルト) | ScaleImage 関数を含んでいるセルがスプレッドシート上でハイライトされている場合を除き、入力領域境界と再サンプリングされた画像は表示されません。
1 = 結果のグラフィックスのみ | 再サンプリングされた画像が常に表示されます。
2 = 入力のグラフィックスのみ | 入力領域境界が常に表示されます。

## Stitch の出力

戻り値 | 処理済みの画像を含んでいる Image データ構造体。入力パラメータが無効であれば #ERR を返します。

## Stitch の例

この例のジョブでは、入力画像の対象物はボトルです。この例の目的は、複数の画像をつなぎ合わせて 1 つの画像にすることです。

1. Stitch 関数を In-Sight スプレッドシートに挿入します。

2. プロパティシートで [領域] をダブルクリックして ROI を定義します。画像の上に赤い ROI ボックスが表示されます。カーソルを使用してボックスを移動したり、サイズを変更したりします。

3. [ピクセルシフト X] または [ピクセルシフト Y] を定義して出力画像のサイズを設定します。例えば、縦の画像をつなぎ合わせる場合は、シフトあたりの[ピクセルシフト X] パラメータを設定します。

   ヒント : ピクセルシフト値を求めるには、パターンマッチ関数関数を使用することをお勧めします。

4. [出力画像あたりのスティッチ数] を設定して、つなぎ合わせる画像の数を定義します。

   注 : 出力画像の高さは、選択した画像の数にピクセルシフトを乗算したものになります。ピクセルシフト値が入力画像の高さの値より大きい場合、出力画像にエラーが表示される場合があります。

5. [ジョブの編集] ツールバーの [OK] ボタンをクリックして選択内容を確定し、プロパティシートに戻ります。

   ヒント : Enter キーを押すか、ROI 内をダブルクリックして、選択内容を確定することもできます。

6. つなぎ合わせる画像を個別に選択します。

   Stitch 関数が完了すると、[完了] の値が 0.000 から 1.000 に変わります。この関数は出力画像を作成します。

   注 : つなぎ合わせた画像は画像バッファを消費しません。