TouchDesigner」タグアーカイブ

Bone Group SOP

概要

Bone Group SOPは、共通の骨(共有骨)に、プリミティブをグループ化します。
ジオメトリーを変形させるためにBone Groupsを使用することに関する詳細は、以下の項目を参照してください。:
Deforming_Geometry_(Skinning)。
すべてのキャプチャーウェイトは再ノーマライズされます。

パラメータ
Max Bones per Point / bonesperpoint

この最大数に達するまでボーンがウェイトが小さいポイントを無視することにより、ポイントあたりの骨の数を減らします。

Max Bones per Group / bonespergroup

プリミティブのグループごとに許可されるボーンの最大数。 この番号より骨が多い場合は、新しいグループが作成されます。

Blend SOP

概要

Blend SOPは、同じトポロジーのシェイプ間で3D変形させます。16の各入力チャンネルの平均ウェイトを使用して、SOP間でブレンドすることが出来ます。ポイントカラーの補間やテクスチャーのコーディネートの調整も行います。
期待される結果を得るためには、各SOPのジオメトリーが同じポイント/CV数(フェースも含む)でなければなりません。ポイントは類似した順序でなければなりません。1つのソースでポイント17が左側にあり、そして、もう一つのソースでポイント17が右側にある場合、ブレンドをさせると、歪んでねじれた変形になり、オブジェクトの中をポイントが横切るような欠陥になる可能性があります。こうした結果を確実に回避するためには、ブレンドするすべての部分を同じシェイプをベースにポイント位置を編集して作成します。モーフィングする各部分は、異なるSOPでなければなりません。
例えば、Model Editorでシェイプを編集する場合、各ジオメトリーはファイルに保存して、読み込むか、Blend SOPに直接Model SOPを接続します。Blend SOPの1番目の入力がベース・モデル・ジオメトリーになります。続いて順番に15のModel SOPがBlendとして供給されます。Model SOPsがロックを外すことが出来ないため、File SOPを使用することなくデータを安全に保持することが出来ないことに留意してください。Blend SOPはゼロ・ウェイトの無い入力をcookするだけです。

パラメータ
Group / group

1番目の入力データのポイントまたはプリミティブグループを指定します。例えば、1番と3番のポイント番号を含むグループが指定された場合、各入力のポイントNo1番、3番のポイントはブレンドされ、2番、4番、5番などのポイントは1番目の入力ソースと一致するように設定されます。Scripting > Pattern Matchingの章で説明されているように、パターンを受け入れます。

Blend Input 0 – 3 / blend1v

出力ジオメトリへのジオメトリ入力の影響を制御するチャネル。

  • blend1v1
  • blend1v2
  • blend1v3
  • blend1v4
Blend Input 4 – 7 / blend2v

出力ジオメトリへのジオメトリ入力の影響を制御するチャネル。

  • blend2v1
  • blend2v2
  • blend2v3
  • blend2v4
Blend Input 8 – 11 / blend3v

出力ジオメトリへのジオメトリ入力の影響を制御するチャネル。

  • blend3v1
  • blend3v2
  • blend3v3
  • blend3v4
Blend Input 12 – 15 / blend4v

出力ジオメトリへのジオメトリ入力の影響を制御するチャネル。

  • blend4v1
  • blend4v2
  • blend4v3
  • blend4v4
Differencing / diff

1より大きい値または0より小さい値をオーバースケールブレンドにして、誇張されたブレンドを生成します。
このオプションがチェックされると、上記のチャンネル値は合計されず、1にスケーリングされません。1番目の入力は参照とみなされます。 Blendは各点の最初の入力と他の入力の差を計算します。 1より大きく0より小さい値は、入力2以上の形状の誇張を生成します。ただし、最初の入力は、そのブレンドチャンネル/ blend1によって誇張されません。これは “ベース”とみなされます。 Differencingを使用する場合、/ blend1チャネルは効果がありません。1番目の入力ジオメトリを変形しなければならない場合は、それを別の入力に送ります。ここでは、ブレンドチャンネルが効果を持ちます。

Blend Position / dopos

チェックすると、入力のポイント位置がブレンドチャンネルのウェイトに基づいてブレンドされます。チェックされていない場合、入力ジオメトリは変更されず、選択されている場合にのみカラー、ノーマル、テクスチャのブレンドが許可されます。

Blend Colors / doclr

チェックすると、ジオメトリ入力のポイント・カラーがブレンドチャンネルのウェイトに基づいてブレンドされます。

Blend Normals / donml

