PosiStageNet CHOP 完全ガイド | 使い方・パラメータ解説【TouchDesigner】

※当サイトにはプロモーションリンクが含まれます。

PosiStageNet CHOP のトラッキングデータ受信機能を示す図

記事更新の通知はXでアナウンス٩(๑❛ᴗ❛๑)
→ @maru6o6をフォロー

概要 📖 – PosiStageNet トラッキングデータ受信

PosiStageNet CHOPは、PosiStageNet プロトコル経由で舞台用トラッキングシステムから位置・向き・速度などのデータを受信しチャンネル化する CHOPです。舞台演出機器との連携を前提とした業界標準プロトコル PosiStageNet に対応し、パフォーマーや小道具のリアルタイム位置情報をビジュアル制御に取り込みます。

主な用途 🎯

  • PosiStageNet (PSN) プロトコル対応の舞台用トラッキングシステムからの位置データ受信
  • ムービングライト・自動演出システムからのパフォーマー / オブジェクト位置取得
  • 舞台演出における人物・小道具のリアルタイムトラッキング情報の TouchDesigner 連携
  • プロジェクションマッピングのターゲット追従 (オブジェクト位置に投影内容を追従)
  • 向き・速度・加速度・目標位置の受信によるダイナミックなビジュアル演出制御

データフロー 🔄

入力: ネットワーク UDP パケット (PosiStageNet プロトコル)
 ↓
Network Address / Port 受信
 ↓
Sample Rate でサンプリング
 ↓
Position / Orientation / Speed / Acceleration / Target Position チャンネル選択
 ↓
出力: トラッキングデータチャンネル

Tips

初心者の方は、以下日本語書籍も手元にあると安心です。

まる。
まる。

実際の案件事例まで踏み込んで紹介されていて、効率よくスキルアップするなら必携の二冊です！

パラメータ解説 ⚙️

Setup Page 📋

Active .active 🟢

PosiStageNet データ受信の有効化:

  • オン: PosiStageNet サーバー / デバイス / ソフトウェアからのデータを受信し続ける
  • オフ: 受信を停止する (この間に到着したデータは破棄される)

Network Address .netaddress 🏷️

送信元 PosiStageNet エンドポイントのアドレス:

  • Network Address: PosiStageNet サーバー / デバイス / ソフトウェアのネットワークアドレス (例: 236.10.10.10 のマルチキャストアドレス)

Port .port 🔌

PosiStageNet 通信ポート (デフォルト 56565):

  • Port: デフォルトでは TCP Port 56565 を使用。PosiStageNet CHOP が正しく通信できるようファイアウォール設定の調整が必要な場合あり

Sample Rate .samplerate 🎚️

入力データのサンプリングレート:

  • Sample Rate: 受信したデータをサンプリングするレート (Hz)

Position .pos 📍

位置チャンネルの出力有無:

  • オン: 位置 (Position) チャンネルを出力に含める
  • オフ: 位置チャンネルを出力に含めない

Orientation .ori 🧭

向きチャンネル (オイラー角) の出力有無:

  • オン: 向きをオイラー角 (Euler angles) チャンネルとして出力に含める
  • オフ: 向きチャンネルを出力に含めない

Speed .speed 💨

速度チャンネルの出力有無:

  • オン: 速度 (Speed) チャンネルを出力に含める
  • オフ: 速度チャンネルを出力に含めない

Acceleration .accel 📈

加速度チャンネルの出力有無:

  • オン: 加速度 (Acceleration) チャンネルを出力に含める
  • オフ: 加速度チャンネルを出力に含めない

Target Position .targetpos 🎯

目標位置チャンネルの出力有無:

  • オン: 目標位置 (Target Position) をチャンネルとして出力に含める
  • オフ: 目標位置チャンネルを出力に含めない

Reset Pulse .resetpulse 💥

全チャンネルの即時リセット:

  • Reset Pulse: 押した瞬間に全データチャンネルをクリアする。トラッキングされていないデータが残っている場合はそれらを除去できる

Common Page 🔧

Time Slice .timeslice ⏱️

Time Slice モードの強制設定:

  • オン: チャンネルを「タイムスライス」モードに強制
  • タイムスライス: 前回のクックフレームから現在のクックフレームまでの時間

Scope .scope 🎯

