MCPcopy Create free account
hub / github.com/baku89/VirtualMapper

github.com/baku89/VirtualMapper @v2.3.1

Chat with this repo
repository ↗ · DeepWiki ↗ · release v2.3.1 ↗ · + Follow
173 symbols 257 edges 20 files 11 documented · 6% updated 8y agov2.3.1 · 2017-09-04★ 2366 open issues

Browse by type

Functions 157 Types & classes 16
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Virtual Mapperの使い方 (ユーザー向け)

重要: 最新バージョンはmacOSのみの対応です。

どういうソフトか

ライブやプロジェクションマッピング、インスタレーション向けの映像など、立体的な形状のスクリーンに投影する映像を作る場合、展開図のガイドの上にグラフィックを配置していくケースが多いかと思います。

そういった際に、制作ソフトのプレビュー画面や映像ファイルをステージの3Dモデル上に貼り付け、立体的にリアルタイムプレビューできるツールがVirtual Mapperです。

テンプレート制作者はあらかじめ3D空間のカメラ位置、スクリーン形状などのシーンデータをFBX形式でエクスポートしておきます。各アーティストは配布されたシーンデータを読み込み、制作ソフトの外部出力や映像ファイルなどのソースを指定することでプレビューが可能になります。

macOSの場合はSyphon、Windowsの場合はSpoutという方式でソフト間で映像を転送するため、映像ソフトによっては対応プラグインが必要になる場合があります。

このビデオが分かりやすい例です。

手順

1. Virtual Mapperをダウンロード (最新バージョンmacOSのみ対応)

2. 制作ソフト側に外部出力用プラグインが必要な場合、インストールする

macOSの場合はこちら、Windowsの場合はこちらのサイトを参考に、各ソフト向けのプラグインを入手してください。以下は例です。

  • Adobe After Effects  + macOS: AESyphon) (フリー版は1024×768までの出力に制限されます)  + Windows: SpoutAE

3. Virtual Mapperを起動する

4. FBXファイルをロードする

起動画面のサイドバー右上 Scene > Open Scene より、FBXファイルを選択。

5. 入力ソースを選択

サイドバー Source より、入力ソースを選択。

  • Syphon : (macOS) After Effects等、外部ソフトからのプレビュー入力
  • Image : 静止画 (JPG, PNG等)
  • Video : 動画。macOSの場合、Quick Time Xでそのまま再生出来るファイル形式に対応

操作

カメラの基本操作は以下になります。

  • 左クリック + ドラッグ : 視点回転
  • 中央クリック + ドラッグ | [H] + ドラッグ | [スペース] + ドラッグ : 視点平行移動
  • 右クリック + ドラッグ : 視点ズーム
  • [1-9] : カメラ切り替え

その他のショートカットは、サイドバー Misc > Help から確認できます。

Core symbols most depended-on inside this repo

Shape

Method 139
Function 18
Class 16

Languages

C++100%

Modules by API surface

src/Manager/ViewManager.h20 symbols
src/Manager/SceneManager.h19 symbols
src/Source/VideoSource.h16 symbols
src/ImGuiApp.h15 symbols
src/Source/BaseSource.h14 symbols
src/Source/SyphonSource.h13 symbols
src/Source/ImageSource.h11 symbols
src/Source/SpoutSource.h10 symbols
src/Manager/SourceManager.h10 symbols
src/ofApp.cpp8 symbols
src/Manager/BaseManager.h8 symbols
src/ofxAdvancedGrabCam.h6 symbols

For agents

$ claude mcp add VirtualMapper \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page