TouchEngine

TouchEngineノードは、TouchEngine API (opens in a new tab)を使用して、TouchDesigner プロジェクトを直接 Screenberry パイプラインに統合することができます。TouchEngine から取得した映像ストリームは、テクスチャまたは合成レイヤーとして使用することができます。入力データストリームは、トラッキング座標、オブジェクトのプロパティ、DMX 値、タッチイベント、およびその他のリアルタイムデータなど、Screenberry に情報を提供するために使用することができます。

メモ： TouchEngine は、TouchDesigner のインストールされたバージョンと有料ライセンスが必要です。TouchEngine を実行すると、自動的にユーザーのシステム上で使用可能な TouchDesigner アプリケーションが検出されます。

メモ： TouchEngine を動作させるためには、TouchDesigner を実行する必要はありません。

TouchDesigner プロジェクトを統合可能にするためには、以下の手順を実行してください。

1. TouchDesigner プロジェクト内で、必要なタイプの In オペレータと Out オペレータを作成します。
2. プロジェクトをコンポーネント（.tox ファイル）として保存します。

Screenberry に TouchDesigner プロジェクトを統合するには、以下の手順を実行してください。

1. ノードグラフにTouchEngineノードを追加します。
2. TouchEngineノードのノード設定で、.tox ファイルを選択して読み込みます。
3. TouchDesigner プロジェクト内の In オペレータと Out オペレータに対応する入力と出力パラメータを追加するために、以下の手順を各パラメータに対して繰り返します。
   1. Add Input Parameter / Add Output Parameterボタンを押します。
   2. TouchDesigner から追加されたパラメータの名前をコピーして貼り付けます。

メモ： TouchDesigner のバージョン 2021.13610 以前では、In オペレータと Out オペレータの名前にはinput/ と output/ の接頭辞を使用する必要がありました。バージョン 2021.13610 以降では、In オペレータと Out オペレータの両方に op/ の接頭辞を追加する必要があります。

メモ： 追加した TouchEngine パラメータのFound情報チェックボックスが選択されていることを確認してください。それ以外の場合は、パラメータ名が対応する TouchDesigner オペレータの名前と一致しているかどうかを確認してください。

3. 追加されたパラメータのタイプを選択してください - TOP、CHOP、DAT（テーブル）、またはDAT（文字列）。

現在、TouchEngine API では、TOP、CHOP、および DAT の入力および出力オペレーターがサポートされています。

• TOP は、映像の作成、合成、変更、ファイルおよびネットワークへの静止画および動画の読み書きを行うオペレーター群です。TOP はグラフィックカードの GPU 上で動作します。
• CHOP は、アニメーション、オーディオ、数学、シミュレーション、ロジック、UI 構築などに使用されるチャンネル（数値の組）に対して操作を行うオペレーター群です。
• DAT は、テキスト文字列（複数行のテキストまたはテーブル）を操作するオペレーター群です。複数行テキストはコマンドスクリプトであることが多いですが、任意の複数行テキストであることもあります。テーブルは、テキスト文字列を含むセルの行と列で構成されます。

ノードの設定に入力/出力パラメーターが追加されると、ノードに対応するピンが追加されます。これにより、必要に応じて他のノードにこのパラメーターを接続することができます。