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

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

Video Device In TOP の映像取り込み機能を示すサムネイル

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

概要 📖 – カメラ・キャプチャ映像の取り込み

Video Device In TOPは、カメラやキャプチャカードなどの映像入力デバイスからライブ映像をテクスチャとして取り込む TOPです。Driver で DirectShow / Media Foundation / Blackmagic 等のライブラリを選び、Signal Format で解像度とフレームレートを指定します。色空間や転送方式も細かく制御できます。

主な用途 🎯

  • Webカメラ・USBカメラのライブ映像取り込み
  • キャプチャカード経由の SDI / HDMI 映像入力 (Blackmagic / AJA / DataPath 等)
  • プロジェクションマッピング・VJ でのリアルタイムカメラソース
  • インタラクティブインスタレーションでの来場者映像の取り込み
  • SDR / HDR 色空間を指定した放送品質入力の取り込み

データフロー 🔄

入力: カメラ・キャプチャカード (物理デバイス)
 ↓
Driver / Device でデバイスを選択
 ↓
Signal Format で解像度・フレームレートを指定
 ↓
Input Color Space で作業色空間へ変換
 ↓
出力: テクスチャ (TOP)

Tips

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

まる。
まる。

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

パラメータ解説 ⚙️

Video In Page 📹

Driver .driver 🔌

Driver (ドライバ) — カメラとやり取りするために使用するライブラリ。お使いのデバイスに合ったものを選択します。

項目 内部名 説明
DirectShow (WDM) .directshow Windows 標準の WDM ベースキャプチャ (Webカメラ汎用)
Media Foundation .mediafoundation Windows の新しいメディアフレームワーク
Imaging Source – Not Supported .imagingsource The Imaging Source 製カメラ (現在は非サポート)
DataPath (RGBEASY) .datapath DataPath 製キャプチャカード
Blackmagic .blackmagic Blackmagic Design 製キャプチャカード (DeckLink 等)
Allied Vision (GigE) .alliedvisiongige Allied Vision 製 GigE カメラ
Imaging Development Systems (IDS) .ids IDS 製産業用カメラ
FLIR / Point Grey (FlyCapture2) .pointgreyflycapture FLIR / Point Grey 製カメラ (FlyCapture2 SDK)
FLIR / Point Grey (Spinnaker) .flirspinnaker FLIR / Point Grey 製カメラ (Spinnaker SDK)
AVFoundation (macOS) .avfoundation macOS 標準のメディアフレームワーク
BlueFish444 .bluefish444 BlueFish444 製キャプチャカード
AJA .aja AJA 製キャプチャカード
Ximea .ximea XIMEA 製産業用カメラ
Deltacast .deltacast Deltacast 製キャプチャカード

デバイス選択パラメータ 🎚️

Active .active 🟢
Active (有効化) — 1 にするとカメラやデコーダからの映像ストリームを取り込みます。

Device .device 📷
Device (デバイス) — このメニューから取り込みたいカメラまたはデコーダを選択します。

Specify IP .specifyip 🌐
Specify IP (IP 指定) — Allied Vision ライブラリ使用時にカメラのアドレスを IP で指定できるようにします。

IP .ip 🔢
IP (IP アドレス) — 上記 Specify IP がオンのときに使用する IP アドレス。

Options .options ⚙️
Options (オプション) — カメラのオプションやコントロールパネルを開きます。

Deinterlace .deinterlace 🎞️

Deinterlace (デインターレース) — 表示するフィールドの選択。インターレース映像を扱う際の処理方式を指定します。

項目 内部名 説明
Off .off デインターレースせずフレーム全体を 1 枚の画像として表示
Even .even 偶数フィールドのみ表示 (2・4・6 行目…)
Odd .odd 奇数フィールドのみ表示 (1・3・5 行目…)
Bob (Split) .bob 偶数・奇数フィールドを交互に表示しフレームレートを 2 倍化、インターレースアーティファクトを除去

Field Precedence .precedence 🔀

Field Precedence (フィールド優先順位) — Bob (Split) デインターレース時に各フレームでどちらのフィールドを先に表示するかを選択します。

項目 内部名 説明
Even .even 偶数行 (2・4・6…) を先に、次に奇数行を表示
Odd .odd 奇数行 (1・3・5…) を先に、次に偶数行を表示

信号・チャンネル設定 📡

TV Channel .channel 📺
TV Channel (TV チャンネル) — TV チューナを映像入力として使う場合のチャンネル選択。

Signal Format .signalformat 📐
Signal Format (信号フォーマット) — 取り込む信号の解像度・フレームレート・プログレッシブ/インターレースの別を指定。インターレースフォーマット使用時のレートは毎秒フィールド数を指します。