チェックすると、ジオメトリ入力のポイント・ノーマルがブレンドチャネルのウェイトに基づいてブレンドされます。

Blend Texture / douvw

チェックすると、ジオメトリ入力のポイントテクスチャ座標がブレンドチャネルのウェイトに基づいてブレンドされます。

Blend Up / doup

チェックすると、ジオメトリ入力のアップベクトルがブレンドチャンネルのウェイトに基づいてブレンドされます。

Web DAT

概要

Web DATは、ウェブ接続からデータのページ取得します。データはASCIIで読取り可能でなければなりません。Web DATは、gzip圧縮したページ移動を自動的解凍します。XMLコンテンツは、サーバーから送信される1行の長いラインを読み込み可能なインデント構造にフォーマット化されます。読み出す最後のページのプロパティを取得するために、Info DATを使用します。Web DATを使用してウェブサイトからページを取得する方法は2つあります:
Fetch とSubmit and Fetch
Fetchメソッドは、シンプルなプロトコル”GET”使用して、インターネットからページを単純に取得します。データをサーバーにサブミットするためには、Submit and Fetchメソッドを使用します。後のメソッドはデフォルトで”POST”プロトコルを使用します。

両方の方法で、取得する間のオプションを選択するために、DATテーブルを入力することが出来ます。このテーブルは、name/valueのペアの列で構成されていなければなりません。最初のカラムは、ネーム、2番目のカラムが値で構成されます。Fetchメソッドは指定したURLに組を単純に連結します。Update and Fetch方法は、リザルトページを取得する前にwebserverにペアを送信します。例えば、以下のコンテンツによるテーブルがWeb DATに接続していると仮定してください:

name joe
month May

指定されたURLが以下の通りであるならば:
http://www.example.com

Fetchメソッドは、以下を実際に取得します:
http://www.example.com?name=joe&month=May

同様に、ページを取得する前に、Submit and Fetch方法は、指定されたwebserverにペアを送信します。
テーブルのスペースと他の特殊文字が正確にコード化されることに注意してください。例えば、名前の各々のスペースまたは値はコード化されます:%20

Text DAT

概要

Text DATは、フリーフォームの複数行のASCIIテキストを編集することができます。スクリプト、GLSLシェーダー、メモ、XMLなどに使用されます。フリーフォームのテキストとは、DATの2つの形式のうちの1つです(もう1つの形式は、セルの行と列からなるテーブルで、各セルにはTabel DATのようにテキスト文字列が格納されています)。
テキストは、Viewer ActiveがオンのときにDATに入力、或いは外部のテキスト・エディターで入力することができます。Text DATは、ディスク上のファイルまたはウェブ上のファイルからデータを取得することができます。リモート・テキスト・ファイルを指定する場合は、http:// を使用します。
テキストをスクリプトとして実行することに特化した Execute DAT も参照してください。CHOP Execute DAT は CHOP チャンネルが変更されたときにスクリプトを実行します。DAT Execute DAT は DAT が変更されたときにスクリプトを実行ます。Execute DAT は TouchDesigner のプロセスを開始または終了したとき、またはフレームごとにスクリプトを実行したいときに実行ます。Panel Execute DAT はコントロール・パネルが変更されたときに実行します。Parameter Execute DAT はノードのパラメータが変更されたときに実行します。OP Execute DAT はコンポーネント・ネットワークのノードの作成や削除など、オペレータに関するあらゆる変更が行われたときに実行します。
Web DAT は、URL クエリによるフェッチに使用します。

パラメータ – File ページ
Edit.. / edit

クリックするとDATにテキストを追加/編集/削除するためのテキストエディターが開きます。

File / file

読み込みたいファイルのファイルシステムパスとファイル名を設定します。.txtと.datのファイルを受け付けます。

Sync to File / syncfile

Onの場合、プロジェクトの開始時にディスクからDATにファイルをロードします。ファイル名を設定する必要があります。このオプションをオンにすると、ディスクからファイルを直にロードします。ファイルが存在しない場合は、DATが最初に更新されたときに作成されます。このファイルは、ファイルに変更が加えられるとDATが更新されるように監視され、DATに加えられた変更はすぐにファイルに書き込まれます。ファイルが削除されても、DATには現在の内容が保持されます。

Load on Start / loadonstart

Onにすると、プロジェクトの開始時にディスクからDATにファイルを再読み込みします。

Load File / loadonstartpulse

瞬時にファイルを再読み込みします。

Write on Toe Save / write

Onにすると、プロジェクトの保存時にDATの内容をディスク上のファイルに書き出します。

Write File / writepulse

