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

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

Parameter CHOP の機能を示す図

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

概要 📖 – 他オペレータのパラメータ値をチャンネルとして取得

Parameter CHOPは、他オペレータのパラメータ値をチャンネルとして取得・出力する CHOPです。ワイルドカード指定で複数 OP・複数パラメータを一括取得でき、カスタム/組み込み/シーケンスを自由に組み合わせて束ねられます。

主な用途 🎯

  • 他オペレータの組み込みパラメータ値を CHOP チャンネルとして取得
  • カスタムパラメータの値を一括取得してアニメーション・記録・解析に活用
  • ワイルドカード/パターンマッチで複数 OP・複数パラメータをまとめて束ねる
  • Sequence ブロックの値を multisample チャンネルとして読み出す
  • UI コントロール (Slider COMP 等) の値を後段に渡すブリッジ

データフロー 🔄

入力: 対象 OP のパス (Operators)

Fetch (Parameters / Sequences) 切替

ParGroups / Parameter フィルタ

Custom / Built-In 選択

Name Format 整形

Rename from / Rename to

出力: パラメータ値チャンネル

Tips

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

まる。
まる。

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


パラメータ解説 ⚙️

Source Page 📋

Operators .ops 🎯

値を取得する対象 OP のパス指定 (複数・ワイルドカード対応):

  • Operators パス: チャンネル取得元となる OP の名前またはパス。複数指定可。例: wave1, slider*, constant[1-9], constant[10-19:2], ../base1
  • メニュー選択: テキスト入力の代わりに OP メニューから選択することも可能

Fetch .fetch 🔀

Parameters と Sequences のどちらを取得するか切り替えるメニュー

項目 内部名 説明
Parameters .partypes 通常のパラメータを取得 (ParGroups と Parameter で絞り込み)
Sequences .sequencetypes Sequence を取得 (Sequences で対象選択、ParGroups と Parameter で内部要素を絞り込み)

Sequences .sequences 🔢

対象 Sequence 名のリスト (Pattern Matching 参照):

  • Sequences パターン: 取得したい Sequence 名のリスト (ワイルドカード可)。* で全 Sequence、^ プレフィックスで除外指定
  • 有効条件: Fetch メニューが Sequences の場合のみ有効
  • multisample 化: 選択した Sequence のブロック数が複数ある場合、チャンネルは multisample となり各 index がブロックを表す
  • ブロック長不一致: 複数 Sequence のブロック長が異なる場合、短い側には HOLD モードが適用される

ParGroups .pargroups 🗂️

対象 ParGroup 名のリスト:

  • ParGroups パターン: 取得したい ParGroup 名のリスト (ワイルドカード可)。* で全 ParGroup、^ プレフィックスで除外指定
  • メニュー選択: ParGroup メニューから選択することも可能

Parameter .parameter 🎚️

対象パラメータ名のリスト (Pattern Matching 参照):

  • Parameter パターン: 取得したいパラメータ名のリスト (ワイルドカード可)。* で全パラメータ、^ プレフィックスで除外指定
  • メニュー選択: Parameter メニューから選択することも可能

Custom / Built-In ✅

Custom .custom 🧩
– オン: 対象 OP のカスタムパラメータを出力対象に含める
– カスタム UI コントロール (Slider COMP の Value0 等) を取得する際に使用

Built-In .builtin 🛠️
– オン: 対象 OP の組み込みパラメータを出力対象に含める
– Transform の tx / ty / tz など標準パラメータを取得する際に使用

Name Format .nameformat 🏷️

Multi-Export 用にチャンネル名のフォーマットを切り替えるメニュー

項目 内部名 説明
Parameter Name .parameter チャンネル名にパラメータ名のみを使う
OP and Parameter Names .op チャンネル名に OP 名とパラメータ名の両方を含める (CHOP_Export 形式)

Rename from / Rename to 🔤

Rename from .renamefrom 🔤
– リネーム対象とするチャンネル名のパターンマッチング文字列
Pattern Matching 規約に従う

