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

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

DMX In CHOP の信号受信機能を示す図

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

概要 📖 – DMX/Art-Net/sACN/KiNET 信号の受信

DMX In CHOPは、DMX512 / Art-Net / sACN / KiNET プロトコル経由で外部から DMX 信号を受信し、チャンネル値を CHOP として出力する CHOPです。Enttec USB Pro 系シリアルインターフェイスとネットワーク経由（Art-Net / sACN / KiNET）の両方に対応し、照明制御・舞台演出などのリアルタイム入力経路として機能します。

主な用途 🎯

  • DMX512 信号の受信とチャンネル値取得（照明卓・コンソールからの信号入力）
  • Art-Net プロトコル経由でのネットワーク DMX 受信（Net / Subnet / Universe 単位で識別）
  • sACN (E1.31) プロトコルの受信（マルチキャスト対応・劇場照明環境向け）
  • KiNET プロトコルの受信（Color Kinetics 系 LED 機器との連携）
  • Enttec USB Pro 系インターフェイスからの DMX 入力（シリアル経由での DMX 受信）

データフロー 🔄

入力: DMX/Art-Net/sACN/KiNET パケット
 ↓
インターフェイス選択（Enttec / Art-Net / sACN / KiNET）
 ↓
Format で受信モード切替（Timesliced / Latest / All）
 ↓
Filter Table で受信ユニバース絞り込み
 ↓
Rate でリサンプル
 ↓
出力: DMX チャンネル値（0-255 の整数）

Tips

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

まる。
まる。

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

パラメータ解説 ⚙️

Port Page 📋

Active .active 🔌

デバイスへの接続オン・オフ:

  • Active: オンにすると DMX デバイスへの接続を確立し、信号の受信を開始する

Interface .interface 🎛️

DMX デバイスとの接続インターフェイスを選択するメニュー

項目 内部名 説明
Enttec Generic Serial .serial OS のシリアル API 経由でデータを読み取る汎用シリアル方式
Enttec USB Pro .enttecusbpro Enttec USB Pro インターフェイス専用の接続モード
Enttec USB Pro Mk2 .enttecusbpromk2 Enttec USB Pro Mk2 インターフェイス専用の接続モード
Art-Net .artnet Art-Net プロトコル（UDP ネットワーク経由）に切替
sACN .sacn sACN (E1.31) プロトコルに切替
KiNET .kinet KiNET プロトコル（Color Kinetics 系）に切替

KiNET Version .kinetversion 🔢

使用する KiNET プロトコルのバージョン

項目 内部名 説明
DmxOut (v1) .v1 KiNET プロトコル v1（DmxOut 形式）
PortOut (v2) .v2 KiNET プロトコル v2（PortOut 形式）

Device .device 🎚️

接続する DMX デバイスの選択:

  • Device: メニューから DMX デバイスを選択（Interface 設定に応じて選択肢が変化）

Serial Port .serialport 🔗

Generic Serial 使用時のシリアル(COM)ポート選択:

  • Serial Port: Interface が Generic Serial のときに使用するシリアル(COM)ポートを選択

Format .format 📦

Art-Net / sACN 受信時のパケット処理モードメニュー

項目 内部名 説明
Packet Per Sample (Timesliced) .packetpersample タイムスライス対応：1 パケットを 1 サンプルとして時系列に並べる受信モード
Packet Per Channel (Latest) .packetperchan 最終クック以降に届いたパケットのみ反映、それ以外は破棄（最新値優先）
Packet Per Channel (All) .packetperchanall ドロップフレームでスキップされ得るパケットも全て追加チャンネルとして取り込む

Art-Net Net (0-127) .net 🌐

Art-Net Net アドレス設定:

  • Art-Net Net (0-127): Interface が Art-Net のときに設定する Net アドレス（範囲 0-127、IP アドレスとは別概念）

Art-Net Subnet (0-15) .subnet 🌐

