レンダラー Mitsuba 2 のインストール（GitHub の mitsuba-renderer/mitsuba2 を使用，Windows 上）

URL: https://github.com/mitsuba-renderer/mitsuba2

前準備（Git, cmake, マイクロソフト C++ ビルドツール等のインストール）

Python 64 ビット版のインストール，pip と setuptools の更新

Windows での Python 3.10 のインストール，pip と setuptools の更新: 別ページで説明している．

Python の公式ページ: http://www.python.org/

Build Tools for Visual Studio 2022 （ビルドツール for Visual Studio 2022）のインストール

Build Tools for Visual Studio は，Windows で動くMicrosoft の C++ コンパイラーである．

ダウンロードページ

https://visualstudio.microsoft.com/ja/downloads/

詳細説明

Build Tools for Visual Studio 2022 （ビルドツール for Visual Studio 2022）のインストール: 別ページで説明している．

インストール手順の概要

ダウンロード URL を開く
https://visualstudio.microsoft.com/ja/downloads/
このページの「Build Tools のダウンロード」をクリック
ダウンロードが始まる
ダウンロードした .exe ファイルを実行する
表示を確認し，「続行」をクリック
「C++ によるデスクトップ開発」をクリック．「インストール」をクリック．

Git のインストール

Git のページ https://git-scm.com/ からダウンロードしてインストール:

Windows での Git のインストール手順: 別ページで説明している．

cmake のインストール

cmake のダウンロードページ: https://cmake.org/download/

Windows での cmake のインストール手順: 別ページで説明している．

NVIDIA ドライバ，NVIDIA CUDA ツールキット 11.7.0, NVIDIA cuDNN 8.4.1 のインストール

GPU は，グラフィックス・プロセッシング・ユニットの略で、コンピュータグラフィックス関連の機能，乗算や加算の並列処理の機能などがある． NVIDIA CUDA ツールキットは，NVIDIA社が提供している GPU 用のプラットフォームである．

【インストール手順の詳細説明】

Windows での NVIDIA ドライバ，NVIDIA CUDA ツールキット 11.7.0，NVIDIA cuDNN v8.4.1 のインストール: 別ページで説明している．
Ubuntu での NVIDIA ドライバ，NVIDIA CUDA ツールキット 11.7, NVIDIA cuDNN 8.4.1 のインストール: 別ページで説明している

NVIDIA ドライバについて

