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

概要 📖 – 深度カメラから立体形状を生成

ZED POPは、ZED 深度カメラの映像をメッシュまたは点群として取り込む POPです。出力するジオメトリの形式や解像度、奥行き範囲を細かく調整し、空間スキャンの結果を立体形状として扱います。

主な用途 🎯

• ZED 深度カメラの映像から立体形状を生成
• 空間スキャンによる立体メッシュの作成
• 点群データのリアルタイム取り込み
• 撮影した人物や物体の立体キャプチャ
• 奥行きに応じた近すぎる点・遠すぎる点の除去

データフロー 🔄

入力: ZED 深度カメラ映像（カラー + 奥行き情報）
 ↓
空間マッピング処理（メッシュまたは点群へ変換）
 ↓
出力: 立体ジオメトリ

---

パラメータ解説 ⚙️

Zed Page 📋

基本設定 🎛️

Active .active ✅
Active (有効化) — 使用していない GPU メモリを解放するための追加処理を行います。

ZED TOP .zedtop 📷
ZED TOP (参照元カメラ) — 入力となる ZED TOP への参照を指定します。

Initialize .initialize 🔄
Initialize (初期化) — 抽出したジオメトリをクリアし、空間マッピングをリセットします。

Start .startpulse ▶️
Start (再生開始) — 再生を開始します。

Play .play ⏯️
Play (再生) — 再生を有効にします。

Go to Done .donepulse ⏹️
Go to Done (終了へ移動) — 即座に終了状態へ移行します。

出力形式 .outputmode 🧊

出力するジオメトリの形式と点のつなぎ方を決めるメニューパラメータ

項目	内部名	説明
Mesh	.mesh	面でつながった立体メッシュとして出力
Point Cloud	.pointcloud	点の集まり（点群）として出力

ジオメトリ品質 📏

Maximum Memory .maxmemory 💾
Maximum Memory (最大メモリ) — 空間マッピングに使用するメモリ上限を設定します。

Resolution .resolution 📐
Resolution (解像度) — 空間マッピングの解像度をメートル単位で指定します。

Range .range 📏
Range (奥行き範囲) — 取り込む奥行きの範囲をメートル単位で指定します。

Normals .normals 🧭
Normals (法線) — 有効にすると抽出したジオメトリに法線（面の向き情報）が付加されます。

Color .color 🎨
Color (色) — 色情報を属性として出力します。

平滑化 .filter 🎚️

メッシュの平滑化の強さを決めるメニューパラメータ

項目	内部名	説明
Low	.low	弱い平滑化
Medium	.medium	中程度の平滑化
High	.high	強い平滑化

プレビュー表示 .preview 👁️

カメラ映像のプレビュー表示方法を決めるメニューパラメータ

項目	内部名	説明
No Preview	.nopreview	プレビューを表示しない
Limited Preview	.limited	限定的なプレビュー表示
Full Preview	.full	全体のプレビュー表示
Mirror Image	.mirrorimage	Mirror Image (左右反転) — 入力映像を左右に反転します。

値の再範囲化 .rerange 🔢

入力値と出力値の範囲を変換する設定

項目	内部名	説明
Rerange from Low	.rerangefromlow	変換元の下限値
Rerange from High	.rerangefromhigh	変換元の上限値

カメラ投影設定 .viewanglemethod 📷

カメラの視野や投影方法を決める設定

項目	内部名	説明
Horizontal FOV	.horfov	水平方向の視野角で指定
Vertical FOV	.vertfov	垂直方向の視野角で指定
Focal Lengths	.focallengths	カメラの焦点距離で指定
Camera	.camera	Camera (カメラ) — 使用するカメラコンポーネントを指定します。
Override Camera View	.overridecamera	Override Camera View (視野設定の上書き) — 有効にすると、選択したカメラオブジェクトの視野設定を上書きします。
FOV Angle	.fov	FOV Angle (視野角) — カメラの視野角を指定します。

点の除去 ✂️

Delete Near Points .deletenear ✂️
Delete Near Points (近すぎる点の除去) — カメラに近すぎる点を取り除く機能を有効にします。

Near Depth .depthnear 📍
Near Depth (手前の境界) — 手前側の切り取り境界までの奥行きを指定します。

