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

概要 📖 – 主 ZED から画像を分岐

ZED Select TOPは、カメラを設定する主 ZED TOP から、カラー・深度・点群など別モードの画像を追加で取り出す TOPです。主となる ZED TOP がカメラ本体の設定を担い、ZED Select TOP はその主 TOP を参照して別の出力モードや視点を取り出します。1 台のカメラを 2 度設定することなく、必要なモードだけを枝分かれさせて取得できます。

主な用途 🎯

• 1 台の ZED を設定する主 TOP から、カラー映像と深度マップを別々の TOP として同時に取り出す
• 主 ZED とは別の左右視点 (Left / Right) の映像を追加で受け取り、ステレオ表示に利用する
• 点群 (Point Cloud) や法線など重いモードを必要な箇所だけで分岐取得し、パイプラインを整理する
• 同じカメラを 1 度だけ設定し、複数の出力モードを枝分かれさせて GPU・USB の二重取得を回避する
• 深度の範囲外ピクセルへの代替値を出力先ごとに変え、合成・解析それぞれに最適化した画像を得る

データフロー 🔄

入力: 主 ZED TOP (カメラを設定済み)
 ↓
ZED TOP で参照する主 TOP を指定
 ↓
Image で取り出すモード (Color / Depth / Confidence / Disparity / Normals / Point Cloud / Spatial Texture) を選択
 ↓
Perspective・深度範囲・代替値で調整
 ↓
出力: 分岐した TOP テクスチャ (モードに応じたチャンネル数・ビット深度)

---

パラメータ解説 ⚙️

ZED Select Page 📋

Active .active ✅

この TOP の画像取得 オン/オフ:

• Active: Active (有効) — この TOP がデバイスから画像データを取得するかどうかを切り替えます。データを受け取るには、参照先の主 ZED TOP も同時に有効である必要があります

ZED TOP .zedtop 🔗

参照する主 ZED TOP のパス:

• ZED TOP: ZED TOP (参照先 TOP) — カメラを設定している主 ZED TOP の名前を指定します。主 TOP がどのカメラを使うかを決め、この Select TOP はそこからデータを受け取ります

Perspective .perspective 👁️

左右どちらのカメラ画像を出力するか

項目	内部名	説明
Left	.left	左カメラ
Right	.right	右カメラ

Image .image 🖼️

主 ZED から取り出す画像モードの選択:

• Image: Image (画像モード) — Color (カラー) / Depth (深度) / Confidence (信頼度) / Disparity (視差) / Normals (法線) / Point Cloud (点群) / Spatial Texture (空間テクスチャ) の各モードから取り出す画像の種類を選択します。選んだモードで出力テクスチャのチャンネル数・ビット深度が変わります

Maximum Depth .maxdepth 📏

計算される最大距離 (メートル):

• Maximum Depth: Maximum Depth (最大深度) — 計算される最大距離をメートル単位で指定します。これより遠いピクセルは下記の Too Far Value に置き換えられます

Out-of-Range Values .outofrangevalues 🚫

範囲外・未確定ピクセルへの代替値

Too Close Value .toocloseval 🚫
– Too Close Value (近接限界値) — カメラに近すぎて深度を測定できなかったピクセルに、この値を代わりに出力します

Too Far Value .toofarval 🚷
– Too Far Value (遠方限界値) — カメラから遠すぎて測定できなかったピクセルに、この値を代わりに出力します

Unknown Value .unknownval ❓
– Unknown Value (未確定値) — 反射・遮蔽等で深度が決定できなかったピクセルに、この値を代わりに出力します

Rerange .rerange 📊

ピクセル値を 0-1 範囲に再マップ:

• Rerange: Rerange (再マップ) — オンにすると、出力テクスチャのピクセル値を 0〜1 の範囲にリマップします。深度値をそのまま色として可視化したい時に有効

Mirror Image .mirrorimage 🪞

出力画像を Y 軸 (左右) で反転:

• Mirror Image: Mirror Image (ミラー反転) — 出力画像を Y 軸 (左右) 方向に反転します。鏡像表示インスタレーションで「体験者が画面の同じ側に映る」演出に有効

---

Common Page 🔧

項目	内部名	説明

---

実践アイデア 💡

Example 1: カラーと深度を同時取得 🎭

ZED TOP (Color) → 表示 / ZED Select TOP (Depth) → Threshold TOP → Composite TOP

1 台の ZED を主 ZED TOP で設定し、主 TOP からカラー映像を、ZED Select TOP から深度マップを同時に取り出します。深度側を Threshold TOP で 2 値マスクにし、カラー映像と Composite TOP の Over 合成で重ねることで、1 度のカメラ設定だけで人物切り抜きパイプラインが組めます。

1. 主 ZED TOP を配置し、カメラと Image = Color を設定
2. ZED Select TOP を配置し、ZED TOP に主 TOP の名前を指定
3. ZED Select TOP の Image を Depth に設定し、深度マップを分岐取得
4. Threshold TOP で人物の立つ距離でマスクを作り、Composite TOP の Over でカラー映像と合成

