TouchDesigner」タグアーカイブ

File In DAT

概要

File In DATは、.txtテキストファイルと.datテーブルファイルを読み込みます。 他のファイルはテキストとして読み取ろうとします。 ファイルはディスクまたはWeb上にあるものですy。 URLを指定するときはhttp://を使用してください。

パラメータ – File In ページ
File / file

読み込むファイルのファイルシステムパスと名前を指定します。通常のテキストには.txtファイルを、表形式のテキストには.datファイルを読み込みます。

Convert Text to Table / converttable

DATの内容を通常のテキストから表形式のテキストに変換します。(タブ区切りのテキスト、各は表の新しい列になります。)

Refresh / refresh

このパラメータがOnに設定された場合、ファイルをリロードします。

Refresh Pulse / refreshpulse

ディスクからファイルを即座にリロードします。

パラメータ – Common ページ

参照:共通 Common ページ

FIFO DAT

概要

FIFO DAT は、ユーザーが設定した最大行数をテーブルに保持します。行を追加するには、DAT クラスの appendRow() メソッドを使用します。テーブルの容量に達すると、最初の行が削除されます。最大行数に達した後、新しい行が追加されると、最も古い行は破棄されます。
例:

op(‘fifo1’).appendRow([‘a’,’b’,’c’])

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