ファイルを瞬時にディスクに書き込みます。

パラメータ – Common ページ

参照:共通 Common ページ

Table DAT

概要

Table DATを使用すると、セルの行と列のテーブルを手動で編集、作成することが出来ます。各セルにはテキスト文字列が含まれます。 テーブルは、DATの2つの形式の1つです(もう1つは、Text DATを介した自由形式のテキストの行です)。
Table DATのビューアでは、行と列を追加し、ノードビューアの任意のセルにテキストを入力できます。 Table DATのビューアがアクティブになっている場合は、セルを右クリックしてテーブルの構造を変更し、Tabキーを使用して次のセルにジャンプ、上下の矢印キーを使用して隣接するセルに移動します。
また、 op(‘table1′)[2,’select’] = ‘yes’ のようにしてテーブルのセルに文字列を入れたり、 python の .appendRow() を使って行を追加したりすることもできます。Script DATとそのスニペットも参照してください。
Table DATは、ディスクまたはWeb上の .txt または .dat ファイルからテーブルをロードすることもできます。 インターネット上でテーブルを指定するときは、 `http://`を使用してください。 テキストはタブ区切りのテーブルに変換されます。

パラメータ – Table ページ
Edit.. / edit

クリックすると、DATからテキストを追加/編集/削除するためのテキストエディタが開きます。

File / file

読み込むファイルのファイルシステムパスと名前を設定します。.txt と .dat ファイルを読み込みます。

Load on Start / loadonstart

オンの場合、プロジェクトの開始時にディスクからDATにファイルをリロードします。

Sync to File / syncfile

On の場合、プロジェクトの開始時にディスクから DAT にファイルをロードします。ファイル名を指定する必要があります。このオプションをオンにすると、ディスクからすぐにファイルがロードされます。ファイルが存在しない場合は、DATが最初に更新される時に作成されます。ファイルは監視されているので、ファイルに変更が加えられると DAT は更新され、DAT に加えられた変更はすぐにファイルに書き込まれます。ファイルが削除された場合、DATは現在の内容を保持します。

Load File / loadonstartpulse

瞬時にファイルをリロードします。

Write on Toe Save / write

On の場合、プロジェクト保存時に DAT の内容をディスク上のファイルに書き出します。

Write File / writepulse

瞬時にファイルをディスクに書き込みます。

Remove Blank Lines / removeblank

このオプションを有効にすると、ファイルを読み込む際に空行を変換しないようになります。

Exact Dimensions / dims

有効にすると、/ rowsおよび/ colsパラメーターを使用してテーブルDATの正確な行数と列数を定義できます。 これを有効にすると、既存の行または列は破棄されません。

Rows / rows

テーブルの行数を設定します。

Columns / cols

テーブルの列数を設定します。

パラメータ – Common ページ

参照:共通 Common ページ

Render Pick DAT

概要

Render Pick DAT は、3D レンダリングの任意のピクセルで 3D サーフェスに関する情報を取得し、3D レンダリングされたシーンにマルチタッチを実装することを可能にします。レンダリング(レンダートップまたはレンダーパストップから)をサンプリングし、指定されたピック位置のジオメトリから3D情報を返します。
select、u、vの3列以上のDATをフィードします。Multi TouchIn DAT は通常、Render Pick DATに接続され、Multi Touch In DAT は Render TOP の出力を表示しているコンテナを指します。
複数のカメラから同時にピックすることができます。Render TOPにリストされている最初のカメラ以外のビューからピックを行うカメラを指定することができます。列の値は、Camera COMPへのパス(Render Pick DATからの相対パス、または絶対パス)、または0から始まる整数のインデックスのいずれかです。 インデックスの場合、レンダーTOPに複数のカメラがリストされている場合、または’Custom Pick Camera(s)’パラメータにリストされているカメラがある場合、使用するカメラが選択されます。これは、様々なマルチカメラレンダリングの設定や、VRのようにピッキングがアイカメラの視点からではなく、ハンドコントローラの視点から行われる場合に便利です。
ピック位置は、レンダーピックDAT入力に接続するテーブルに配置されたu、v(水平、垂直)座標です。 入力テーブルの各行は、サンプリングされる1つの選択ポイントを表します。ただし、列見出しselect、u、v(およびその他の未使用の列)を含む最初の行は除きます。 select、u、v列は、PanelCHOPから取得するものです。 レンダーのアスペクト比に関係なく、uとvの値は左から右、下から上に0対1になります。
Strategy が Always の場合、その u,v の位置は常にサンプリングされ、その結果は Render Pick DAT 出力の対応する行に表示されます。
出力テーブルには、ピックされたジオメトリのパス、その位置(任意の参照フレーム内)、サーフェス法線(バンプマッピングを除く)、カメラからの距離、テクスチャUV座標、カラー、アルファ、インスタンスIDが表示されます。これにより、変形する頂点を持つサーフェスが適切にピックされます。

