月: 2023年11月

投稿日: カテゴリー Program

premake5覚書

こんねね～。Pocolです。
premake5の覚書をしておこうと思います。

XBox系のプラットフォームの場合は，Billzard社がpremake-consolesというGithubリポジトリを公開しているので，これを使えばよさそうです。
https://github.com/Blizzard/premake-consoles

で，青いプラットフォームの場合は，これまたBillzard社がソースコードをフォーラムにて公開しているので，それを使えばいいです。

問題はこれらが使えない場合です。既にpremake作っちゃっているやつとか，これから出てくる新規プラットフォームの場合とかですね。
自力で実装する必要があります。ほとんどの場合はSDKがC++だと思われるので，C++のコンパイルは問題なく対応できるでしょう。
じゃ、何が問題か？
そうです。前回やったシェーダ設定ですね。恐らく問題になるでしょう。
SDKでVS拡張が提供されている場合は，プロジェクトファイルに記述すればいいので，premakeを拡張していけばいいです。

やり方としては，
https://github.com/premake/premake-core/blob/master/modules/vstudio/vs2010_vcxproj.lua
のFxCompileおよびfxCompileで記載されている箇所を参考にします。

premake用に公開するAPIは，
https://github.com/premake/premake-core/blob/master/modules/vstudio/_preload.lua
のshadertypeとか，shadermodel，shaderincludedirsあたりを参考にLuaに実装を付け足します。

先ほど言った、VS拡張が提供されている場合はこんな感じでいいのですが，じゃ、提供されていない場合はどうすればいいでしょうか？
残念ながら，自分で作るしかないですね。

作り方については，以前に書いた「カスタムビルドルール！」と「Visual Studioと格闘中…。」の記事で紹介しているので，これを参考に実装すれば良いでしょう。

…ということでコンソールプラットフォーム用のpremakeのシェーダビルド対応について，覚書を書いてみました。
殆どの人には，全く役に立たないんですが，自分だけには役立つというしょうもない記事でした。

投稿日: カテゴリー Program

premake5でシェーダ設定する

こんこよー。Pocolです。

ちと分け合って，premake5でプロジェクトを作成する際に，シェーダのコンパイル設定を含めてしまいたいな～と思いました。
premake5からHLSLがサポートされているようなので，実際に書いてみました。
リポジトリは下記です。
https://github.com/ProjectAsura/premake_test

プロジェクトを生成するluaは下記のような感じで書きます。

local project_dir="project"
location(project_dir)

-- ソリューション名.
workspace "SampleSolution"
    -- 構成名.
    configurations { "Debug", "Develop", "Release" }

-- プロジェクト名.
project "SampleProject"

    kind "ConsoleApp"
    language "C++"

    -- 出力ディレクトリ.
    targetdir "bin/%{cfg.buildcfg}"

    -- インクルードディレクトリ.
    includedirs { "include/**" }
    shaderincludedirs { "$(ProjectDir)../res/shader" }

    -- 対称ファイル
    files { "**.h", "**.cpp", "**.hlsl", "**.hlsli" }

    -- シェーダモデルとエントリー名設定.
    shadermodel "6.5"
    shaderentry "main"

    -- ヘッダ変数名とヘッダーファイル名設定.
    shadervariablename "%%(Filename)"
    shaderheaderfileoutput "$(ProjectDir)../res/shader/Compiled/%%(Filename).inc"

    -- シェーダヘッダファイル設定.
    filter { "files:**.hlsli" }
        flags "ExcludeFromBuild"

    -- 頂点シェーダ設定.
    filter { "files:**_vs.hlsl" }
        shadertype "Vertex"

    -- ピクセルシェーダ設定.
    filter { "files:**_ps.hlsl" }
        shadertype "Pixel"

    -- コンピュートシェーダ設定.
    filter { "files:**_cs.hlsl" }
        shadertype "Compute"

    -- ジオメトリシェーダ設定.
    filter { "files:**_gs.hlsl" }
        shadertype "Geometry"

    -- ドメインシェーダ設定.
    filter { "files:**_ds.hlsl" }
        shadertype "Domain"

    -- ハルシェーダ設定.
    filter { "files:**_hs.hlsl" }
        shadertype "Hull"

    -- 増幅シェーダ設定.
    filter { "files:**_as.hlsl" }
        shadertype "Amplification"

    -- メッシュシェーダ設定.
    filter { "files:**_ms.hlsl" }
        shadertype "Mesh"

    -- 構成設定.
    filter { "configurations:Debug" }
        defines {"DEBUG"}
        shaderdefines {"DEBUG=1"}
        symbols "On"
    filter { "configurations:Develop" }
        defines {"NDEBUG"}
        shaderdefines {"NDEBUG=1"}
        optimize "On"
        symbols "On"
    filter { "configurations:Release" }
        defines {"NDEBUG"}
        shaderdefines {"NDEBUG=1"}
        optimize "On"

このluaファイルを使って，サンプルのリポジトリで下記のコマンドで，プロジェクトを生成します。

.\premake5.exe vs2022 --file=my_premake.lua

プロジェクトを生成すると projectフォルダが出来上がり，そこにソリューションファイルが作成されます。ソリューションファイルを開くと次の画像のような感じになります。

シェーダファイルのプロパティを見ると次のように設定されているはずです。

これで，シェーダのビルドが出来るようになるはずです。
下記のPremakeドキュメントに設定できる項目が記載されているので，より細かい設定をしたい方はドキュメントを参照すると良いと思います。

…ということで，premake5でのシェーダ設定方法について紹介してみました！