Delete Far Points .deletefar ✂️
Delete Far Points (遠すぎる点の除去) — カメラから遠すぎる点を取り除く機能を有効にします。

Far Depth .depthfar 📍
Far Depth (奥の境界) — 奥側の切り取り境界までの奥行きを指定します。

---

実践アイデア 💡

Example 1: 空間の立体スキャン 🧊

ZED TOP → ZED POP (Output Mode: Mesh) → Geometry COMP → Render

ZED 深度カメラの映像を ZED POP でメッシュとして取り込み、撮影した空間や物体をそのまま立体形状として描画する基本フロー。Filter を上げると表面が滑らかになります。

1. ZED TOP で深度カメラ映像を取得
2. ZED POP の Output Mode を「Mesh」に設定
3. Filter を「Medium」にして表面を整える
4. 出力ジオメトリを Geometry COMP で描画

Example 2: 点群ビジュアライズ ✨

ZED TOP → ZED POP (Output Mode: Point Cloud) → POP to TOP → Render

ZED POP を点群モードに切り替え、奥行きに応じて色付けされた点の集まりとしてリアルタイムに可視化する例。近すぎる点・遠すぎる点を除去してノイズを抑えます。

1. Output Mode を「Point Cloud」に設定
2. Color を有効にして色情報を点に付加
3. Delete Near Points / Delete Far Points で不要な点を除去
4. Near Depth / Far Depth で残す奥行き範囲を調整

---

関連オペレータ 🔗

類似機能OP 🔍

• In POP — 外部ジオメトリを POP ネットワークに取り込む

組み合わせ推奨OP 🔄

• Transform POP — 取り込んだ立体を移動・回転・拡大縮小
• Null POP — 出力を整理する中継点として配置
• Math POP — 点の属性値を後段で補正・スケーリング

前処理・後処理POP 🎯

• 後処理: Transform POP、Select POP、Null POP

---

Info情報 📊

ZED POP が出力する立体ジオメトリの点数や属性は、各種 Info 系オペレータで確認します。

POP固有情報 ✨

• num_verts: POP に含まれる頂点 (vertex) 数
• num_points: POP に含まれるポイント数
• num_prims: POP に含まれるプリミティブ数

汎用オペレータ情報 🔄

• total_cooks: プロセス開始からのクック回数
• cook_time: 最後のクック時間 (ミリ秒)
• cook_frame: 最後にクックされたフレーム番号
• cook_abs_frame: 最後にクックされた絶対フレーム番号 (アプリケーション起動からの累積)
• cook_start_time: 最後のクック開始時刻 (ミリ秒)
• cook_end_time: 最後のクック終了時刻 (ミリ秒)
• cooked_this_frame: 現フレームでクックされたか (0 / 1)
• warnings: 警告数
• errors: エラー数

ジオメトリ統計 📊

• num_points: 出力された点（頂点）の総数
• num_primitives: 出力されたプリミティブ（面）の総数

属性情報 🧭

• normals: 法線属性が付加されているかどうか
• color: 色属性が付加されているかどうか

---

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

よくある問題と解決策 🔧

❌ Problem: ジオメトリが出力されない
✅ Solution:

• ZED TOP への参照が正しく設定されているか確認
• Active と Play が有効になっているか確認
• Initialize でいったんリセットしてから再度開始

❌ Problem: メッシュにノイズや穴が多い
✅ Solution:

• Filter を「Medium」または「High」に上げて平滑化
• Resolution を調整して空間マッピングの精度を変更
• 後段に Transform POP を入れて位置を整える

❌ Problem: 動作が重い・メモリ不足になる
✅ Solution:

• Maximum Memory の上限を見直す
• Resolution を粗くして処理負荷を下げる
• Delete Near Points / Delete Far Points で不要な点を除去

---

参考資料 📚

その他 🔗

• TouchDesigner Wiki — POP 概要
• TouchDesigner Wiki — Category:POPs
• TouchDesigner Wiki ホーム
• TouchDesigner 公式 Forum
• Facebook — TouchDesigner Help Group

公式リソース 📖

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

関連オペレータ 🔗

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

その他の記事はこちら

---