以下にいくつかの例があります。

  • パレットの中の geoPanel。
  • パレットのTechniquesの下のmultiTouch。
  • Render Pick DAT サンプル

Render Pick CHOPの章も参照してください。

パラメータ – Render Pick ページ
Strategy / strategy

ピックのインタラクションに基づいて値を更新するタイミングを設定します。

  • While Select / select
    選択/ピックされているときに値を継続的に更新します。
  • Hold First Picked / holdfirst
    ジオメトリがピックされたときに最初に返された値を保持します。
  • Hold Last Picked / holdlast
    ジオメトリがピックされたときに最後に返された値を保持します。これは、ピックが空の空間のサンプリングを開始した場合(シーンのその部分にジオメトリが存在しない場合)に、ジオメトリでピックされた最後の値を保持するという点で、Continuous ストラテジーとは異なります。別の方法として、Continuous ストラテジーを使用すると、ピックが空の空間のサンプリングを開始した場合、値はゼロにクリアされます。
  • Always / always
    選んだ場所の値を継続的に更新します。
Clear Previous Pick on New Pick / clearprev

このパラメータは、ストラテジーがHold Last Pickedに設定されている場合にのみ有効になります。このパラメータがonの場合、空のスペースで新しいピックを開始すると、値はクリアされます。オフの場合、空のスペースでピックを開始すると、最後の値が保持されます。

Response Time / responsetime

値が更新されるタイミングを設定します。

  • Next Cook (Faster) / nextcook
    値は現在のフレームでキャプチャされ、次のフレームで更新されます。結果は前のフレームのものですが、cookタイムははるかに速くなります。
  • This Cook (Slower) / thiscook
    値は現在のフレームでキャプチャされ、更新されます。
Pick Radius / pickradius

ピックの検索領域の半径を設定します。ピックの中心に何も見つからない場合は、ピック半径で定義された検索領域内のジオメトリを検索し続けます。

Pick Radial Step / pickradstep

探索領域内の探索を減らすために使用されます。探索領域は、中心のピックポイントから外側の スポーク に対応する位置でサンプリングされます。

Pick Circular Step / pickcirstep

探索領域内での探索を減らすために使用します。探索領域は、中心のピックポイントから外側の リング に対応する位置でサンプリングされます。

Render/RenderPass TOP / rendertop

どのシーンをピックするか、どのカメラからピックするかを指定します。デフォルトでは、Render TOPに表示されている最初のカメラがピックに使用されます。Custom Pick Camera(s) パラメータで別のカメラを指定したり、camera inputの列を使って複数のカメラを選択することができます。

Custom Pick Camera(s) / custompickcameras

ここに1つ以上のカメラCOMPを指定することで、カスタムカメラのビューポートからピックすることができます。このパラメータが空白の場合、レンダーTOPのカメラが使用されます。複数の異なるカメラの視点からピックするには、入力DATにカメラ列を指定する必要があります。

Allow Multi-Camera Rendering / allowmulticamera

マルチカメラレンダリングは、複数のパスを同時にレンダリングするための高速な方法です。この機能は、088バージョンで作られた古いGLSL MATでは正しく動作しない場合があります。一般的にはオンのままにしておくべきです。

Use Pickable Flags / usepickableflags

onにすると、Render Pick DAT で Pickable Flag がオンになっているジオメトリのみが選択できるようになります。Pickable FlagはすべてのObjectコンポーネントにあります。

Include Non-Pickable Objects / includenonpickable

ピッキングアルゴリズムの中に非ピッキングオブジェクトを含め、非ピッキングオブジェクトがピッキング可能なオブジェクトの背後に隠れてしまう可能性があるようにします。例えば、シーン内にピッキング可能なオブジェクトが1つしかなく、追加の非ピッキングのジオメトリが多数存在する場合、このパラメータをオンにすると、ピッキング可能なオブジェクトが非ピッキングのオブジェクトの後ろにある場合(非ピッキングのオブジェクトによって隠されている場合)には、ピッキング可能なオブジェクトが選択されないようになります。

Merge Input DAT / mergeinputdat

入力テーブルをRender Pick DATsの列に追加します。

Activate Callbacks / activatecallbacks

