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

概要 📖 – 投影画像を歪み補正

Vioso TOPは、VIOSO 6 で書き出した設定ファイルを使い、入力映像に幾何補正とエッジブレンドを適用するキャリブレーション TOPです。曲面スクリーンや複数台のプロジェクター環境で、歪みや継ぎ目のない投影を実現します。

主な用途 🎯

• プロジェクションマッピングでの幾何補正（ワープ）適用
• 複数プロジェクターのエッジブレンディングによる継ぎ目消し
• ドーム・曲面スクリーンへの湾曲歪み補正
• VIOSO 6 で作成したキャリブレーションデータ（.vwf）の再生
• マルチプロジェクター環境での各投影機ごとの出力切り出し

データフロー 🔄

入力: 補正前の映像（TOP）
 ↓
VIOSO 設定ファイル（.vwf）による幾何補正・ブレンド処理
 ↓
出力: 指定プロジェクター用に補正済みの映像

まる。

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

パラメータ解説 ⚙️

Setup Page 📋

設定ファイルと投影機 .setup 🎛️

VIOSO 6 で書き出したキャリブレーションデータと、出力先のプロジェクターを指定するパラメータ

Configuration File .configfile 📄
– Configuration File (設定ファイル) — VIOSO 6 から書き出した .vwf ファイルの場所を指定します。
– この設定ファイルに、幾何補正とエッジブレンドのキャリブレーション情報がまとまって格納されています。

Projector Index .projectorindex 🔢
– Projector Index (出力プロジェクター番号) — 出力先となるプロジェクターのインデックス（番号）を指定します。
– 複数台構成の場合、ここで何台目の投影機向けの補正映像を出力するかを選びます。

実践アイデア 💡

Example 1: 曲面スクリーンへの単機投影 🎯

Movie File In TOP → Vioso TOP (.vwf 読込) → Window COMP

湾曲したスクリーンに 1 台のプロジェクターで映像を投影する基本構成。映像ソースを Vioso TOP に通し、VIOSO 6 で作成した設定ファイルで歪みを補正してから投影します。

1. Movie File In TOP で投影したい映像を読み込む
2. Vioso TOP の Configuration File に VIOSO 6 で書き出した .vwf を指定
3. Projector Index を投影機の番号に合わせる
4. Window COMP でプロジェクターのディスプレイに全画面出力

Example 2: 複数機のエッジブレンド投影 🧩

Render TOP → Vioso TOP (Projector Index 別) → Video Device Out TOP

横並びの複数プロジェクターでワイドな映像を継ぎ目なく投影する構成。投影機ごとに Vioso TOP を用意し、それぞれ別の出力番号を割り当ててエッジブレンドを効かせます。

• 投影機の台数だけ Vioso TOP を配置する
• 各 Vioso TOP に同じ .vwf を指定し、Projector Index だけを変える
• 各出力を対応するディスプレイへ送り、重なり部分のブレンドで継ぎ目を消す

関連オペレータ 🔗

類似機能OP 🔍

• Projection TOP — 投影面に合わせた映像変換を行う TOP

組み合わせ推奨OP 🔄

• Render TOP — 前段で 3D シーンを描画し補正対象の映像を生成
• Movie File Out TOP — 補正後の映像をファイルに書き出して記録
• NDI Out TOP — 補正済み映像をネットワーク経由で別マシンへ送出
• Syphon Spout Out TOP — 補正済み映像を他アプリへ GPU 共有

前処理・後処理TOP 🎯

• 前処理: Render TOP、Composite TOP、Level TOP
• 後処理: Video Device Out TOP、Direct Display Out TOP、Null TOP

Info情報 📊

Vioso TOP は Info CHOP / Info DAT で解像度やクック情報などの詳細を取得できます。

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

解像度情報 📐

• resx: 出力テクスチャの横方向の解像度（ピクセル）
• resy: 出力テクスチャの縦方向の解像度（ピクセル）
• aspectx: 出力画像の横方向のアスペクト比
• aspecty: 出力画像の縦方向のアスペクト比

クック情報 ⏱️

• cook_time: 直近のクックに要した時間（ミリ秒）
• total_cooks: 起動以降にクックされた回数
• cpu_memory: オペレータが使用する CPU メモリ量
• gpu_memory: オペレータが使用する GPU メモリ量

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

よくある問題と解決策 🔧

❌ Problem: 映像が補正されず歪んだまま出る
✅ Solution:

• Configuration File に正しい .vwf ファイルが指定されているか確認
• VIOSO 6 側で書き出したキャリブレーションが完了しているか確認
• 前段の映像が Vioso TOP の入力に正しく接続されているか確認

❌ Problem: プロジェクターに何も出力されない
✅ Solution:

• Projector Index が実際の投影機の番号と一致しているか確認
• 出力側で Null TOP を挟み接続経路が途切れていないか確認
• Window COMP や Video Device Out TOP の出力先ディスプレイ設定を確認

❌ Problem: 複数機の継ぎ目（ブレンド）が合わない
✅ Solution:

• 各 Vioso TOP の Projector Index がそれぞれ別の番号になっているか確認
• 全機で同じ .vwf 設定ファイルを参照しているか確認
• VIOSO 6 側でエッジブレンドの再キャリブレーションを行う

参考資料 📚

その他 🔗

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

公式リソース 📖

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

関連オペレータ 🔗

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

まる。

お仕事のご依頼はDM又はメールにて。
━━━━━━━━━━━━━━━━━
Python/Touchdesigner/M5Stackをこよなく愛すフルスタックエンジニア。
専門は生理心理学、趣味はヨガやサウナ、EMS電気風呂などヘルスケア全般。
脳波や筋電、心拍を中心とした生体情報のセンシング＆インタラクティブアートづくりがライフワーク。

普段はワントゥーテンという会社で空間演出エンジニアをしています。
リファラル採用お繋ぎできますので、我こそはという尖った方は経歴と希望職種添えてDMください(エンジニア以外、営業職等もOK)。
ご飯行きましょう。

↓日常垢
Instagram：＠malmal0v0

まる。をフォローする

その他の記事はこちら

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

2026/6/19

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

2026/6/19

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

2026/6/19

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

2026/6/19

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

2026/6/19