「Metalのコマンドラインツールでライブラリを構築する」の版間の差分

2020年6月25日 (木) 02:45時点における版

Metalのコマンドラインツールでライブラリを構築する

Metal Shading Language(.metalファイル)のコンパイルはXcodeやXamarin.Mac(Visual Studio for Mac)を使うと全自動で行われるので特に意識することはない。

これはSPIR-Vからmetallibファイルを生成するツールを作る際に必要になったものであり普通の人には縁のない話だと思われる。

作る

1つのソースコード（.metalファイル）は1つの中間コード（.airファイル）にコンパイルされる。

xcrun -sdk macosx metal -c vertex.metal   -o vertex.air 
xcrun -sdk macosx metal -c fragment.metal -o fragment.air

複数の中間コード（.airファイル）をリンクして最終的な１つのライブラリ（.metallibファイル）を生成する。

xcrun -sdk macosx metallib *.air -o MyLibrary.metallib

備考

当初、xcrunコマンドを叩くと以下のようなエラーがでた。

xcrun: error: unable to find utility "metal", not a developer tool or in PATH

Xcodeの「Command Line Tools」の設定が空欄になっていたのが原因のようだ。homebrewをインストールした直後はなぜか空欄になってしまうようだ。

使う

ライブラリ（.metallibファイル）をXcodeやXamarin.Macのプロジェクトに追加する。

guard let libraryFile = Bundle.main.path(forResource: "MyLibrary", ofType: "metallib") else { return }
do {
    let myLibrary = try device.makeLibrary(filepath: libraryFile)
} catch let error {
    print("Library error: \(error.localizedDescription)")
}

@@ 5行目: / 5行目: @@
 これは[[SPIR-V]]からmetallibファイルを生成するツールを作る際に必要になったものであり普通の人には縁のない話だと思われる。
-== 作る ==
+==作る==
 つの[[ソースコード]]（.metalファイル）は1つの[[中間コード]]（.airファイル）にコンパイルされる。
   xcrun -sdk macosx metal -c vertex.metal   -o vertex.air
@@ 13行目: / 13行目: @@
   xcrun -sdk macosx metallib *.air -o MyLibrary.metallib
-== 備考 ==
+===備考===
 当初、xcrunコマンドを叩くと以下のようなエラーがでた。
   xcrun: error: unable to find utility "metal", not a developer tool or in PATH
@@ 19行目: / 19行目: @@
 Xcodeの「Command Line Tools」の設定が空欄になっていたのが原因のようだ。[[homebrew]]を[[インストール]]した直後はなぜか空欄になってしまうようだ。
-== 使う ==
+[[ファイル:Xcode-command-line-tools-setting.png|フレームなし|640x640ピクセル]]
+==使う==
 ライブラリ（.metallibファイル）をXcodeやXamarin.Macのプロジェクトに追加する。
@@ 30行目: / 32行目: @@
 }
 </source>
 [[category: Metal]]