各ピックイベントのCallback DATを有効にします。

Callbacks DAT / callbacks

受信したピックイベントのコールバックを含める DAT のパスを設定します。

パラメータ – Options ページ
Fetch Position / position

ジオメトリ上でピックされた点の位置を返します。 tx, ty, tz列。

  • No / no
    位置の値を返しません。
  • In SOP Space / sopspace
    SOP変換空間内でピックされた点の位置を返します。
  • In World Space / worldspace
    ワールドトランスフォーム空間でピックした点の位置を返します。
  • In Camera Space / cameraspace
    カメラ変換空間でピックした点の位置を返します。
  • Relative to Object / relativetoobj
    Reference Object パラメータで設定したオブジェクトに対するピックした点の相対位置を返します。
Fetch Normal / normal

ジオメトリ上でピックされた点の法線を返します。nx, ny, nz列。

  • No / no
    法線値を返しません。
  • In SOP Space / sopspace
    SOP変換空間で選択された点の法線を返します。
  • In World Space / worldspace
    ワールドトランスフォーム空間で選択した点の法線を返します。
  • In Camera Space / cameraspace
    カメラ変換空間でピックした点の法線を返します。
  • Relative to Object / relativetoobj
    Reference Objectパラメータで指定されたオブジェクトに対して相対的にピックされた点の法線を返します。
Reference Object / referenceobj

Relative to Objectで位置や法線を取得する際に参照するオブジェクトを設定します。

Fetch Point Color / color

ジオメトリ上でピックした点の色を返します。cr, cg, cb, ca列。

Fetch Texture UV / uv

ジオメトリ上でピックした点のテクスチャ座標を返します。mapu, mapv, mapw列。

Fetch Depth / depth

Depth Buffer関数は、ジオメトリ上でピックされた点の深度を返します。この値は、Depth Buffer の近傍平面と遠方平面の間の点の位置の非線形比です。列はdepthです。

Fetch Instance ID / instanceid

オブジェクトのインスタンスIDを返します。インスタンスがオフの場合は常に0になります。r列はinstanceです。

Custom Attrib 1 / customattrib1

オブジェクトから返すカスタム属性を指定します。

Custom Attrib 1 Type / customattrib1type

このメニューから属性の種類を選択します。

Custom Attrib 2 / customattrib2

オブジェクトから返すカスタム属性を指定します。

Custom Attrib 2 Type / customattrib2type

このメニューから属性の種類を選択します。

Custom Attrib 3 / customattrib3

オブジェクトから返すカスタム属性を指定します。

Custom Attrib 3 Type / customattrib3type

このメニューから属性の種類を選択します。

Custom Attrib 4 / customattrib4

オブジェクトから返すカスタム属性を指定します。

Custom Attrib 4 Type / customattrib4type

このメニューから属性の種類を選択します。

パラメータ – Common ページ

参照:共通 Common ページ

OSC Out DAT

概要

OSC Out DATは、遠隔地にあるコンピュータ間でOSC接続で情報を送信するために使用します。OSCメッセージを出力するには、.sendOSC() pythonメソッドを使用します。
OSC、OSC In DAT、OSC In CHOP、OSC Out CHOP、iOS and OSC、Network Protocols、Syncの各章も参照してください。
Windows OS の場合の注意事項 – 接続に問題がある場合は、Windows ファイアウォールが無効になっていることを確認してください。

パラメータ – Connect ページ
Active / active

onにすると、DAT はネットワークポートとの間で情報を送受信します。offにすると、更新は発生しません。ポートに送信されたデータは失われます。

Protocol / protocol

使用するネットワークプロトコルをします。詳細については、Network Protocolの章を参照してください。

  • Messaging (UDP) / msging
  • Multi-Cast Messaging (UDP) / multicastmsging
  • Reliable Messaging (UDT Library) / reliablemsging
Network Address / address

UDPを使用する場合のターゲットコンピュータのネットワークアドレスを設定します。マルチキャストの場合は、送信先のマルチキャストアドレスとなります。このアドレスは、foo や foo.bar.comのような標準的なWWWアドレスです。IPアドレス(例:100.123.45.78)を入れることができます。localhost を入れた場合は、パイプの相手が同じコンピュータ上にいることを意味します。

Port / port

送信先のネットワークポートを設定します。

Local Address / localaddress

システムに複数のNIC(Network Interface Card)があり、どのNICを使用するか選択したい場合に送信元のIPアドレスを設定します。

Shared Connection / shared

同じネットワークプロトコルを使用して、他のネットワークDATと同じ接続を使用します。