Quad Link .quadlink 🔗
Quad Link (クアッドリンク) — クアッドリンクフォーマット対応カードで使用。4 系統の入力 (例: 4 つの 1080p) を 1 つの大きな入力 (4K) として結合します。

Input Pixel Format .inputpixelformat 🎨

Input Pixel Format (入力ピクセルフォーマット) — 8 ビット以外のピクセルフォーマットをサポートするキャプチャデバイス (Blackmagic Design 等) でその精度を使うかどうか。

項目 内部名 説明
8-bit .fixed8 チャンネルあたり 8 ビット精度
10-bit .fixed10 チャンネルあたり 10 ビット精度。テクスチャは RGB10A2 に設定される
16-bit .fixed16 チャンネルあたり 16 ビット精度。テクスチャは RGBA16-Fixed に設定される
12-bit .fixed12 チャンネルあたり 12 ビット精度

Input Color Space .inputcolorspace 🌈

Input Color Space (入力色空間) — 入力データをどの色空間として扱うか。GPU へアップロードする際に作業色空間へ変換されます。

項目 内部名 説明
Automatic .automatic 入力の色空間メタデータから自動判定 (不明な場合は sRGB とみなす)
sRGB .srgb sRGB 色空間 (SDR、sRGB 伝達関数)
sRGB – Linear .srgblinear sRGB 色空間・リニア伝達関数 (SDR)
Rec.601 (NTSC) .rec601ntsc Rec.601 NTSC 原色 (SDR、放送 SD 規格)
Rec.709 .rec709 Rec.709 色空間 (SDR、HDTV 規格)
Rec.2020 .rec2020 Rec.2020 色空間 (HDR、UHD 規格)
Rec.2020 ST2084PQ .rec2020st2084pq Rec.2020・PQ 伝達関数 (HDR、HDR10 系)
Rec.2020 HLG .rec2020hlg Rec.2020・HLG 伝達関数 (HDR、放送 HDR)
DCI-P3 .dcip3 DCI-P3・D65 白色点・2.6 ガンマ (HDR、デジタルシネマ)
DCI-P3 (D60) .dcip3d60 DCI-P3 D60 sim・D60 白色点 (HDR)
Display-P3 (D65) .displayp3d65 Display-P3・D65 白色点・sRGB ガンマ (HDR、Apple 系ディスプレイ)
Display-P3 (D65) – Linear .displayp3d65linear Display-P3・D65 白色点・リニア伝達関数 (HDR)
ACES2065-1 .aces2065-1 ACES 2065-1 (AP0)・リニアガンマ (HDR、映画製作交換用)
ACEScg .acescg ACEScg (AP1)・リニアガンマ (HDR、CG 合成作業用)
ACESproxy .acesproxy ACESproxy・対数伝達関数 (HDR)
Passthrough .passthrough 色値を変換せずそのまま使用 (作業色空間への変換なし)

Input Reference White .inputreferencewhite ⚪

Input Reference White (入力リファレンスホワイト) — 入力色を作業色空間へ変換する際、基準白色 (明るさ) をどう扱うかを制御します。

項目 内部名 説明
Default For Color Space .default 検出・選択された色空間に応じて SDR か HDR の基準白色を自動使用
Standard (SDR) .sdr 入力色空間を SDR の基準白色として扱う
High (HDR) .hdr 入力色空間を HDR の基準白色として扱う

Transfer Mode .transfermode 🔁

Transfer Mode (転送モード) — 入力デバイスから CPU メモリへ、さらに CPU メモリから GPU へフレームをどう転送するかを制御します。

項目 内部名 説明
Automatic .automatic 搭載コンポーネントに応じ最適な転送モードを自動選択 (通常は Pre-Upload)
Pre-Upload .preupload フレーム到着と同時に GPU へアップロード。処理時にデータが既に GPU メモリ上にある
On-Demand .ondemand そのクックで表示する場合のみ GPU へアップロード。表示フレームが少ない場合 PCIe 帯域を節約するが GPU が待つことがある
On-Demand, Sync to Frame Input .ondemandsync AJA デバイス専用。フレーム到着直後までプロセス全体を停止し入力遅延を除去するが性能は低下しうる

Memory Mode .memorymode 💾

Memory Mode (メモリモード) — キャプチャカードと GPU の間でデータ転送に使うメモリ種別を制御します。

項目 内部名 説明
Automatic .automatic 転送に最適なメモリモードを自動選択 (対応カードは Pinned、非対応は Regular)
Pinned .pinned ピンメモリで 3 回ではなく 2 回のコピーで転送 (高速)
Regular .regular 通常メモリで 3 回のコピーが必要