古いNVIDIA ドライバ，NVIDIA CUDA がインストール済みのとき，不要なものがあればアンインストール
Windows のスタートメニューで「設定」，「アプリ」と操作して，「NVIDIA ・・・」を削除
NVIDIA グラフィックス・カードの種類を調べる
hwinfo (URL: https://www.hwinfo.com) を使って調べることができる．
あとで，NVIDIA CUDA ツールキットをインストールするときに，NVIDIA ドライバを同時にインストールすることができる．
あとで、NVIDIA CUDA ツールキットをインストールするので、そのときに、NVIDIA ドライバもインストールすることにする．次へ進む．

但し， NVIDIA CUDA ツールキットの古いバージョンを使う場合には，次のページから，最新のNVIDIA ドライバをダウンロードして，インストールする．
NVIDIA ドライバのダウンロードページ: https://www.nvidia.co.jp/Download/index.aspx?lang=jp

NVIDIA CUDA ツールキット 11.7.0，NVIDIA cuDNN 8.4.1 のインストール

Windows での NVIDIA ドライバ，NVIDIA CUDA ツールキット 11.6.2，NVIDIA cuDNN v8.4.0 のインストール: 別ページで説明している．

NVIDIA CUDA ツールキット 11.7.0 のダウンロードとインストール
NVIDIA ドライバのインストールが必要な場合は，このときに，同時にインストールする
次のページからダウンロードし，インストールする．
NVIDIA CUDA ツールキットのページ: https://developer.nvidia.com/cuda-toolkit-archive
NVIDIA CUDA クイックスタートの公式ページ: https://docs.nvidia.com/cuda/cuda-quick-start-guide/index.html
NVIDIA cuDNN のダウンロードと設定
1. ZLIB DLL のダウンロードとインストール
  管理者として実行したコマンドプロンプトで，次のコマンドを実行．
  v11.7」のところは，実際にインストールされているバージョンを確認し，読み替えてください．
```
cd "C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v11.7\bin"
curl -O http://www.winimage.com/zLibDll/zlib123dllx64.zip
call powershell -command "Expand-Archive zlib123dllx64.zip"
copy zlib123dllx64\dll_x64\zlibwapi.dll .
```
  Windows で「Could not locate zlibwapi.dll. Please make sure it is in your library path!」と表示されるときの対処：
  ここの説明を参考に ZLIB DLL をインストールする．
2. NVidia の cuDNN のウェブページを開く
  https://developer.nvidia.com/cuDNN
3. ダウンロードしたいので，cuDNNのところにある「Download cuDNN」をクリック
4. NVIDIA Developer Program メンバーシップに入る
  cuDNN のダウンロードのため．
  「Join now」をクリック．その後，画面の指示に従う．利用者本人が，電子メールアドレス，表示名，パスワード，生年月日を登録．利用条件等に合意．
5. ログインする
6. ライセンス条項の確認
  - NVIDIA cuDNN のダウンロードページ: https://developer.nvidia.com/cudnn
  - Windows での NVIDIA cuDNN のインストールの詳細説明: 別ページで説明している．
7. いまダウンロードした zip ファイルを，分かりやすいディレクトリに展開（解凍）する
8. そこに，パスを通す．
  
  「C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v11.7」に展開（解凍）した場合は，すでにパスは通っているので，何もしなくてよい．
9. 次の操作により，cudnn64_8.dll にパスが通っていることを確認する．
  Windowsのコマンドプロンプトを開き，次のコマンドを実行．エラーメッセージが出ないことを確認．
```
where cudnn64_8.dll
```
10. システム環境変数 CUDNN_PATH の設定を行う．
  システム環境変数 CUDNN_PATH の設定
  管理者として実行したコマンドプロンプトで，次のコマンドを実行．
  
  「C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v11.7」は，実際に展開（解凍）したディレクトリに読み替えること．
```
call powershell -command "[System.Environment]::SetEnvironmentVariable(\"CUDNN_PATH\", \"C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v11.7\", \"Machine\")"
```

github の mitsuba-renderer/mitsuba2 のインストール

URL: https://github.com/mitsuba-renderer/mitsuba2

Windows での手順を下に示す．Ubuntu でも同様の手順になる．

Windows では，コマンドプロンプトを 管理者として実行する．
インストールディレクトリを空にする
```
cd c:\
rmdir /s /q mitsuba2
```
github の mitsuba-renderer/mitsuba2 のダウンロード
「--recursive」を付けている．glog, openexr, ptex, zlib があわせてダウンロードされる．
```
cd c:\
git clone --recursive https://github.com/mitsuba-renderer/mitsuba2
```
cmake の実行
cmake のオプションの「Visual Studio 17 2022」のところは，使用する Visual Studio のバージョンにあわせること． Visual Studio 2022 のときは，「Visual Studio 17 2022」． Visual Studio 2019 のときは，「Visual Studio 16 2019」
```
cd c:\
cd mitsuba2
rmdir /s /q build
mkdir build
cd build
del CMakeCache.txt
cmake -G "Visual Studio 17 2022" -A x64 -T host=x64 ^
-DCMAKE_C_FLAGS="/DWIN32 /D_WINDOWS /W0 /utf-8" ^
-DCMAKE_CXX_FLAGS="/DWIN32 /D_WINDOWS /GR /EHsc /W0 /utf-8" ..
```
（以下省略）
cmake の結果の確認
エラーメッセージが出ていないこと

ビルド操作，インストール操作

cmake --build . --config RELEASE --target INSTALL

結果の確認
エラーメッセージが出ていないこと

使ってみる

Mitsuba 2 の More advanced examples のページを開く
https://mitsuba2.readthedocs.io/en/latest/src/inverse_rendering/advanced.html
サンプルファイルをダウンロード
ダウンロードした bunny.zip を展開（解凍）

レンダリングする

c:\mitsuba2\build\dist\mitsuba.exe bunny.xml

次のような画像ができる

本サイトは金子邦彦研究室のWebページである．

資料等の公開では，原則，「クリエイティブコモンズ BY NC SA」として公開するようにしている． PDFファイル，パワーポイントファイルなどには，「クリエイティブコモンズ BY NC SA」を明記するとともに，ロゴを記載するようにしている（作業が間に合っていない分もあるのでご容赦ください）．

公開している資料をご利用になる場合の，再配布の条件，剽窃の防止などについて，別ページで説明している．再配布や資料改変の際には，そのページをご確認ください．

サイトマップは，サイトマップのページをご覧下さい．本サイト内の検索は，サイト内検索のページをご利用下さい．

問い合わせ先：金子邦彦（かねこくにひこ）