OSC Address Scope / addscope

生成されるメッセージを減らすために、メッセージのアドレス名パターンを使用して、メッセージを含めたり除外したりすることができます。例えば、^*accel*は、mrmrrのようなiOSやiPhoneアプリから入ってくる加速度計メッセージを除外します。 可能なアドレス名パターンの構文については、Pattern Matchingの章を参照してください。

Include Type Tag / typetag

各メッセージに引数リスト型タグを含みます。これは、パラメータ型キーワードを含みます。(解析アプリケーションがパラメータ型を識別する必要がある場合)

Split Bundle into Messages / splitbundle

On の場合、バンドル内に含まれる各メッセージには、それ自身の行が与えられます。

Split Message into Columns / splitmessage

On の場合、OSC のアドレスと引数には個別の列が与えられ、それ以外の場合はメッセージの列に含まれます。

Bundle Timestamp Column / bundletimestamp

Onの場合、各バンドルのタイムスタンプ値が列に含まれます。

パラメータ – Received Messages ページ
Callbacks DAT / callbacks

コールバックDATは、受信したメッセージごとに1回実行されます。

Execute from / executeloc

スクリプトが実行される場所を設定します。

  • Current Node / current
    スクリプトは現在のノードの位置から実行されます。
  • Callbacks DAT / callbacks
    スクリプトは、Callbacks DATパラメータで指定されたDATの場所から実行されます。
  • Specified Operator / op
    スクリプトは、以下のFrom Operatorパラメータで設定したオペレータから実行されます。
From Operator / fromop

Execute From が Specified Operator に設定されている場合、状態が変化するとDATがスクリプトを実行するようにトリガーするオペレーターを設定します。 この演算子は、Execute From パラメーターが Specified Operator に設定されている場合にスクリプトが実行されるパスでもあります。

Clamp Output / clamp

DATはデフォルトでは100メッセージに制限されていますが、Clamp Outputでは無制限を含む任意の設定が可能です。

Maximum Lines / maxlines

メッセージの数を制限し、メッセージはリストから古い順に削除されます。

Clear Output / clear

見出し以外の行をすべて削除します。pythonスクリプトでクリアするには
`op(“*”opname”*“).par.clear.pulse()`

Bytes Column / bytes

メッセージの生のバイト数を別の列に出力します。

パラメータ – Common ページ

参照:共通 Common ページ

OSC In DAT

概要

OSC In DATは、デフォルトでUDPを使用してOpen Sound Controlのフル・サウンド・コントロール・パケットを受信し、解析します。各パケットは解析され、DATのテーブルの行として追加されます。テーブルはFIFO fisrt-in first-out で、パラメータ設定された行数に制限されています。受信した各パケットに対して、オプションのスクリプトを実行することができます。各パケット/行は、1つのOSCメッセージ、またはOSCバンドル全体を表します。各引数は、ASCIIテキストに変換されます。
OSC、OSC Out DAT、OSC In CHOP、OSC Out CHOP、iOS、OSC、Network Protocolsの各章も参照してください。
サポートされている引数タグの種類は以下の通りです。

  • i : int32
  • f : float32
  • s : OSC-文字列
  • b : OSC-blob
  • h : 64ビット、ビッグエンディアン2の補足整数
  • t : OSC-timetag
  • d : 64ビット(ダブル)IEEE 754浮動小数点数
  • S : OSC-文字列として表される交互のタイプ
  • c : アスキー文字
  • r : 32ビットのRGBAカラー
  • m : 4バイトのMIDIメッセージ
  • T : True
  • F : False
  • N : Nil
  • I : Infinitum
  • [ : 配列の始まり
  • ]: 配列の終わり

マルチベクトル引数(例 “blob”、 “midi”、 “rgb”など)の場合、値のリストはダブル・クオートで囲まれます。 不明な引数タイプの場合は、代わりに、その引数のバイトを表す10進値のクオート付きリストが含まれます。
Windows OS の場合の注意事項 – 接続に問題がある場合は、Windows ファイアウォールが無効になっていることを確認してください。

パラメータ – Connect ページ
Active / active

onにすると、DAT はネットワークポートに送信される情報を受信します。offにすると、更新は発生しません。ポートに送信されたデータは失われます。

Protocol / protocol

使用するプロトコルを設定します。詳細についてはNetwork Protocolsの章を参照してください。

  • Messaging (UDP) / msging
  • Multi-Cast Messaging (UDP) / multicastmsging
  • Reliable Messaging (UDT Library) / reliablemsging
Network Address / address