影響を受けるチャンネルの絞り込み:

  • Scope 文字列: 影響を受けるチャンネルを指定する文字列
  • パターンマッチング: * や [1-10] 等のパターンが使用可能

Sample Rate Match .srselect ⚡

複数の入力 CHOP のサンプルレートが異なる場合の処理方法

項目 内部名 説明
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 チャンネルをパラメータに接続する方法

項目 内部名 説明
DAT Table by Index .datindex DAT テーブルのインデックスでチャンネルとパラメータを対応付け
DAT Table by Name .datname DAT テーブルの行名でチャンネルとパラメータを対応付け
Channel Name is Path:Parameter .autoname チャンネル名を `path:parameter` 形式で記述し直接対応付け

Export Root .autoexportroot 🌳

Channel Name is Path:Parameter モード時のパス基点:

  • Export Root パス: autoname モードでチャンネル名のパス部分を相対化する基点 OP のパス

Export Table .exporttable 📋

DAT Table エクスポート方式での参照 DAT:

  • Export Table DAT: datindex / datname モード時に参照する DAT のパス

Rename from .commonrenamefrom 🔤

リネーム対象チャンネルのパターン:

  • Rename from パターン: リネーム対象とするチャンネル名のパターンマッチング文字列

Rename to .commonrenameto 🔁

リネーム後の置換パターン:

  • Rename to パターン: Rename from にマッチしたチャンネルの新しい名前パターン (デフォルトはリネームなし)

実践アイデア 💡

Example 1: ムービングライトとの位置同期演出 💡

PosiStageNet 対応ライティングコンソール → LAN (Multi-Cast) → PosiStageNet CHOP → ライト位置追従ビジュアル
  1. PosiStageNet 対応ライティングコンソール (grandMA / Hog 等) を同一サブネットに接続
  2. PosiStageNet CHOP の Network Address にコンソール出力先 (例: 236.10.10.10)、Port を 56565 に設定し Active をオン
  3. Position をオンにして受信した X / Y / Z 座標をビジュアル要素の位置パラメータに Export
  4. ムービングライトの動きとビジュアル要素の位置が舞台上で完全に同期

Example 2: パフォーマーへのリアルタイム投影追従 🎭

舞台トラッキングシステム → PosiStageNet → PosiStageNet CHOP → プロジェクションマッピング
  1. 舞台用トラッキングシステム (BlackTrax / ZACTrack 等) でパフォーマーに装着したトラッカーを認識
  2. PosiStageNet CHOP で Position + Target Position をオンにし、トラッキング結果を受信
  3. 後段に Math CHOP を挟みステージ座標系からプロジェクタ座標系へ変換
  4. パフォーマーが舞台上を動いても投影内容が常に追従するインスタレーションを構築

Example 3: 速度・加速度連動のダイナミックエフェクト ⚡

PosiStageNet CHOP (Speed/Accel) → Filter CHOP → ビジュアルエフェクト強度
  1. PosiStageNet CHOP の Speed と Acceleration をオンにし、動きの速さ・加速の情報を取得
  2. 後段に Filter CHOP を挟みノイズをスムージング
  3. 速度値をパーティクルの放出量、加速度値をブラー強度などにマッピング
  4. パフォーマーの動きの激しさに応じてエフェクト強度が変化する演出を実現

Example 4: 向き情報による 3D オブジェクト姿勢制御 🎮

PosiStageNet CHOP (Orientation) → CHOP to → 3D シーン Geometry
  1. PosiStageNet CHOP の Orientation をオンにし、ロール / ピッチ / ヨーのオイラー角を受信
  2. 受信した向きチャンネルを 3D オブジェクトの回転パラメータに Export
  3. Reset Pulse を演出区切りで発火させ、トラッキングデータの取りこぼしを除去
  4. 舞台上の小道具の向きと連動する仮想 3D オブジェクトをリアルタイム描画

関連オペレータ 🔗

類似機能OP 🔍

  • OSC In CHOP — 汎用的な OSC プロトコル経由の受信、PosiStageNet は舞台機器特化プロトコル
  • MIDI In CHOP — MIDI 規格でコントローラ入力を受信 (PosiStageNet は IP ネットワーク経由のトラッキング)
  • Serial CHOP — シリアル通信で外部デバイスからデータを受信 (PosiStageNet は IP ネットワーク経由)