Art-Net Subnet アドレス設定:

  • Art-Net Subnet (0-15): Interface が Art-Net のときに設定する Subnet アドレス（範囲 0-15、ネットワークサブネットマスクとは別概念）

Art-Net Universe (0-15) .universe 🌐

Art-Net Universe アドレス設定:

  • Art-Net Universe (0-15): Interface が Art-Net のときに設定する Universe アドレス（範囲 0-15）。1 ユニバース = 512 チャンネルの DMX フレーム

Filter Table .filterdat 📋

Packet Per Channel モード（Art-Net / sACN）でドック Table DAT を使い受信する net / subnet / universe チャンネルを指定する

Filter Table .filterdat
– Art-Net / sACN を Packet Per Channel Format で受信するときに使用
– ドックされた Table DAT で「どの net / subnet / universe を受信するか」を行ごとに記述
– sACN の場合、universe 0 はシステム予約のため最初の利用可能 universe は index 1

Net Name .netname 🔤

Net 部分のチャンネル名 prefix:

  • Net Name: アドレスの net 部分に付与するチャンネル名 prefix を指定

Subnet Name .subnetname 🔤

Subnet 部分のチャンネル名 prefix:

  • Subnet Name: アドレスの subnet 部分に付与するチャンネル名 prefix を指定

Universe Name .universename 🔤

Universe 部分のチャンネル名 prefix:

  • Universe Name: アドレスの universe 部分に付与するチャンネル名 prefix を指定

KiNET Port Name .kinetportname 🔤

KiNET Port 部分のチャンネル名 prefix:

  • KiNET Port Name: KiNET アドレスの port 部分に付与するチャンネル名 prefix を指定

Start Codes .startcodes 🎫

sACN 使用時に受け入れる start code のリスト

Start Codes .startcodes
sACN モード時に受信を許可する start code をリスト指定。リストに無い start code を持つ sACN パケットは破棄される

Multicast .multicast 📡

sACN マルチキャスト受信の有効化

Multicast .multicast
– sACN のマルチキャスト受信を有効化
– Net / Subnet / Universe 設定から自動的にマルチキャスト IP を構築
– 送信側のアドレスを知らなくても DMX In CHOP が自動的に受信できる

Queue Size .queuesize 📥

Art-Net / sACN 受信時のパケットキューサイズ

Queue Size .queuesize
– Interface が Art-Net または sACN のときの受信パケットキューサイズ
– 大きくするとデータがスムーズになるが遅延（latency）も増加
– Packet Per Channel (All) モードでは 1 クックあたりに生成される最大パケット数を制御

Rate .rate ⚡

受信データのリサンプルレート設定:

  • Rate: 受信した DMX データを指定したレート（Hz）にリサンプル

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: Art-Net 経由で照明卓からの DMX を受信 🎭

照明卓 (Art-Net 送信) → DMX In CHOP (Interface=Art-Net) → Select CHOP → ライト制御

ネットワーク経由で照明卓から送られる Art-Net パケットを TouchDesigner 側で受信し、舞台照明の状態をビジュアル系統に取り込む基本パターン。

  1. DMX In CHOP の Interface を Art-Net に設定
  2. Art-Net Net / Subnet / Universe を照明卓の送信設定に合わせる
  3. Active をオンにして受信を開始
  4. Select CHOP で必要なチャンネル（dimmer / pan / tilt 等）だけを抽出し下流処理に渡す

Example 2: Enttec USB Pro で DMX 信号をシリアル受信 🔌

DMX 卓 → Enttec USB Pro (USB) → DMX In CHOP (Interface=Enttec USB Pro) → 出力チャンネル

Enttec USB Pro インターフェイスを介して、シリアル接続で DMX512 信号を受信するセットアップ。スタンドアロン環境でネットワーク非依存に DMX を取り込みたい場合に有効。

  1. Enttec USB Pro を PC に USB 接続
  2. DMX In CHOP の Interface を Enttec USB Pro に設定
  3. Device メニューから対象の Enttec デバイスを選択
  4. Active をオンにし、512 チャンネルの DMX 値が CHOP として取り込まれることを確認