FIFO 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が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()`

Keep First Row / firstrow

テーブルの最初の行を保持します。

パラメータ – Common ページ

参照:共通 Common ページ

Evaluate DAT

概要

Evaluate DATは、文字列編集や数学式を使って受信DATのセルを変更します。
最もシンプルな形では、入力DATに接続しなくても、Evaluate DATのExpressionパラメータに任意のPython式を入れることができます。フレームごとに式を評価するには、Expression をParameter Mode にする必要があります。
DATをアタッチすると、入力と同じ行数と列数の表を出力します。
Scopeページを使用して、セルのどの行と列が影響を受けるかを設定することができます。

  • Outputメニューが Expressions に設定した場合、入力セルはPython表記として評価されます。
    入力セルの値は me.inputCell.val です。
  • オプションの 2 番目のDAT入力 は入力のセルにマッチした後、評価されて出力される式の配列です。2番目のDATの行数が最初の行数より少ない場合、2番目の入力の最後の行の式が繰り返されます。2番目のDAT内の列が最初の列よりも少ない場合、最後の列が繰り返されます。
  • 式は、コンパイルされた内部バージョンを格納することで最適化され、より高速に実行されます。可能な限りこれを使用してください。テーブル内で式を繰り返すことで式を再利用している場合は、データとは別にサイクルスルーする少数の式を含む入力テーブルを持つこともパフォーマンスを向上させます。

2番目のDATが1セルの場合、Expressionパラメータのように、その式をすべての入力セルに適用します。1セルの2番目のDATが `me.inputCell.val+1` の場合、1番目の入力セルに1を加えます。
2番目のDATが

| me.inputCell.val | me.inputCell.val |
| —————- | ———————————————– |
| me.inputCell.val | math.sin(math.radians(float(me.inputCell.val))) |

とすると、最初の行と最初の列はそのまま残され、残りのセルはそのsin()が計算されます。

Evaluate DATは、Output Table Sizeパラメーターが使用されていない限り、最初の入力DAT(テーブルまたはテキスト)のフォーマットを維持します。
Substitute DAT、Expression CHOPも参照してください。

Evaluate DATは、(1)文字列を構築したり、(2)数学演算を行ったりするのに使用できます。

me.inputCell refers to the corresponding input cell that is used to evaluate the current cell. evaluateDAT_Class has a list of members that refer to incoming data. You can use Python to fetch data, like op(‘datpath’)\[row,col] to access DAT data and op(‘choppath’)[‘channame’\][sampleindex] to access CHOP data. A few examples:

# access data from a particular row from the input table at the currently evaluated column
me.inputTable[‘rowname’,me.inputCol]

# prefix the data in the current cell the input row and column
# a string in the first cell will be formatted as [0,0]:string
‘[‘+str(me.inputRow)+’,’+str(me.inputCol)+’]:’+me.inputCell

# add the numeric data in the current cell to numeric data from another table
op(‘datpath”)[me.inputRow,’colname’] + me.inputCell

# concatenate the numeric data in the current cell to string data from another table with a space between
op(‘datpath’)[me.inputRow,’colname’] + ‘ ‘ + me.inputCell

# concatenate the current row number to string data from another table with a space between
op(‘datpath’)[me.inputRow,’colname’] + ‘ ‘ + str(me.inputRow)

# concatenate a sample at the currrent row index from a chop channel with the current cell
me.inputCell + ‘:’ + str(op(‘choppath’)\[‘channame’\][me.inputRow])

他の演算子でデータにアクセスする例については、Working with DATs in Pythonの章とWorking with CHOPs in Pythonの章を参照してください。
また、tab(“tabpath”,row,col) や chop(“choppath”) のように、任意のTscript式を使ってデータを取得することもできます。対応する入力セルの値を表す $V のようなローカル変数のリストがあり、$F や $SYS_XRES のような他のTscript変数を使うことができます。
いくつかのTscript式v()およびvs()は、Evaluate DATに固有であり、入力内のすべてのセルにアクセスできます。 vs()は、floatではなく常に文字列を出力するため、v()とは異なります。
式v(row、col)およびvs(row、col)は、ローカル変数R(セルの行)およびC(セルの列)を使用できます。

  • v($ R、$ C)は$ Vと同じです。
  • v($ C、$ R)はセルを転置します。
  • 相対的な行/列を$ C、$ C-1、$ C + 1でアドレス指定し、最初の列のセルをv($ R、0)でアドレス指定できます。 vはセルの内容をfloatとして返します。 vsは、セルの内容を文字列として返します。

行/列名でセルを取得できる式は、以下の通りです。

  • vr(“*rowname*“,“*colnum*“)
  • vc(“*rownum*“,“*colname*“)
  • vrc(“*rowname*“,“*colname*“)

そして、上記の文字列バージョンは以下の通りです。

  • vsr(“*rowname*“,“*colnum*“)
  • vsc(“*rownum*“,“*colname*“)
  • vsrc(“*rowname*“,“*colname*“)

例: `vrc(“john”,”august”)`

ローカル変数NRとNCは、入力テーブルの行数と列数を与えます。

パラメータ – Evaluate ページ
Input Data DAT / dat

入力テーブルの代わりに使用されるDATテーブルを設定します。

Expressions DAT / datexpr

数式テーブルの代わりに使用される代替のDATAテーブルを設定します。

Output / output

DATからの出力に使用するフォーマットを設定します。

  • Evaluate / evaluate
    入力データをPython式として評価、コンパイルします。
  • Input Data / data
    操作なしで1 番目の入力からデータを渡します。
  • Input Expression / expression

2 番目の入力がない場合は、1 番目の入力を通過します。そうでない場合は 2 番目の入力を通過します。最初の入力が 2 番目の入力よりも多くの行または列を持つ場合、2 番目の入力の最後の行または列が繰り返され、余分なセルを埋めます。

Expression / expr

Expression入力またはDATが与えられていない場合に、各セルを評価するために使用する式を設定します。

Output Table Size / outputsize

Output Table SizeパラメータがStrings、Expressions、またはCommandsで、2 番目の入力がある場合、出力テーブル・サイズをInput DAT またはFormula DAT のいずれかに選択することができます。Formula DAT が選択され、そのテーブルサイズが入力データテーブルよりも大きい場合、残りの式を評価する際には、各行または列の最後のセルが使用されます。

  • Input 1 (Data) / in1
  • Input 2 (Expressions) / in2
Monitor Data Dependencies / dependency

OutputパラメータがStringまたはExpressionsに設定されている場合、DATはデータが使用するノードを監視し、時間の依存関係を確認し、それに応じてcookします。このトグルはデフォルトでオンになっています。入力の変更のみに基づいてDATをクッキングしたい場合は、これをオフにすることで、不必要な更新を避けることができます。

Convert Backslash Characters / backslash

\ nを改行に、\ tをタブなどに変換します。入力DATがテーブルの場合、\ n、\ tはスペースに変換されることに注意してください。

パラメータ – Common ページ

参照:共通 Common ページ

DAT Execute DAT

概要

DAT Execute DATは、別のDATの内容を監視し、その内容が変更されたときにスクリプトを実行します。監視するDAT は通常、テーブルです。
DAT Execute DAT は、デフォルトの python メソッド・プレースホルダで設定されます。パラメータで監視されている各条件に対して、DATにはそれにマッチするPythonメソッドが用意されています。パラメータで条件がonになっている場合、その条件が満たされるたびに対応する python メソッドが実行されます。

パラメータ – DAT Execute ページ
Active / active

onの間、DAT は参照するDATに応答します。

Execute from / executeloc

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

  • Current Node / current
    (Tscript のみ) スクリプトは現在のノードの位置から実行されます。
  • This Node / here
    スクリプトはDATの親から実行されます。 DATは親から実行され、DATの兄弟に簡単にアクセスできるようにします。DAT内部から実行するために使用されるDATスクリプト。
  • Specified Operator / op
    スクリプトはFrom Operatorパラメータで設定したオペレータから実行されます。
From Operator / fromop

ExecuteFromパラメーターがSpecifiedOperatorに設定された場合の実行されるスクリプトのパスを設定します。

DAT / dat

参照するDATの内容が変更されたときにスクリプトが実行するようにトリガされます。

Table Change / tablechange

onTableChange() メソッドは、前回のcook以降にテーブルが変更された場合に呼び出されます。

Row Change / rowchange

onRowChange() メソッドは、変更された行(前回のcook以降)ごとに一度だけコールされます。

Column Change / colchange

onColChange() メソッドは、変更された列(前回のcook以降)ごとに一度だけ呼び出されます。

Cell Change / cellchange

onCellChange()メソッドは、前回のcook以降に変更されたセルごとに呼び出されます。

Size Change / sizechange

onSizeChange() メソッドは、前回のcook以降にテーブルのサイズが変更されるたびに呼び出されます。

Execute / execute

メソッドがフレームの開始時に実行されるか、フレームの終了時に実行されるかを設定します。

  • Start of Frame / start
    このメソッドはフレームの開始時に呼び出されます。フレーム内で行が4回変更された場合、このメソッドは4回実行されます(例えば、Multi Touch In DATイベントのような場合に便利です)。
  • End of Frame / end
    このメソッドは、1フレーム内で複数回トリガされたとしても、フレームの最後に、最大で1フレームあたり1回実行されます。例えば、MonitorがRowに設定されている場合、フレーム内で複数回行が変更される可能性がありますが、各行に対して1回だけ呼び出されます。
Edit.. / edit

これをクリックすると、DAT内のテキストを編集するためのテキストエディタが開きます。

パラメータ – Common ページ

参照:共通 Common ページ

Clip DAT

概要

注意:TouchDesigner Proでのみ使用可能です。
Clip DATはClip CHOPとClip Blender CHOPによって操作されるモーションクリップに関する情報が含まれます。Clip DATは任意のコマンドまたはスクリプトテキストを格納することができ、Executeパラメータページの設定に基づいてトリガすることができます。(ここれがClip DATとText DATの異なる点です)Clip DATのスクリプトは、指定されたクリップがClip BlenderのCHOPを通じて再生されることでトリガーされます。

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

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

File / file

読み込むファイルのパスと名前。.txt と .dat ファイルを受け付けます。ファイルはディスクからでもウェブからでも読み込むことができます。URL を指定する場合は http:// を使用してください。

Reload File / reload

1 に設定すると、ファイルを DAT にリロードします。

パラメータ – Execute ページ
Execute from / executeloc

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

  • Current Node / current
    スクリプトは現在のノードの位置で実行されます。
  • This Node / here
    スクリプトはテキストDAT自体から実行されます。
  • Specified Component / comp
    スクリプトは、以下のComponentパラメータで設定したコンポーネントから実行されます。
Clip / clip

Clip BlenderCHOPで実行されたときにスクリプトをトリガーするClipCHOPを設定します。

Component / component

Execute fromパラメータでSpecified Componentを設定した時のスクリプトを実行するコンポーネントを設定します。

Execute on Frame (First) / framefirst

クリップの指定されたインデックスがClip Blender CHOPで最初に再生されるときに、スクリプトを1回実行します。 クリップがループしている場合でも、スクリプトは1回だけ実行されます。

Execute on Frame (Loop) / frameloop

クリップの指定されたインデックスがClip Blender CHOPで再生されるたびにスクリプトを実行します。 クリップがループしているとき、スクリプトはループするたびに実行されます。

Execute on Exit / exit

Clip Blender CHOPが指定したクリップを終了するときにスクリプトを実行します。

Print State / printstate
パラメータ – Common ページ

参照:共通 Common ページ

UDP Out DAT

概要

UDP Out DATは、遠隔地にあるコンピュータとの間でUDP接続を介して情報を送信するために使用します。メッセージの送信には、udpoutDAT_ClassのsendBytes()またはsend()メソッドを使用します。
このノードはOUTノードですが、送信先のマシンから返信メッセージを受け取ることができます。このメッセージは、UDP In DATと同様、DATのコンテンツに表示されます。
UDP In DAT、Touch Out DAT、TCP/IP DATの各章も参照してください。
Windows OSの場合、接続に問題がある場合は、Windowsファイアウォールが無効になっていることを確認してください。

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

このチェックボックスは接続を有効にします。

Protocol / protocol

使用するネットワークプロトコルを選択します。詳しくはNetwork Protocolsの章を参照してください。

  • Messaging (UDP) / msging
  • Multi-Cast Messaging (UDP) / multicastmsging
Network Address / address

送信先のIPアドレス(例:100.123.45.78)、またはマシン名を入れることができます。もし「localhost」と入れた場合、パイプの反対側が同じコンピュータ上にあることを意味します。マルチキャストを使用している場合は、送信先となるマルチキャストのアドレスをここに記入します。

Port / port

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

Shared Connection / shared

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

Row/Callback Format / format

受信したデータをどのように解析するか設定します。

  • One Per Byte / perbyte
    1バイト受信するごとに1行テーブルに追加されます。
  • One Per Line / perline
    受信した1行ごとに、テーブルに1行追加されます。行の終わりは、\n、 \r或いはNULL(\0)文字で区切られます。
  • One Per Message / permessage
    メッセージを受信するごとに、テーブルに1行追加されます。
Local Address / localaddress

送信先のIPアドレスを指定します。システムに複数のNIC(ネットワーク・インターフェース・カード)があり、どのNICを使用するかを選択したい場合に便利です。

Local Port Mode / localportmode

使用するローカルポートを自動または手動で選択することができます。

  • Automatic / automatic
  • Manual / manual
Local Port / localport

上記パラメータがManualに設定されている場合、ここに使用するポート番号を入力します。

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

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メッセージに制限されていますが、クランプアウトプットを使えば、無制限を含むあらゆる設定が可能です。

Maximum Lines / maxlines

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

Clear Output / clear

見出しを除くすべての行を削除します。パイソンスクリプトで削除する場合、以下の通りです。
`op(“*”opname”*“).par.clear.pulse()`

Bytes Column / bytes

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

パラメータ – Common ページ

参照:共通 Common ページ

UDP In DAT

概要

UDP In DATは、遠隔地にある2台のコンピュータ間のUDP接続で情報を受信するために使用します。このDATは、キューイングやバッファリングを行わずにすべてのメッセージをキャプチャし、必要なメッセージを送信することができます。メッセージを受信したDATは、sendコマンドを使って送信者に返信することができます。メッセージを受信する前にsendコマンドを使用しても、まだどこにデータを送ればよいのかわからないため、動作しません。マルチキャスト・モードでは、マルチキャスト・メッセージを送信するのではなく、最後に取得したマルチキャスト・メッセージの発信者に直接返信を行います。
UDP Out DAT、Touch In DAT、TCP/IP DATの各章も参照してください。
Windows OSの場合、接続に問題がある場合は、Windowsファイアウォールが無効になっていることを確認してください。

パラメータ – Connect ページ
Protocol / protocol

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

  • Messaging (UDP) / msging
  • Multi-Cast Messaging (UDP) / multicastmsging
Network Address / address

リッスンするマルチキャストのIPアドレスを設定します。

Port / port

リッスンするネットワークポートを設定します。

Shared Connection / shared

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

Row/Callback Format / format

受信したデータをどのように解析するかを決定します。

  • One Per Byte / perbyte
    1バイト受信するごとにテーブルが1行追加されます。
  • One Per Line / perline
    受信した1行ごとに、テーブルに1行追加されます。行の終わりは、\n、 \r或いはNULL(\0)文字で区切られます。
  • One Per Message / permessage
    メッセージを受信するごとに、テーブルに1行追加されます。
Active / active

このチェックボックスは接続を有効にします。

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

Callbacks DATはメッセージが来るたびに1回実行されます。使い方は、udpinDAT_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メッセージに制限されていますが、クランプアウトプットを使えば、無制限を含むあらゆる設定が可能です。

Maximum Lines / maxlines

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

Clear Output / clear

見出しを除くすべての行を削除します。パイソンスクリプトで削除する場合は以下の通りです。
`op(“*”opname”*“).par.clear.pulse()`

Bytes Column / bytes

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

パラメータ – Common ページ

参照:共通 Common ページ

MIDI Out CHOP

概要

MIDI Out CHOPはMIDIデバイスにMIDIイベントを送信します。一般的にMIDIコマンドは、MIDIイベントの出力に使用します。
MIDIデバイスには、他のソフトウェア・プログラム(midisynth)またはシリアルポートに接続されたデバイスが含まれます。チャンネルはMIDIイベントの送信コントロールに使用されます。チャンネルは最後のタイムスライス(最後のPlay Barポジションからカレントまで)が評価されます。

MIDI Out CHOPは入力チャネルの様々な変化に対応してMIDIイベントを送信します。チャンネルはch3、c14、ch7n60の様に、出力するMIDIイベントと同じ命名でなければなりません。同様に、MIDIメッセージを出力するためのスクリプトで使用するMIDコマンドについて考慮しなければなりません。
チャンネルがカレント・スライスの間、値が変更する毎にイベントが送信されます。フレームバーがリアルタイムで動作している限り、全てのタイミングは保持されます。チャンネルはそのネームによってイベントにマップされます。ノート、コントローラ、ベロシティなどのイベントはノート/コントローラ番号(n65、c7)のように続かなければなりません。ノート・イベントからナンバーが削除された場合、ノート・ナンバーはチャンネル値になります。全てのチャンネルに送信される他のイベントは、追跡しているナンバー(pc、pw)を必要としません。チャンネル・プレフィックスは、イベントを送信すべきMIDIチャンネルの識別に使用します。(例えば、ch1n45はTouchチャンネルをMIDIチャンネル上でノート45のメッセージに割り当てます。)

MIDI Out CHOPはMIDIにベロシティも送信します。MIDI Out CHOPに入力されたチャンネル値は、ノートのベロシティとして送信されます。NormalizeがNoneの場合、チャンネルは1~127である必要があります。Normalizeが0 to 1の場合、0~1のチャンネル値はMIDIの0~127にスケーリングされます。
Cook Every Frame オプションは、CHOPが表示されていない場合も、毎フレームCHOPをクックします。All Volume OffとAll Volume Onフラグは、全16チャンネルのコントローラーに新たにイベントを発行します。MIDI出力は、Touchでより遅延が少ない出力にするために、別々のスレッドに入ります。これはノート・イベントとコントローラ・イベントに対してTime Sliceモードで機能します。
(Program Change、Sysex messagesには現状まだ対応していません。)
注:チャンネルは、入力チャネルの値が0以下から0以上になる時、新たにNote Onを起動します。
これは、Note Offイベントに類似しています。チャンネル・ネームはチャンネル値をどのように解釈するか確定します。

例えば、

  • ch3n60
    このチャンネルは、チャンネル3ノート60と解釈されます。値が0以下から0以上になる時、Note Onイベントが送信されます。
  • ch5n
    このチャンネルは、ノートナンバーを含みます。値は整数に量子化されます。そして整数値が変化すると、古い値のノートは消去されて、新しい値のノートが入ります。
    例えば、チャンネルが53から78まで変化すると、ノート53に対するNote Offイベントとノート78に対するNote Onイベントが送信されます。
  • ch14c7
    チャンネル値は、チャンネル14のコントローラ7(ボリューム)に送信されます。
    デフォルトで0~1の値はMIDIの0~127の値にマップされます。

以下はTime Sliceモードで作用します:

  • チャンネルは「ch」で始まリ、チャンネル番号(1-16)が続きます。
  • ノートの場合、ノートを表す「n」の後にノート・ナンバーが続きます。
  • コントローラの場合、「c」の後にコントローラ・ナンバーが続きます。
  • これらのプレフィックスは変更することができます。
  • MIDI Outはアフタータッチ、プレッシャー、ピッチウィール・チャンネルを解釈して、MIDIストリームにこれらのイベントを出力します。

注:normalizationは0~127、0~1の範囲を与えて追加されます。

  • MIDI Outは、MIDIクロック・イベントを出力するために、バー・ランプ・チャンネルを読み込みます。
  • プログラム・チェンジ・イベントは、「pc」チャンネルを通じて実行されます。7、14ビット・コントローラ・イベントが出力されます。
  • MIDIストリームをキャプチャして、ファイルに出力することができます。

MIDI In DAT, MIDI Event DAT, MIDI In Map CHOP, MIDI In CHOP, MIDIコマンドも参照してください。

パラメータ – Dest ページ
Active / active
MIDI Destination / destination

MIDIイベントの送信先。 デフォルトの宛先はMIDIマッパーです。

  • Device / device
  • File / file
Device Table / device
Device ID / id
One Based Index / onebased
MIDI File / file

出力MIDIファイルのファイル名。

Write MIDI File / writefile

すべてのデータをMIDIファイルに書き出します。

Channel Prefix / prefix

名前からチャネル番号を抽出するためにすべての入力チャネルに必要なプレフィックス文字列を設定します。(つまり、「ch」のチャネルプレフィックスを持つ「ch1note44」)

Cook Every Frame / cookalways

フレームごとにCHOPを強制的にクックします。 MIDI Out CHOPは、CHOPがグラフィック表示ビューアーにつながる場合にのみクックするため、オンにする必要があります。 何でも表示しているかどうかに関係なくcookする必要があります。

パラメータ – Output ページ
Automatic Note Off / autonoteoff

MIDIの「All Note Off」イベントは、出力の開始および/または終了時に送信できます。

None / none
  • At Playback Start / start
  • At Playback End / end
  • At Playback Start and End / both
All Notes Off / reset

All Notes OffメッセージをすべてのMIDIチャンネルに送信します。

All Volume Off / volumeoff

All Notes OffメッセージをすべてのMIDIチャンネルに送信します。

All Volume On / volumeon

All Notes OnメッセージをすべてのMIDIチャンネルに送信します。

Send Start/Stop/Continue Events / startstop

フレームバーが開始または停止したときに適切なイベントを送信します。

パラメータ – Note ページ
Note Name / notename

ノートチャンネルのベース名。 入力チャンネルの名前の後に番号がある場合、それはノート番号であると見なされます。 そうでない場合、チャネル値にはノート番号が含まれていると想定されます。

Aftertouch Name / aftername

アフタータッチチャンネルの名前。

Pressure Name / pressname

チャンネル プレッシャー チャンネルの名前。

Normalize / notenorm

範囲0-1の値は、MIDI値0-127にマッピングされます。

  • None / off
  • 0 to 1 / 0to1
Pitch Wheel Name / pitchname

ピッチホイールチャンネルの名前。

パラメータ – Control ページ
Controller Name / controlname

コントローラーチャネルのベース名。

Controller Format / controlformat

7または14ビットのコントローラーイベントを送信します。

  • 7 bit Controllers / 7bit
  • 14 bit Controllers / 14bit
Normalize / controlnorm

Maps channel values from different ranges to 0-127.

  • None / off
  • 0 to 1 / 0to1
  • -1 to 1 / -1to1
  • On/Off / onoff
Program Change / progname

プログラム チェンジ チャネルの名前。

Bar Ramp Name / barname

クロックのティック周波数は、ランプの周期によって決まります。 ランプは0〜1である必要があります。各4ビートバー上の0〜1ランプの着信チャンネル名。

Ticks per Bar / barticks

デフォルトは96 = 4拍* 1拍あたり24ティックです。

パラメータ- Common ページ
Time Slice / timeslice

これをオンにすると、チャネルが強制的に「タイムスライス」されます。 タイムスライスは、最後のクックフレームと現在のクックフレームの間の時間です。

Scope / scope

影響を受けるチャネルを特定するために、一部のCHOPでは、Commonページの
でスコープ文字列を使用することができます。

Sample Rate Match / srselect

複数の入力CHOPのサンプルレートが異なる場合を処理方法を設定します。 リサンプリングが発生すると、カーブは補間方法オプションに従って補間されます。補間オプションが使用できない場合はLinearで処理されます。

  • Resample At First Input’s Rate / first
    最初の入力のレートを使用して、他の入力をリサンプリングします。
  • Resample At Maximum Rate / max
    最も高いサンプリングレートでリサンプリングします。
  • Resample At Minimum Rate / min
    最も低いサンプリングレートでリサンプリングします。
  • Error If Rates Differ / err
    競合するサンプルレートは受け入れません。
Export Method / exportmethod

CHOPチャンネルをパラメーターに接続する方法を設定します。 詳細については、Exportの章を参照してください。

  • DAT Table by Index / datindex
    ドッキングされたDATテーブルを使用し、CHOP内のチャンネルのインデックスを介してチャンネルを参照します。
  • DAT Table by Name / datname
    ドッキングされたDATテーブルを使用し、CHOP内のチャネルの名前を介してチャネルを参照します。
Export Root / autoexportroot

Channel Name is Path:パラメータでrelative toを設定することで、エクスポートするすべてのパスのルートノードを指定します。

Export Table / exporttable

DAT Table Export Methodsメソッドを使用するときにエクスポート情報を保持するために使用されるDATを指定します。

MIDI In Map CHOP

概要

最初にMIDI In DATを参照してください。MIDI In Map CHOP は、s1,s2 などから始まるスライダーチャンネルと b1,b2 などから始まるボタンチャンネルを用意する MIDI Device Mapper ダイアログから指定されたチャンネルを読み込みます。MIDI In Map CHOP はこれらのチャンネルから選択します。
注意: (Apr 12 09) このページはリリースノートの情報を更新する必要があります。

もう一つのCHOPであるMIDI In CHOPは、MIDIデータをより直接取得します。CHOP内のMIDIチャンネル番号、ノート番号、コントローラ番号を指定するので、MIDIマッピングを変更するにはTouchDesignerの設定を変更する必要がありますが、MIDI In Map CHOPでは、ユーザーはDialogs -> MIDI Device Mapperでマッピングを設定するだけで済みます。
MIDI In DAT、MIDI Event DAT、MIDI In CHOP、MIDI Out CHOP、midiコマンド、MIDI Device Mapper Dialogの章も参照してください。

パラメータ – MidiInMap ページ
Device Table / device

MIDIデバイステーブルDATのパスを設定します。

Device ID / id

使用するデバイスのIDを指定します。

Sliders / sliders

MIDI Mapper からインポートするスライダーコントローラーです。例えば、読み込む最初の 16 個のスライダー、スライダー 20 とスライダー 32 から 40 をインポートするには、次のように入力します。
s[1-16] s20 s[32-40]

Buttons / buttons

MIDI Mapper からインポートするボタンです。例えば、読み込む最初の 16 個のボタン、ボタン 20 とボタン 32 から 40 をインポートするには、次のように入力します。
b[1-16] b20 b[32-40]

Include Velocity in Buttons / bvelocity
Queue Slider Events / squeue
パラメータ – Channel ページ
Sample Rate / rate
Extend Left / left
  • Hold / hold
  • Slope / slope
  • Cycle / cycle
  • Mirror / mirror
  • Default Value / default
Extend Right / right
  • Hold / hold
  • Slope / slope
  • Cycle / cycle
  • Mirror / mirror
  • Default Value / default
Default Value / defval
パラメータ- Common ページ
Time Slice / timeslice

これをオンにすると、チャネルが強制的に「タイムスライス」されます。 タイムスライスは、最後のクックフレームと現在のクックフレームの間の時間です。

Scope / scope

影響を受けるチャネルを特定するために、一部のCHOPでは、Commonページの
でスコープ文字列を使用することができます。

Sample Rate Match / srselect

複数の入力CHOPのサンプルレートが異なる場合を処理方法を設定します。 リサンプリングが発生すると、カーブは補間方法オプションに従って補間されます。補間オプションが使用できない場合はLinearで処理されます。

  • Resample At First Input’s Rate / first
    最初の入力のレートを使用して、他の入力をリサンプリングします。
  • Resample At Maximum Rate / max
    最も高いサンプリングレートでリサンプリングします。
  • Resample At Minimum Rate / min
    最も低いサンプリングレートでリサンプリングします。
  • Error If Rates Differ / err
    競合するサンプルレートは受け入れません。
Export Method / exportmethod

CHOPチャンネルをパラメーターに接続する方法を設定します。 詳細については、Exportの章を参照してください。

  • DAT Table by Index / datindex
    ドッキングされたDATテーブルを使用し、CHOP内のチャンネルのインデックスを介してチャンネルを参照します。
  • DAT Table by Name / datname
    ドッキングされたDATテーブルを使用し、CHOP内のチャネルの名前を介してチャネルを参照します。
Export Root / autoexportroot

Channel Name is Path:パラメータでrelative toを設定することで、エクスポートするすべてのパスのルートノードを指定します。

Export Table / exporttable

DAT Table Export Methodsメソッドを使用するときにエクスポート情報を保持するために使用されるDATを指定します。

MIDI In CHOP

概要

MIDI In CHOPは、MIDIデバイス、MIDIファイルからノート・イベント、コントローラー・イベント、プログラムチェンジ・イベント、システム・メッセージとタイミング・イベントを読み込みます。
MIDI In Map CHOPも参照してください。
MIDI In CHOPはシリアルポートに接続しているMIDIデバイスからMIDIイベントを受信して、ワークステーション(ビルトイン・ソフトウェア)にMIDIイベントの内容を読み込んで、MIDIファイル中のスコアを解釈します。
サポートするMIDIイベントは以下の通りです:

  • Note On, Note Off
  • Polyphonic Aftertouch
  • Channel Pressure
  • Program Change
  • Control Change(MIDIコントローラ・デバイス)
  • Pitch Wheel
  • ビート・パルスBar Messagesを含むTimer Events
  • Start, Stop, Continue
  • Song Position Pointer
  • System Exclusive Messages

別々のMIDIチャンネルに到達しているMIDIイベントは、別々のCHOPチャンネル上に記録されます。
MIDI CHOPは同じ、或いは異なるソースから見込むことができます。
TouchDesignerはMIDI Start, Stop,またはタイムラインとビート・ダイアログをコントロールするコンティニュー・イベントをコンフィギュレーションすることができます。

Tip:MIDI入力の値は、TouchDesigner .toeファイルに保存され、再ロードされる際に復元されます。
.toeをオープンする際、フィジカル・コントローラが異なるポジションにがあるかもしれません。これにより、コントローラが動かされて、数値がジャンプアップする原因になります。
これは回避することが出来ません。

MIDI In DAT, MIDI Event DAT, MIDI In Map CHOP, MIDI Out CHOP, midiコマンドも参照してください。

パラメータ – Source ページ
Active / active
MIDI Source / source

デバイスまたはファイルからMIDI入力を取得します。

  • Device / device
  • File / file
Device Table / device

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

Device ID / id

使用するデバイスのIDを指定します。

MIDI File / file

MIDIファイルがMIDIソースとして選択されている場合、このフィールドを使用して、読み取るMIDIファイルの名前を指定します。 ファイルは、ディスクまたはWebから読み込むことができます。 URLを指定するときは、http://を使用します。

Read Entire MIDI File / entire

有効にすると、MIDIファイル全体が読み込まれます。 それ以外の場合、ChannelページのStartパラメーターとEndパラメーターによって、読み取るファイルのセグメントが決まります。

Simplified Output / simplified

onの場合、選択したMIDIデバイスからMIDI信号が検出されると、チャンネルが自動的に作成されます。

1 Based Index / onebased

デフォルトの0ベースではなく、インデックス1ベースにします。

MIDI Channels / channel

CHOPは、1〜16の番号の任意の数のMIDIチャンネルから読み取ることができます。 範囲と複数のエントリがサポートされています(つまり、「1 4 6」、「1-7 12」、「1-5:2」)。
Channel Prefixを空白のままにすると、複数のMIDIチャンネルからの入力ストリームが1組のCHOPチャンネルに結合されます(つまり、チャンネル12の「note 64 on」イベントに続くチャンネル8の「note 64 off」イベントは、note 64のCHOPチャンネルに単一の音符として表示されます。)

Channel Prefix / prefix

複数のMIDIチャンネルから録音する場合、このパラメーターに「ch」などの文字列を入力すると、MIDIチャンネルがMIDIチャンネルごとに個別のCHOPチャンネルに分割されます。 それ以外の場合、MIDIチャンネルはすべて1セットのCHOPチャンネルにマージされます。

パラメータ – Record ページ

Simplified Outputがオンの場合、これらのパラメーターは無効になります。

Record Method / recordtype

記録する内容を設定します。

  • Single Frame / single
    これは、ノート、コントローラーなどの現在の値のみを出力します。以前の値は保持しません。 フレーム1で常にCHOPを作成するため、CHOPはMIDIイベントが入った時のみcookが発生します。
  • Current Frame / current
    Single Frame と同じですが、CHOPフレームは常に現在のフレームにあるため、CHOPはすべてのフレームを変更し、他のCHOPがすべてのフレームをリクッキングします。
  • Current Time Slice / ind
    CHOPフレームは常に現在のタイムスライスにあります。
  • Full Length / timeline
    タイムラインの全長が記録されます。
Record / record

このパラメーターは、CHOPチャンネルへのレコーディングを開始および停止するためのボタンとして使用されます。

Reset / reset

CHOPの長さを1サンプルに設定し、チャネルのデータを消去します。

Reset Pulse / resetpulse

リセット パルスを送信します。

パラメータ – Note ページ
Note Name / notename

ここに「n」を入力して、ノートイベントのチャネルを生成します。 これは、ノートのレコーディングに使用されるCHOPチャンネルのベース名です。 空白の場合、noteは無視されます。 Note OutputパラメーターがSeparate Channelsに設定されている場合、CHOPチャンネルは次の形式のNote Scopeのnoteごとに作成されます。

Note Scope / notescope

レコーディングするnoteの範囲。 複数の範囲とノートを記録できます(つまり、「50-60」、「64 65 66 70-80」)。

Note Output / notemeth
  • One Multiplexed Channel / mult
    MIDIチャンネルごとに1つのCHOPチャンネルがすべてのノートに使用されます。 ノートチャンネルの値は、現在再生中のノートの番号です(複数のノートを再生する場合は、最新のノートが選択されます)。
  • Separate Channels / sep
    各ノート番号は、独自のCHOPチャンネルを取得します。
Velocity / velocity
  • Off / veloff
    ベロシティはレコーディングされません。
  • Note Amplitude / velencode
    ベロシティはノートの振幅として記録されます。 Note OutputがSeparate Channelsに設定されている場合にのみ有効です。
  • Separate Channels / velsep
    ベロシティは別のCHOPチャンネルにレコーディングされます。 各ノートチャンネルに、対応するベロシティチャンネルがあります。
Velocity Name / velname

VelocityパラメータがSeparate Channelsに設定されている場合、このパラメーターはベロシティの CHOPチャンネルのベース名です(「v」を試してください)。 空白の場合、ベロシティチャンネルは記録されません。

Aftertouch Name / aftername

ポリフォニックアフタータッチのCHOPチャンネルのベース名。 ノートスコープ内のノートごとに1つのアフタータッチチャンネルが作成されます。 空白の場合、アフタータッチチャンネルは作成されません。

Pressure Name / pressname

チャンネルプレッシャーチャンネルの名前。 複数のチャンネルが記録されている場合、すべてのチャンネルプレッシャーの変化は、このCHOPチャンネルにレコーディングされます。 空白の場合、このチャネルは作成されません。

Normalize / notenorm

便宜上、値を正規化できます。

  • None / off
    ノーマライズがオフの場合、7ビットコントローラーは0〜127の範囲の値を返し、14ビットコントローラーは0〜16383の範囲の値を返します。
  • 0 to 1 / 0to1
    これらの値は、0〜1の範囲に正規化されます。
Pitch Wheel Name / pitchname

ピッチホイールのCHOPチャンネルの名前。 ピッチホイールの値の範囲は-1〜+1です。 空白の場合、このチャネルは作成されません。 ここに「p」を入力して、チャネルを生成します。

パラメータ – Control ページ
Controller Name / controlname

コントロールチェンジCHOPチャンネルのベース名。 チャネル名には、コントローラーインデックス(0-127)が追加されます。 空白の場合、コントロールの変更は記録されません。 通常、「c」が含まれます。

Controller Type / controltype

128の異なるコントローラーが利用可能です。 By Index Onlyを選択すると、Control Indexパラメーターで任意の数のコントローラーを指定できます。 それ以外の場合は、このメニューのリストからコントローラーを選択できます。 サウンドコントローラー1〜10など、一部のコントローラーには複数のインスタンスがあります。 複数のインスタンスを持つコントローラーを選択すると、Control Indexパラメーターを使用して、必要なインスタンスを選択できます。 無効な制御インデックスは無視されます。

  • By Index Only / index
  • Bank Select / n0
  • Modulation Wheel / n1
  • Breath Control / n2
  • Foot Controller / n3
  • Portamento Time / n4
  • Data Entry / n5
  • Channel Volume / n6
  • Balance / n7
  • Pan / n8
  • Expression Control / n9
  • Effect Control 1-2 / n10
  • 14 bit General Purpose 1-4 / n11
  • Sustain on/off / n12
  • Portamento on/off / n13
  • Sustenuto on/off / n14
  • Soft Pedal on/off / n15
  • Legato Footswitch on/off / n16
  • Hold 2 on/off / n17
  • Sound Controller 1-10 / n18
  • 7 bit General Purpose 5-8 / n19
  • Portamento Control / n20
  • Effect Depth 1-5 / n21
  • Non-Registered Parameter / n22
  • Registered Parameter / n23
Controller Index / controlind

番号でコントローラーを選択するか、範囲で複数のコントローラーを選択するために使用します。 By Index Only Controller Typeモードでは、最大128個のコントローラーまたはそのサブ範囲(つまり、1-10、2 34 70、1-32 70-80:2)まで選択できます。

Controller Format / format

一部のコントローラーは、通常の7ビットコントローラー(コントローラーインデックス0〜31、98、100)ではなく、14ビットコントローラーを形成するためにペアリングできます。 14ビットコントローラを選択すると、ペアは1つの14ビットコントローラとして解釈されます。 それ以外の場合、それらは個別の7ビットコントローラとして解釈されます。

  • 7 bit Controllers / 7bit
  • 14 bit Controllers / 14bit
Normalize / norm

コントローラーの値は、便宜上、正規化できます。

  • None / off
    Normalizeパラメータがoffの場合、7ビットコントローラーは0〜127の範囲の値を返し、14ビットコントローラーは0〜16383の範囲の値を返します。
  • 0 to 1 / 0to1
    0〜1の範囲に正規化されます。
  • -1 to 1 / -1to1
    0〜1の範囲に正規化されます。
  • On/Off / onoff

コントローラーのいくつかは、単にオン/オフ状態です。 オン/オフへの変換が有効な場合、64以上の値は「1」と解釈され、64未満の値はすべて「0」と解釈されます。

Unwrap / unwrap
Program Change / progname

Program Change CHOPチャネルの名前。 すべてのプログラム変更メッセージがこのチャンネルに記録されます。 空白の場合、このチャネルは作成されません。

パラメータ – Timer ページ
Timer Pulse Name / pulsename
Timer Ramp Name / rampname
Timer Period / timerperiod
Timer Start / timerstart
Ticks per Beat / ticks
Bar Ramp Name / barname
Bar Period / barperiod
Bar Start / barstart
Bar Message / barmsg
Song Pos Name / songpos
パラメータ – Sys ページ
Channel Name 1 / exname1
Message 1 / exmsg1
パラメータ – Chan ページ

これは、他のジェネレーターのチャンネルページに似ています。 ただし、それらがMidi In CHOPに与える影響については、考慮すべき点がいくつかあります。

Start / start

レコーディングを開始する範囲を指定します。 Tie to Time Line モードでは、開始時刻より前に受信したイベントはすべて無視されます。 Time Line Independent モードでは、レコーディングはこの時点で開始され、継続します(ループバックしません)。 MIDIファイルから読み取る場合、Start / Endは読み取るセグメントの開始を決定します。

Start Unit / startunit
  • I / samples
  • F / frames
  • S / seconds
End / end

MIDIファイルを読み取るためのセグメントの終了点をします。

End Unit / endunit
  • I / samples
  • F / frames
  • S / seconds
Sample Rate / rate

このCHOPのサンプルレートを定義します。 サンプルレートが低すぎると、急速に変化する入力が誤って表示される場合があります。
注:サンプルレートが低すぎると、MIDIイベントを見逃す可能性があります。 ノートイベントはサンプル値を1に設定し、1/30秒未満の次のノートイベントは、CHOPチャンネルの同じサンプルで0に設定できます。 そのため、イベントは見逃されます。 これらのイベントをキャッチするために、600などのサンプルレートを高くするか、OpcodeのMAXで実現できるように、入力されたオン/オフイベントが最小時間間隔であることを確認してください。

Extend Left / left
  • Hold / hold
  • Slope / slope
  • Cycle / cycle
  • Mirror / mirror
  • Default Value / default
Extend Right / right
  • Hold / hold
  • Slope / slope
  • Cycle / cycle
  • Mirror / mirror
  • Default Value / default
Default Value / defval
パラメータ- Common ページ
Time Slice / timeslice

これをオンにすると、チャネルが強制的に「タイムスライス」されます。 タイムスライスは、最後のクックフレームと現在のクックフレームの間の時間です。

Scope / scope

影響を受けるチャネルを特定するために、一部のCHOPでは、Commonページの
でスコープ文字列を使用することができます。

Sample Rate Match / srselect

複数の入力CHOPのサンプルレートが異なる場合を処理方法を設定します。 リサンプリングが発生すると、カーブは補間方法オプションに従って補間されます。補間オプションが使用できない場合はLinearで処理されます。

  • Resample At First Input’s Rate / first
    最初の入力のレートを使用して、他の入力をリサンプリングします。
  • Resample At Maximum Rate / max
    最も高いサンプリングレートでリサンプリングします。
  • Resample At Minimum Rate / min
    最も低いサンプリングレートでリサンプリングします。
  • Error If Rates Differ / err
    競合するサンプルレートは受け入れません。
Export Method / exportmethod

CHOPチャンネルをパラメーターに接続する方法を設定します。 詳細については、Exportの章を参照してください。

  • DAT Table by Index / datindex
    ドッキングされたDATテーブルを使用し、CHOP内のチャンネルのインデックスを介してチャンネルを参照します。
  • DAT Table by Name / datname
    ドッキングされたDATテーブルを使用し、CHOP内のチャネルの名前を介してチャネルを参照します。
Export Root / autoexportroot

Channel Name is Path:パラメータでrelative toを設定することで、エクスポートするすべてのパスのルートノードを指定します。

Export Table / exporttable

DAT Table Export Methodsメソッドを使用するときにエクスポート情報を保持するために使用されるDATを指定します。