マルチキャストプロトコルの場合、リッスンするマルチキャストアドレスを設定します。UDTプロトコルの場合は、サーバのIPアドレスを設定します。

Port / port

OSC-Inがパケットを受け付けるポートを設定します。

Local Address / localaddress

システムに複数のNIC(Network Interface Card)があり、どのNICを使用するか選択したい場合に受信するIPアドレスを指定します。

Shared Connection / shared

同じネットワークプロトコルを使用して、他のネットワークDATと同じ接続を使用します。

OSC Address Scope / addscope

生成されるメッセージを減らすために、メッセージのアドレス名パターンを使用して、メッセージを含めたり除外したりすることができます。例えば、^*accel*は、mrmrrのようなiOSやiPhoneアプリから入ってくる加速度計メッセージを除外します。 可能なアドレス名パターンの構文については、Pattern Matchingの章を参照してください。

Include Type Tag / typetag

各メッセージに引数リスト型タグを含みます。これは、パラメータ型キーワードを含みます。(解析アプリケーションがパラメータ型を識別する必要がある場合)

Split Bundle into Messages / splitbundle

On の場合、バンドル内に含まれる各メッセージには、それ自身の行が与えられます。

Split Message into Columns / splitmessage

On の場合、OSC のアドレスと引数には個別の列が与えられ、それ以外の場合はメッセージの列に含まれます。

Bundle Timestamp Column / bundletimestamp

Onの場合、各バンドルのタイムスタンプ値が列に含まれます。

パラメータ – Received Messages ページ
Callbacks DAT / callbacks

コールバックDATは、受信したメッセージごとに1回実行されます。 使用法については、oscinDAT_Classの章を参照してください。

Execute from / executeloc

スクリプトが実行される場所を設定します。

  • Current Node / current
    スクリプトは現在のノードの位置から実行されます。
  • Callbacks DAT / callbacks
    スクリプトは、Callbacks DATパラメータで指定されたDATの場所から実行されます。
  • Specified Operator / op
    スクリプトは、以下のFrom Operatorパラメータで設定したオペレータから実行されます。
From Operator / fromop

Execute From が Specified Operator に設定されている場合、状態が変化するとDATがスクリプトを実行するようにトリガーするオペレーターを設定します。 この演算子は、Execute From パラメーターが Specified Operator に設定されている場合にスクリプトが実行されるパスでもあります。

Clamp Output / clamp

DATはデフォルトでは100メッセージに制限されていますが、Clamp Outputでは無制限を含む任意の設定が可能です。

Maximum Lines / maxlines

メッセージの数を制限し、メッセージはリストから古い順に削除されます。

Clear Output / clear

見出し以外の行をすべて削除します。pythonスクリプトでクリアするには `op(“*”opname”*“).par.clear.pulse()`

Bytes Column / bytes

メッセージの生のバイト数を別の列に出力します。

パラメータ – Common ページ

参照:共通 Common ページ

MIDI In DAT

概要

MIDI In DATは、指定したMIDIデバイスからTouchDesignerに入力されたすべてのMIDIメッセージを記録します。メッセージ、タイプ、チャンネル、インデックス、値の各列をテーブル形式で出力します。
しかし、一般的な設定はもっと簡単です。Dialogs -> MIDI Device MapperでMIDIを設定すると、TouchDesignerはdevice 1などのために/local/maps/map1を指すSelect CHOPでMIDIを受信する準備ができています。
MIDI Event DAT、MIDI In Map CHOP、MIDI In CHOP、MIDI Out CHOP、Tscript `midi()` コマンド、MIDI Device Mapper ダイアログの各章も参照してください。

パラメータ – Connect ページ
Active / active

onにしたときのMIDIイベントを記録します。

Device Table / device

MIDIデバイスのTalbe DATへのパスを設定します。

Device ID / id

デバイスIDを設定します。

パラメータ – Filter ページ
Skip Sense / skipsense

これがonになっている場合、センスメッセージをログに記録しません。

Skip Timing / skiptiming

これがonになっている場合、タイミングメッセージを記録しません。

Filter Messages / filter

これがonになっている場合、以下のメッセージ フィルタリング パラメータが有効になります。

Message / message

MIDI メッセージの内容でフィルタリングします。例:Control Change

Channel / channel

MIDI メッセージ channels でフィルタリングします。チャンネルの範囲は 1 から 16 までです。

Index / index

MIDI メッセージ index でフィルタリングします。インデックスの範囲は 1 から 128 までです。

Value / value

MIDI メッセージ value でフィルタリングします。値の範囲は 0 から 127 です。

