「MonoGame 3.8.0以降でfxファイルをコンパイルする」を編集中

2020年5月に発表された[[MonoGame]] 3.8.0 (プレビュー版）から
[[Windows]]だけでなく、[[MacOS]]や[[Linux]]でも[[プログラマブルシェーダー]]の[[コンパイル]]ができるようになった。

[[Mac]]や[[Linux]]では内部的に[[wine]]を用いているので若干の環境構築が必要となる。

== Macでの環境構築 ==
[[homebrew]]を使った手順。

[[xquartz]]を[[インストール]]する。
<source lang="bash">
brew install --cask xquartz
</source>

[[wine]]を[[インストール]]する。
wineパッケージはstable（安定版）,devel（開発版）,staging（突撃版）の3種類ある。
* wine-stable = macOS Mojave 10.14まで、wine64を含まない
* wine-devel, wine-staging  = macOS Catalina 10.15以降にも対応、wine64を含む
このうちMonoGame 3.8で必須となる「wine64」はwine-develとwine-stagingにしか含まれていない。今回は無難に「wine-devel」を選ぶ。
<source lang="bash">
brew tap homebrew/cask-versions
brew install --cask --no-quarantine wine-devel
</source>

[[p7zip]]を[[インストール]]する。
mgfxcコンパイラは[[7z]]形式で配布されているためだ。
<source lang="bash">
 brew install p7zip
</source>

mgfxcコンパイラの[[ダウンロード]]と[[インストール]]を全自動でやってくれるスクリプトを実行する。mgfxcコンパイラなどは「$HOME/.winemonogame」ディレクトリに格納される。
<source lang="bash">
curl -O https://raw.githubusercontent.com/MonoGame/MonoGame/develop/Tools/MonoGame.Effect.Compiler/mgfxc_wine_setup.sh
chmod +x mgfxc_wine_setup.sh
./mgfxc_wine_setup.sh
</source>

上記のスクリプトで[[環境変数]]が追加される。
<source lang="bash">
 #bashの場合
 echo 'export PATH=$PATH:"/Applications/Wine Stable.app/Contents/Resources/wine/bin/"' >> ~/.profile 
 echo 'export MGFXC_WINE_PATH="$HOME/.winemonogame"' >> ~/.profile
</source>
<source lang="bash">
 #zshの場合
 echo 'export PATH=$PATH:"/Applications/Wine Stable.app/Contents/Resources/wine/bin/"' >> ~/.zprofile 
 echo 'export MGFXC_WINE_PATH="$HOME/.winemonogame"' >> ~/.zprofile
</source>

ただし.profileや.zprofileはターミナルから[[Visual Studio for Mac]]を起動した場合のみ適用され、[[macOS]]のDockまたはLaunchPadから起動した場合は適用されない。ターミナルから起動する奇特な人はあまりいないと思われる。

そこで[[launchd]]を使ってログイン時に環境変数を設定する。LaunchAgentsディレクトリにplistファイルを置けばログイン時に自動実行される。拡張子がplistならファイル名は何でもいいので今回はenvironment.plistとした。

 vi ~/Library/LaunchAgents/environment.plist

中身はこんな感じ。
<source lang="xml>
<!DOCTYPE plist PUBLIC “-//Apple//DTD PLIST 1.0//EN” “https://www.apple.com/DTDs/PropertyList-1.0.dtd”>
<plist version=“1.0”>
    <dict>
        <key>Label</key>
        <string>my.startup</string>

        <key>ProgramArguments</key>
        <array>
            <string>bash</string>
            <string>-c</string>
            <string>
launchctl setenv MGFXC_WINE_PATH "$HOME/.winemonogame"
            </string>
        </array>
        
        <key>RunAtLoad</key>
        <true/>
    </dict>
</plist>
</source>


一通り終わったら[[macOS]]から[[ログアウト]]する。
再起動でもいいぞ。

== 関連項目 ==
* [[MonoGameでプログラマブルシェーダーを使う]]
: fxファイルのコンパイル
* [[MonoGame 3.8.0以降でfxファイルをコンパイルする]]
* [[MonoGame 3.7.1以前でfxファイルをコンパイルする]]

[[category: MonoGame]]
[[category: HLSL]]