Example 3: sACNで複数universeを受信 📡

sACN sender (Multicast) → DMX In CHOP (Interface=sACN, Format=Packet Per Channel, Filter Table) → 後段処理

大規模舞台で複数ユニバースを送出する sACN 環境において、必要な universe のみを Filter Table で選別して取り込み、後段の照明・映像演出に分配するパターン。

  1. DMX In CHOP の Interface を sACN、Format を Packet Per Channel (Latest) に設定
  2. Multicast をオンにし、送信側 IP を意識せず受信できる構成にする
  3. ドック Table DAT に受信したい net / subnet / universe を行ごとに記述し Filter Table に指定
  4. 受信したチャンネル群を Select CHOP で機材ごとに分岐して下流に渡す

関連オペレータ 🔗

類似機能OP 🔍

  • OSC In CHOP — OSC プロトコルでネットワーク経由のリアルタイム数値を受信
  • MIDI In CHOP — MIDI ノート / CC / clock を受信、DMX とは別プロトコル
  • Serial CHOP — 汎用シリアル通信、DMX 以外のシリアル機器との連携に

組み合わせ推奨OP 🔄

  • Select CHOP — 受信した 512 チャンネルから必要なチャンネルだけを抽出
  • Math CHOP — DMX 値（0-255）を 0-1 に正規化して下流に渡す
  • Filter CHOP — DMX 入力のフリッカー・ノイズを時間方向にスムージング
  • DMX Out CHOP — DMX In で受けた信号を加工して別ユニバースへ送信（リレー・変換用途）
  • Trigger CHOP — DMX チャンネルが閾値を超えたタイミングでイベント発火

前処理・後処理CHOP 🎯

Info CHOP情報 📊

DMX In 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: Active をオンにしても DMX 値が届かない
✅ Solution:

  • Interface 設定が送信側と一致しているか確認（Art-Net / sACN / Enttec）
  • Art-Net の場合 Net / Subnet / Universe が送信側と一致しているか確認
  • ファイアウォール / アンチウイルスが UDP ポート（Art-Net: 6454, sACN: 5568）をブロックしていないか確認
  • 前段に Null CHOP を挟んで信号観測ポイントを作る

❌ Problem: sACN マルチキャストで受信できない
✅ Solution:

  • Multicast をオンにしているか確認（オフだとユニキャスト送信元の指定が必要）
  • ネットワークアダプタが IGMP マルチキャストを許可しているか確認
  • sACN は universe 0 がシステム予約のため、最初の利用可能 universe は index 1 から始まる点に注意
  • Start Codes リストに送信側の start code が含まれているか確認

❌ Problem: Art-Net で大量パケットを受信するとフレーム落ちが発生
✅ Solution:

  • Format を Packet Per Channel (All) にすると、ドロップされるパケットを追加チャンネルとして取り込める
  • Queue Size を増やしてパケットバッファに余裕を持たせる（遅延は増加）
  • Filter Table で受信する universe を必要最小限に絞り込む
  • 後段に Filter CHOP を入れて時間方向のスムージングで欠落を補う

❌ Problem: Enttec USB Pro が Device メニューに出てこない
✅ Solution:

  • Enttec の USB ドライバ（FTDI 系）が OS にインストールされているか確認
  • USB ケーブル / ポートを変えて再接続を試す（給電不足の場合あり）
  • 他のソフトウェア（DMX 制御アプリ等）が同じデバイスを掴んでいないか確認、掴んでいれば終了
  • Interface を Enttec USB Pro ではなく Enttec USB Pro Mk2 に切り替えて試す（Mk2 機種の場合）

参考資料 📚

その他 🔗

公式リソース 📖

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