Rename to .renameto 🔁
– Rename from にマッチしたチャンネルの新しい名前パターン
Pattern Replacement 規約に従う


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: UI スライダーの値を後段に渡す 🎚️

Slider COMP (Value0) → Parameter CHOP → Math CHOP → 出力先 OP のパラメータ
  1. 対象に Slider COMP 等を Operators パラメータで指定
  2. Custom をオンにしてカスタムパラメータ (Value0 等) を取得
  3. Parameter フィルタで Value* 等のワイルドカードを設定
  4. 後段で Math CHOP や Filter CHOP で整形して別 OP の制御に利用

Example 2: 複数 OP の Transform 値を一括取得 📐

geo[1-10] → Parameter CHOP (Built-In, Parameter=t*) → CHOP to DAT
  1. Operators に geo[1-10] のようなパターンを設定
  2. Built-In をオンにして組み込みパラメータを対象化
  3. Parameter フィルタを t* にして tx / ty / tz を取得
  4. Name Format を OP and Parameter Names にしてチャンネル名で OP を区別

Example 3: Sequenceブロックをmultisampleで読出 🎼

Animation COMP (Sequence) → Parameter CHOP (Fetch=Sequences) → Trail CHOP
  1. Fetch メニューを Sequences に切替
  2. Sequences パラメータで対象 Sequence 名を指定 (例: animations)
  3. ParGroups / Parameter で Sequence 内の要素を絞り込み
  4. 出力 multisample チャンネルを Trail CHOP で可視化

Example 4: パラメータ値の記録とリプレイ 💾

対象 OP → Parameter CHOP → Record CHOP → File Out CHOP
  1. Parameter CHOP で操作 UI 群の値を一括取得
  2. Record CHOP に流して時間軸でログ化
  3. File Out CHOP で .chan 等のファイルに書き出し
  4. 後日 File In CHOP で読み戻して再生する

関連オペレータ 🔗

類似機能OP 🔍

  • Constant CHOP — 固定値チャンネルの生成 (動的取得ではなく手動指定)

組み合わせ推奨OP 🔄

  • Math CHOP — 取得したパラメータ値を後段で正規化・演算
  • CHOP to DAT — 取得値をテーブル化してロギングや UI 表示
  • Trail CHOP — 値の時間履歴を可視化
  • Record CHOP — パラメータ値の時間軸キャプチャ
  • Filter CHOP — 取得値のジッタ低減・スムージング

前処理・後処理CHOP 🎯


Info CHOP情報 📊

Parameter 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: 対象パラメータがチャンネルに現れない
✅ Solution:

  • Custom と Built-In のいずれか (または両方) がオンになっているか確認
  • Parameter / ParGroups のパターンマッチで対象パラメータ名がヒットしているか * で全件出して確認
  • Operators パラメータのパスが正しい OP を指しているか、メニューから再選択して確認

❌ Problem: Sequence の値が期待どおりに取れない
✅ Solution:

  • Fetch メニューが Sequences に切り替わっているか確認 (Parameters のままだと Sequence は無視)
  • Sequences パラメータで対象の Sequence 名がパターンに含まれているか確認
  • ブロック長が異なる複数 Sequence を選んでいる場合は短い側に HOLD モードが適用される点に注意

❌ Problem: 複数 OP 取得時にチャンネル名が衝突する
✅ Solution:

  • Name Format を OP and Parameter Names に切替えて OP 名をチャンネル名に含める
  • Rename from / Rename to で衝突するチャンネルを個別にリネーム
  • 後段に Rename CHOP を追加して命名規約を統一

❌ Problem: 値の更新がフレーム遅延する / ポップする
✅ Solution:

  • Time Slice モードを有効化し、最新クックフレームの値を取得する
  • 後段に Filter CHOP を入れて滑らかに繋ぐ
  • 更新頻度の低いパラメータは Sample Rate Match で揃え方を明示する

参考資料 📚

その他 🔗

公式リソース 📖

この記事は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をコピーしました