Example 2: 左右視点を同時表示 👀

ZED TOP (Perspective: Left) / ZED Select TOP (Perspective: Right) → Layout TOP

主 ZED TOP を左カメラ視点に、ZED Select TOP を右カメラ視点に設定することで、同じカメラから左右両方の映像を同時に取り出せます。これを Layout TOP で並べれば、ステレオ確認用のサイドバイサイド表示が作れます。

1. 主 ZED TOP の Perspective を Left に設定
2. ZED Select TOP を配置し、ZED TOP に主 TOP を指定して Perspective を Right に設定
3. 両方の出力を Layout TOP で横並びに配置してステレオ確認画面を作成

Example 3: 点群だけを枝分かれ取得 🌌

ZED TOP (Depth で合成) / ZED Select TOP (Point Cloud) → GLSL TOP

深度マップは主 ZED TOP で合成に使いつつ、重い点群モードは ZED Select TOP 側に枝分かれさせて取得します。Point Cloud は各ピクセルが XYZ 座標を持つ 32-bit float テクスチャになり、GLSL TOP や Geometry COMP の Instancing で空間を 3D 点群として可視化できます。必要な箇所だけで重いモードを取り出すことで、パイプライン全体の負荷を抑えられます。

1. ZED Select TOP を配置し、ZED TOP に主 TOP を指定
2. Image を Point Cloud に設定して点群テクスチャを取得
3. Unknown Value を遠方値に設定し、未確定ピクセルをシーン外へ逃がす
4. Geometry COMP の Instancing で XYZ チャンネルを Instance Translate に接続して点群描画

---

関連オペレータ 🔗

類似機能OP 🔍

• ZED TOP — カメラ本体を設定する主 ZED TOP。Select はこれを参照する
• Kinect Azure Select TOP — 主 Kinect Azure TOP から画像モードを分岐取得する同型の Select TOP
• OAK Select TOP — Luxonis OAK カメラの画像ストリームを分岐選択する Select TOP
• Orbbec Select TOP — Orbbec 深度センサーの出力モードを分岐選択する Select TOP
• Render Select TOP — 主 Render TOP の出力を別 TOP として選択取得する同型の Select TOP

組み合わせ推奨OP 🔄

• Threshold TOP — 深度画像をしきい値でマスク化、距離フィルタとして利用
• Composite TOP — 分岐したカラーと深度マスクを背景映像とレイヤ合成
• Math TOP — 深度値のレンジ変換・正規化、信頼度値のスケーリング
• Layout TOP — 左右視点や複数モードを 1 画面に並べて同時確認
• Null TOP — 分岐先の固定参照点として配置し、後段の差し替えを容易にする

前処理・後処理TOP 🎯

• 後処理 TOP: Threshold TOP、Math TOP、Composite TOP、Layout TOP、Null TOP

---

Info CHOP情報 📊

ZED Select 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: エラー数

代表的な取得チャンネル 📡

• resolution_x / resolution_y: 出力テクスチャの幅・高さ (ピクセル)
• aspectx / aspecty: 出力テクスチャのアスペクト比 (横 / 縦)
• depth: ピクセルフォーマットのビット深度 (8 / 16 / 32)
• num_components: 出力チャンネル数 (Color=4 / Depth=1 / Point Cloud=4 等、Image モードに依存)
• gpu_mem_used: GPU メモリ使用量 (バイト)、Point Cloud 等の重いモードでの負荷確認に有用

---

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

よくある問題と解決策 🔧

❌ Problem: ZED Select から何も取り込めない / テクスチャが真っ黒
✅ Solution:

• Active がオンになっているか確認
• ZED TOP に指定した主 ZED TOP のパスが正しく、その主 TOP も Active でデータを受信しているか確認
• 主 ZED TOP 側でカメラ (USB / SVO / ネットワーク) が正しく接続・再生されているか確認

❌ Problem: 意図したモードの画像が出ない
✅ Solution:

• Image が取り出したいモード (Color / Depth / Point Cloud 等) に設定されているか確認
• 深度系モードの場合は Maximum Depth が被写体距離をカバーしているか確認
• 左右が逆の場合は Perspective の Left / Right を切り替える

❌ Problem: 深度や点群に範囲外の点が多い
✅ Solution:

• Too Close Value / Too Far Value / Unknown Value を用途に合わせて設定し、無効ピクセルを扱いやすい値に逃がす
• Maximum Depth を被写体距離に絞り込んで遠方ノイズを除外
• 後段で Math TOP や GLSL TOP で範囲外ピクセルをマスク処理

---

参考資料 📚

その他 🔗

• TouchDesigner Wiki — Category:TOPs
• TouchDesigner Wiki — Pixel Formats 解説
• TouchDesigner Wiki ホーム
• TouchDesigner 公式 Forum
• Facebook — TouchDesigner Help Group

公式リソース 📖

• TouchDesigner公式ドキュメント – ZED Select TOP
• TouchDesigner公式 – TOP

ハードウェア情報 🔧

• Stereolabs 公式 – ZED カメラ仕様

その他の記事はこちら

---