パラメータ – Received Messages ページ
Callbacks DAT / callbacks

このスクリプトは、テーブルに追加された各行(MIDI イベントが受信された)ごとに一度だけ実行されます。使用法は midieventDAT_Class を参照してください

Execute from / executeloc

スクリプトが実行される場所を設定します。

  • Current Node / current
    スクリプトは現在のノードの位置から実行されます。
  • Callbacks DAT / callbacks
    スクリプトは、Callbacks DATパラメータで指定されたDATの場所から実行されます。
  • Specified Operator / op
    スクリプトは、以下のFrom Operatorパラメータで指定したオペレータから実行されます。
From Operator / fromop

ExecuteがSpecifiedOperatorに設定されている場合、状態が変化するとDATがスクリプトを実行するようにトリガーするオペレーターを設定します。 このオペレータは、Execute FromパラメーターがSpecified Operatorに設定されている場合にスクリプトが実行されるパスでもあります。

Clamp Output / clamp

DATはデフォルトで100メッセージに制限されていますが、Clamp Outputでは無制限を含む任意の設定が可能です。

Maximum Lines / maxlines

メッセージ数を制限し、古いメッセージはリストから最初に削除されます。

Clear Output / clear

見出し以外の行をすべて削除します。pythonスクリプトでクリアするには`op(“*”opname”*“).par.clear.pulse()`

Bytes Column / bytes

メッセージの生のバイト数を別の列に出力します。

パラメータ – Common ページ

参照:共通 Common ページ

MIDI Event DAT

概要

MIDI Event DATは、すべてのMIDIデバイスからTouchDesignerに入ってくるすべてのMIDIメッセージを記録します。また、TouchDesignerから発信されたMIDIメッセージも記録されます。メッセージ、タイプ、チャンネル、インデックス、値の各列をテーブル形式で出力します。
テーブルは FIFO “first-in-first-out “で、パラメータ設定された行数に制限されています。オプションのスクリプトは、受信したパケットごとに実行することができます。
MIDI In DAT、MIDI In Map CHOP、 MIDI In CHOP、MIDI Out CHOP、Tscript `midi()` コマンドの章も参照してください。

パラメータ – Connect ページ
Active / active

onにした時、MIDIイベントを記録します。

パラメータ – Filter ページ
Skip Sense / skipsense

これがonになっている場合、センスメッセージをログに記録しません。

Skip Timing / skiptiming

これがonになっている場合、タイミングメッセージを記録しません。

Filter Messages / filter

これがonになっている場合、以下のメッセージ フィルタリング パラメータが有効になります。

Message / message

MIDI メッセージの内容でフィルタリングします。例:Control Change

Channel / channel

MIDI メッセージ channels でフィルタリングします。チャンネルの範囲は 1 から 16 までです。

Index / index

MIDI メッセージ index でフィルタリングします。インデックスの範囲は 1 から 128 までです。

Value / value

MIDI メッセージ value でフィルタリングします。値の範囲は 0 から 127 です。

Dir / dir

メッセージの方向、input または output でフィルタリングします。

パラメータ – Received Messages ページ
Callbacks DAT / callbacks

このスクリプトは、テーブルに追加された各行(MIDI イベントが受信された)ごとに一度だけ実行されます。使用法は midieventDAT_Class を参照してください。

Execute from / executeloc

スクリプトが実行される場所を設定します。

  • Current Node / current
    スクリプトは現在のノードの位置から実行されます。
  • Callbacks DAT / callbacks
    スクリプトは、Callbacks DATパラメータで指定されたDATの場所から実行されます。
  • Specified Operator / op
    スクリプトは、以下のFrom Operatorパラメータで指定したオペレータから実行されます。
From Operator / fromop

ExecuteがSpecifiedOperatorに設定されている場合、状態が変化するとDATがスクリプトを実行するようにトリガーするオペレーターを設定します。 このオペレータは、Execute FromパラメーターがSpecified Operatorに設定されている場合にスクリプトが実行されるパスでもあります。

Clamp Output / clamp

DATはデフォルトで100メッセージに制限されていますが、Clamp Outputでは無制限を含む任意の設定が可能です。

Maximum Lines / maxlines

メッセージ数を制限し、古いメッセージはリストから最初に削除されます。

Clear Output / clear

見出し以外の行をすべて削除します。pythonスクリプトでクリアするには `op(“*”opname”*“).par.clear.pulse()`

Bytes Column / bytes

メッセージの生のバイト数を別の列に出力します。

パラメータ – Common ページ

参照:共通 Common ページ