同期・統計パラメータ ⏱️

Sync Inputs .syncinputs 🔗
Sync Inputs (入力同期) — 複数の Video Device In TOP の同期を有効化。単一システム上で複数の入力・キャプチャカードを使う際にフレーム出力を揃えます。

Sync Group Index .syncgroupindex 🔢
Sync Group Index (同期グループインデックス) — 1 つの .toe ファイル内に複数の同期グループを持てます。ノードは同じ同期グループに属するノードとのみ同期します。

Max Sync Offset (ms) .maxsyncoffset 📊
Max Sync Offset (最大同期オフセット、ミリ秒) — 2 枚の画像が「同期している」とみなされる到着時刻の最大差。この差を超える画像は別フレーム扱いになります。

Sync Timeout (ms) .synctimeout ⏳
Sync Timeout (同期タイムアウト、ミリ秒) — 同期グループの全フレームが揃うまで待つ時間。タイムアウトすると同期グループの全ノードは現在の画像を保持し新しい画像を出力しません。

Reset Stats .resetstats 🔄
Reset Stats (統計リセット) — 接続された Info CHOP の統計をリセットするパルス。

Options Page 🎛️

Preset .preset 📋

Preset (プリセット) — カメラ設定のプリセット指定方式。

項目 内部名 説明
Externally Configured .externallyconfigured 外部で設定された値を使用
Custom .custom 以下の各パラメータで個別に設定

ゲイン・露出パラメータ 💡

Auto Gain/Exposure .autoge 🤖
Auto Gain/Exposure (自動ゲイン・露出) — ゲインと露出を自動調整するトグル。

Auto Gain/Exposure Bias .autogebias ⚖️
Auto Gain/Exposure Bias (自動ゲイン・露出バイアス) — 自動調整時の明るさのバイアス値。

Auto Gain/Exposure Level .autogelevel 📈
Auto Gain/Exposure Level (自動ゲイン・露出レベル) — 自動調整が目標とするレベル。

Max Gain .maxgain 🔼
Max Gain (最大ゲイン) — 自動ゲイン時の上限。

Max Exposure (ms) .maxexposure ⏱️
Max Exposure (最大露出、ミリ秒) — 自動露出時の上限時間。

Gain .gain 🎚️
Gain (ゲイン) — センサ信号の増幅量 (手動)。

Exposure (ms) .exposure ⏲️
Exposure (露出、ミリ秒) — シャッターの露光時間 (手動)。

Chromaticity Gamma .cgamma 🌈
Chromaticity Gamma (色度ガンマ) — 色度成分に対するガンマ補正。

Luminosity Gamma .lgamma 💡
Luminosity Gamma (輝度ガンマ) — 輝度成分に対するガンマ補正。

FPS・キャプチャパラメータ 🎬

Limit FPS .limitfps 🚦
Limit FPS (FPS 制限) — フレームレートに上限を設けるトグル。

FPS .limitedfps 🎞️
FPS (フレームレート) — Limit FPS 有効時の制限フレームレート値。

Capture .capture 📸
Capture (キャプチャ) — キャプチャ動作のトグル。

Capture Pulse .capturepulse ⚡
Capture Pulse (キャプチャパルス) — 単発でキャプチャを実行するパルス。

ホワイトバランスパラメータ ⚪

Auto White-Balance .autowb 🤖
Auto White-Balance (自動ホワイトバランス) — ホワイトバランスを自動調整するトグル。

White-Balance Coeffs .wbcoeffs 🎨
White-Balance Coeffs (ホワイトバランス係数) — RGB 各チャンネルのホワイトバランス係数を手動指定。

  • R (wbcoeffsr)
  • G (wbcoeffsg)
  • B (wbcoeffsb)

Custom Bandwidth .custombandwidth 📶

Custom Bandwidth (カスタム帯域幅) — 帯域幅制限を個別に指定するかどうか。

項目 内部名 説明
Default .default デバイス既定の帯域幅を使用
On .on カスタム帯域幅制限を有効化
Off .off 帯域幅制限を無効化

Bandwidth Limit (Mb/s) .bandwidthlimit 📉

帯域幅の上限指定 (Custom Bandwidth = On の時に有効):

  • Bandwidth Limit (Mb/s): ネットワークカメラ等で 1 秒あたりに使用する帯域の上限値 (メガビット毎秒)

Camera Bit Depth .camerabitdepth 🔢

Camera Bit Depth (カメラビット深度) — カメラから取り込むビット深度の指定。

