概要

プロジェクト構成ファイルは、Substance 3D Designerの構成に使用される、最も複雑で拡張性の高いファイルです。

次の「子」プロジェクトが前の「親」を展開またはオーバーライドする複数のプロジェクト設定ファイルを使用できるという点で特別です。 Designerは、明示的に必要な場合を除き、親の設定やデフォルト設定に頼ることができるため、設定を変更したりプロジェクトファイルに追加したりしないでください。

デフォルトでは、Designerには2つのアクティブなプロジェクト設定があります。

既定のプロジェクト： すべての既定の設定が含まれます。Designerは新規インストール時に付属しています。読み取り専用です。変更または削除できません。

ユーザープロジェクト： 既定は読み取り専用であるため、ユーザーによるすべての変更​は既定でこのプロジェクトに反映されます。 削除できません。

この基本的な設定により、デフォルトのライブラリやその他の設定を壊したり変更したりすることはできませんが、それでも単一のアマチュアのユーザーが複雑な設定を気にすることなく自分の変更を追加することができます。

展開またはオーバーライド

連続するプロジェクトのほとんどの設定は、前のプロジェクトの設定よりも 優先 されます。 例えば、カスタムプロジェクトファイル内の別の接線空間プラグインは、デフォルトまたはユーザープロジェクトで定義されているTSプラグインを上書きします。 したがって、明示的に必要な場合を除き、子プロジェクトの設定を上書きまたは変更しないことをお勧めします。

ただし、親の設定を上書きするのではなく、親の設定に対して 展開 する設定もあります。 これらの設定で最も顕著なのは、ライブラリパスとフィルターであるため、ライブラリを上書きするのではなく、常にライブラリにコンテンツを追加します。 さらに、エイリアス（相対ファイルパスのパスキーワード）が展開され、重複が定義されている場合はオーバーライドされます。 これにより、コンテンツファイルパスと参照を詳細に制御できます。

プロジェクトファイルの内容

プロジェクトファイルには、次の設定を含めることができます。

3D ビュー: 既定のシェーダー、HDR、およびシーンの状態の定義。

エイリアス： 相対パスのキーワードエイリアス。

ベイク: 名前付け規則をベイクするための設定です。

全般： グラフテンプレート、接線空間プラグイン、標準および画像形式の既定値。

ライブラリ： ライブラリに表示する監視対象のパス。

スクリプト： コールバックスクリプトとインタープリター。

バージョン管理: バージョン管理をDesignerに統合するための設定。

プロジェクトファイルの変更

プロジェクトの構成は、他のすべての種類と同様に、（.sbsprjという拡張子を持つ）構造化XMLファイルとして保存されます。このファイルは、Designer UIまたは外部テキストエディターを使用して変更できます。

Substance 3D Designer内

プロジェクトファイルの管理およびプロジェクト設定の変更の詳細については、プロジェクト設定ページを参照してください。

プロジェクトファイルには、ライブラリのカスタム カテゴリ と フィルター も含まれています。これらの詳細については、カスタムコンテンツとフィルターの管理ページで確認できます。

XMLを外部編集

Windowsの場合、メモ帳++は無料で利用できます。 macOSでは、Sublime Textは代替手段です。 しかし、適切なインデント、セクションの折りたたみ、構文の強調表示を備えたエディターであれば、作業が非常に簡単になります。

エディターでSBSPRJファイルを開くと、UIのタブに対応するセクションを含む、非常に単純な構造化レイアウトが表示されます。 全ての設定がここで文書化されるわけではありません。

相対パスとエイリアス

エイリアスと組み合わされた相対パスは、プロジェクト構成の中でもより複雑で最も重要な部分の1つです。このセクションではそれらの点を明確にします。 特定のプロジェクトファイルに対してカスタムエイリアスを追加する操作は、プロジェクト設定で行います。

ファイルが複数のユーザーのPCでシステム内の他のファイルを参照する場合の大きな問題の1つは、絶対ファイルパスが機能しないことです。 ユーザーは、完全に異なる場所にSVNリポジトリを定義できます。 C:/John/Gamedev/SubstanceLibraryまたはD:/Dev/SubstanceLibrary)。 エイリアスと相対パスの両方が連携してこの問題を解決します。 他のユーザーのファイルを開いて、ローカルにあるユーザーの特定の場所で使用されているカスタムノードを探す場合があります。この場合、同じ方法で定義されている可能性は低くなります。

エイリアスは、パスの一部を置き換えるキーワードです。 これは、%TEMP%のようなWindows環境変数に似ています。この環境変数では、1つの単語で頻繁に使用されるパスが置き換えられ、そのパスが一元的に定義されます。 この機能の利点は、あらゆる場所のパスが単純化されることと、このパスを再配置することにした場合にすべてのリファレンスを一度に変更できることです。

相対パスは、常に定義されているファイルに対する相対パスです。 つまり、設定ファイルの現在の場所によってパスの大部分が決定され、主にサブフォルダーを追加するだけで、それに基づいてエイリアスパスが決定されます。 したがって、sbsprjファイルは、監視するフォルダーの横に配置することを強くお勧めします。

例えば、CustomProject.sbsprj​を含む​ C:/Versioncontrol/Substance/ ​にあるリポジトリと、ノードを含む​ /Base ​および​ /Tools, ​の2つのフォルダーを考えてみましょう。

BaseとToolsの2つの相対エイリアスを定義するには、SBSPRJファイル内で次のように指定します。

C:/Versioncontrol/Substance/CustomProject.sbsprj

   <urlaliases>

    <size>2</size>

    <_2 prefix="_">

     <path>file:Base</path>

     <name>BaseAlias</name>

    </_2>

    <_1 prefix="_">

     <path>file:Tools</path>

     <name>ToolsAlias</name>

    </_1>

   </urlaliases>

この構成ファイルの結果は次のようになります。

BaseAlias://​は​ C:/Versioncontrol/Substance/ベース/ ​になり、ToolsAlias://​は​ C:/Versioncontrol/Substance/ツール/. ​になります。

C:/Versioncontrol/path/​のみを定義する場合、Substanceは​ "file:." ​と表示され、ファイル自体の場所を示すドットが表示されます。