組み合わせ推奨OP 🔄

  • Math CHOP — 舞台座標系から TouchDesigner 座標系への変換 (スケール・オフセット)
  • Filter CHOP — トラッキングノイズのスムージング
  • Lag CHOP — 値変化を滑らかに減衰させ自然な追従感を演出
  • Select CHOP — 受信した複数トラッカーチャンネルから必要なものだけ抽出
  • Trigger CHOP — 速度・加速度の閾値超えをきっかけにエフェクトを発火

前処理・後処理CHOP 🎯

Info CHOP情報 📊

PosiStageNet CHOPは Info CHOP による詳細情報取得に対応しています。

CHOP固有情報 🎚️

  • start: CHOPインターバルの開始（サンプル単位）
  • length: CHOPのサンプル数
  • sample_rate: フレーム毎秒のサンプルレート
  • num_channels: CHOPのチャンネル数
  • time_slice: タイムスライス有効時は1、無効時は0
  • export_sernum: Export接続の更新回数

汎用オペレータ情報 🔄

  • total_cooks: プロセス開始からのクック回数
  • cook_time: 最後のクック時間（ミリ秒）
  • cook_frame: 最後にクックされたフレーム番号
  • warnings: 警告数
  • errors: エラー数

トラブルシューティング ⚠️

よくある問題と解決策 🔧

❌ Problem: PosiStageNet データが受信できない
✅ Solution:

  • Active がオンになっているか確認
  • Network Address が送信元 PosiStageNet サーバーのアドレスと一致しているか確認
  • Port がデフォルトの 56565 から変更されていないか、送信側と一致しているか確認
  • ファイアウォール / セキュリティソフトが PosiStageNet CHOP の通信を許可しているか確認

❌ Problem: 受信値がノイズだらけ・カクつく
✅ Solution:

  • 後段に Filter CHOP を挟みスムージング処理を加える
  • Sample Rate を送信側の更新レートに合わせて再設定
  • Lag CHOP で変化を滑らかに減衰させて自然な追従感を出す

❌ Problem: トラッキングされていないデータが残る
✅ Solution:

  • Reset Pulse を押して全データチャンネルをクリアする
  • 演出区切りやシーン切替のタイミングで Reset Pulse をトリガーする運用を組む
  • Select CHOP で必要なトラッカーのチャンネルだけ後段に通す

❌ Problem: 向き情報が想定外の挙動になる
✅ Solution:

  • Orientation はオイラー角 (Euler angles) として出力されるため、軸の順序を 3D シーン側と一致させる
  • 後段に Math CHOP を挟み角度の符号反転・オフセット調整
  • ロール / ピッチ / ヨーのチャンネル割当を 3D オブジェクトの回転パラメータと対応付け

参考資料 📚

その他 🔗

公式リソース 📖

この記事はLLMと共に内容を執筆、更新しています。
最新バージョンとの項目差異など、情報の不一致を見つけた心優しい方はXもしくはInsta、メールなどよりサイト管理者までご連絡ください😎


まる。

お仕事のご依頼はDM又はメールにて。
━━━━━━━━━━━━━━━━━
Python/Touchdesigner/M5Stackをこよなく愛すフルスタックエンジニア。
専門は生理心理学、趣味はヨガやサウナ、EMS電気風呂などヘルスケア全般。
脳波や筋電、心拍を中心とした生体情報のセンシング＆インタラクティブアートづくりがライフワーク。

普段はワントゥーテンという会社で空間演出エンジニアをしています。
リファラル採用お繋ぎできますので、我こそはという尖った方は経歴と希望職種添えてDMください(エンジニア以外、営業職等もOK)。
ご飯行きましょう。

↓日常垢
Instagram：＠malmal0v0

まる。をフォローする
その他の記事はこちら
Math Combine POP 完全ガイド | 使い方・パラメータ解説【TouchDesigner】
ZED Select TOP 完全ガイド | 使い方・パラメータ解説【TouchDesigner】
ZED POP 完全ガイド | 使い方・パラメータ解説【TouchDesigner】
Window COMP 完全ガイド | 使い方・パラメータ解説【TouchDesigner】
Widget COMP 完全ガイド | 使い方・パラメータ解説【TouchDesigner】

タイトルとURLをコピーしました