項目 内部名 説明
Automatic .automatic カメラ対応の最適ビット深度を自動選択
8-Bit .8bit チャンネルあたり 8 ビット
10-Bit .10bit チャンネルあたり 10 ビット
12-Bit .12bit チャンネルあたり 12 ビット

GPU Demosaic .gpudemosaic 🖥️

ベイヤ映像のデモザイクを GPU で実行:

  • GPU Demosaic: RAW ベイヤ映像のカラー復元 (デモザイク) を GPU 側で実行し CPU 負荷を軽減する

実践アイデア 💡

Example 1: Webカメラ取り込み 📷

Video Device In TOP (Driver=DirectShow, Device 選択) → Level TOP → Out TOP

USB Webカメラの映像を Video Device In TOP で取り込み、Level TOP で明るさやコントラストを整えてからプロジェクト内の他オペレータへ渡す、最も基本的なライブ入力フロー。

  1. Video Device In TOP を作成し Active を 1 に設定
  2. Driver を DirectShow (WDM) に、Device で使用する Webカメラを選択
  3. Signal Format で解像度・フレームレートを指定
  4. 後段に Level TOP を接続し明るさ・コントラストを調整

Example 2: 放送品質の映像入力 🎥

Video Device In TOP (Driver=Blackmagic, Input Color Space=Rec.709) → Composite TOP

Blackmagic 製キャプチャカードで SDI / HDMI 入力を取り込み、Input Color Space を Rec.709 に指定して正しい色空間で扱い、合成や演出に利用する放送・ライブイベント向けフロー。

  1. Video Device In TOP を作成し Driver を Blackmagic に設定
  2. Signal Format で SDI / HDMI 入力の解像度とフレームレートを一致させる
  3. Input Color Space を Rec.709 に、Input Pixel Format を 10-bit 等に設定
  4. Composite TOP で他レイヤと合成

Example 3: 複数入力の同期取込 🔗

Video Device In TOP × 複数 (Sync Inputs=On, 同一 Sync Group) → Layout TOP

GenLock された複数のキャプチャ入力を Sync Inputs で同期させ、各ノードのフレーム出力を揃えてからマルチカメラ映像をまとめて扱うマルチ入力フロー。

  • 複数の Video Device In TOP を作成し各 Device を別々のキャプチャ入力に設定
  • 各ノードの Sync Inputs を On にし Sync Group Index を同じ値に揃える
  • Max Sync Offset / Sync Timeout で許容ズレと待機時間を調整
  • 後段で同期済みフレームをマルチカメラ合成に利用

関連オペレータ 🔗

類似機能OP 🔍

組み合わせ推奨OP 🔄

前処理・後処理TOP 🎯

Info CHOP情報 📊

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

TOP固有情報 🖼️

  • resx: TOP の出力解像度 X (ピクセル単位)
  • resy: TOP の出力解像度 Y (ピクセル単位)
  • aspectx: アスペクト比 X
  • aspecty: アスペクト比 Y
  • depth: 3D テクスチャ / テクスチャ配列の深度 (2D テクスチャでは 1)
  • gpu_memory_used: TOP が消費している GPU メモリ量 (MB 単位)

汎用オペレータ情報 🔄

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

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

よくある問題と解決策 🔧

❌ Problem: カメラが Device メニューに表示されない
✅ Solution:

  • Driver がカメラに合っているか確認 (Webカメラなら DirectShow (WDM)、キャプチャカードなら専用ドライバ)
  • 他のアプリがカメラを占有していないか確認してから TouchDesigner を再起動
  • USB カメラはケーブル・ポート (USB 3.0 推奨) や OS 側のカメラアクセス権限を確認

❌ Problem: 映像が取り込まれず黒画面のまま
✅ Solution:

  • Active が 1 になっているか確認
  • Signal Format が入力信号の解像度・フレームレートと一致しているか確認
  • キャプチャカードの入力端子 (SDI / HDMI) と物理ケーブル接続を確認

❌ Problem: 色が不自然・色味がずれる
✅ Solution:

  • Input Color Space を入力ソースに合わせる (放送系なら Rec.709、SD なら Rec.601 (NTSC))
  • Input Reference White が SDR / HDR で適切か確認
  • 後段に Level TOP を入れて手動補正

❌ Problem: 複数入力の同期が取れない
✅ Solution:

  • 入力ソースが GenLock されているか確認 (Sync Inputs の前提条件)
  • 各ノードの Sync Group Index が同じ値か確認
  • Sync Inputs は Blackmagic / DataPath / Deltacast / BlueFish のみ対応のため非対応カードでは使えない

参考資料 📚

その他 🔗

公式リソース 📖

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