背景

漢には, Windows で C++ で pxrUSD 使わねばならぬときもある... C++ でコアの機能(UsdGeomMesh とか)が使えればよい. usdImaging とか Hydra とか Python binding はとりあえずはいらない.

pxrUSD の Windows ビルドめんどくさすぎじゃ...

Prebuilt あるけど,

Python 付き + VS2015(v141) でビルドされているため, C/C++ で pxrUSD の API だけ使いときにいろいろ問題ある(VS2019~ だと v142 なので, boot-python.lib 関連がなくてリンクできないなど)

環境

VS2019 or VS20222
(mini)conda
Windows 10 or 11

手順

の python のビルドスクリプトを使います.

優秀な若人さまにおかれましては, 機械学習で Python 環境は conda で作っているかと思いますので, 今回 conda 使います.

conda インストールして, conda init しておくと PATH など環境変数設定してくれますのでやっておくとよいでしょう.

Python は 2020/11 時点では 3.8 以上がよいと思いますが, 今後 USD を Python 付きでビルドするかもを想定し, 一応互換性考えて 3.7 環境を作っておきます.
(また古い USD のバージョンだと Python 3.8+ 対応していない)

> conda create -n usd-22 python=3.7

VS の開発環境に入り(or vcvarsalllbat をよぶ https://stackoverflow.com/questions/43372235/vcvarsall-bat-for-visual-studio-2017), conda で activate しておきます.

あとはいろいろ disable してビルドするだけです!
今回は --build-monolithic つけてみました.

python USD\build_scripts\build_usd.py --no-python --build-monolithic --no-openvdb --no-materialx --no-ptex --no-embree --no-prman --no-hdf5 --no-alembic --no-draco --no-docs --no-imaging --no-openimageio --no-opencolorio  USD-dist-22_11

その他, お好みで調整して. App が Debug ビルドする場合, CRT のデバッグ機能などと合わせるために pxrUSD も --debug つけてビルドする必要があると思います.

usd file format plugin folder

.dll を App フォルダにコピって使っているばあい, USD ファイルを Open しようとしても cannot determine format error というエラーがおきるときがあります.

これは pxrUSD が .usda, .usdc でも file format 情報を plugin JSON <dist>/lib/usd にあるファイル群から読み取る必要があるためです!(monolithic build とか dll ビルドのときでも同じ). めんどくさいネ...

PXR_PLUGINPATH_NAME で環境変数を設定するか, C++ で PluginRegistory で登録してあげる必要があります.

(Linux だと .so ファイルは通常動かさないので, plugin info ファイルを .so からの相対パスでうまく見つけてくれる模様)
`

Monolithic build

USD を monolithic にビルドしている場合, リンクするライブラリ名は usd_ms.lib になります.

使うときの注意

TBB が, Debug ビルド時に TBB_USE_ASSERT などマクロ定義してあげる必要があるときがあるかもしれません.

Seg fault 問題

ただ, なんかビルド構成によるのか, pxrUSD API 内で exception が起きてしまうときがあります...
どうも Debug build かどうかだったり Unicode/MBCS charset 問題のもよう...