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 ページ