Überblick

Projektkonfigurationsdateien sind die komplexesten und umfangreichsten Dateien, die zum Konfigurieren von Substance 3D Designer verwendet werden.

Sie sind insofern besonders, als Sie mehrere Projektkonfigurationsdateien verwenden können, bei denen jedes nächste “untergeordnete” Projekt das vorherige “übergeordnete” Projekt erweitert oder überschreibt. Sofern nicht ausdrücklich erforderlich, sollten die Einstellungen nicht geändert oder den Projektdateien hinzugefügt werden, sodass Designer auf die übergeordnete Konfiguration oder sogar auf die Standardeinstellungen zurückgreifen kann.

Standardmäßig sind in Designer zwei Projektkonfigurationen aktiv:

Standardprojekt: Enthält alle Standardeinstellungen und die Designer-Bibliothek wird bei einer Neuinstallation mitgeliefert.Schreibgeschützt, kann nicht geändert oder entfernt werden.

Benutzerprojekt: Da die Standardwerte schreibgeschützt sind, werden alle Änderungen des Benutzers standardmäßig in dieses Projekt übernommen. Kann nicht entfernt werden.

Dieses grundlegende Setup stellt sicher, dass die Standardbibliothek und andere Einstellungen nicht beschädigt oder geändert werden können, aber dennoch einzelnen Amateurbenutzern erlaubt, ihre eigenen Änderungen hinzuzufügen, ohne sich mit komplexen Einstellungen zu beschäftigen.

Erweitern oder Überschreiben

Die meisten Einstellungen in einem aufeinander folgenden Projekt überschreiben die Einstellungen aus dem vorherigen Projekt. Beispielsweise überschreibt ein anderes Tangent Space-Plug-in in einer benutzerdefinierten Projektdatei jedes im Standard- oder Benutzerprojekt definierte TS-Plug-in. Dies bedeutet, dass es empfohlen wird, Einstellungen in untergeordneten Projekten nicht zu überschreiben oder zu ändern, sofern dies nicht explizit erforderlich ist.

Es gibt jedoch einige Einstellungen, die nach den übergeordneten Einstellungen erweitert werden, anstatt sie zu überschreiben. Diese Einstellungen sind vor allem die Bibliothekspfade und Filter. Daher fügen Sie der Bibliothek immer mehr Inhalt hinzu, anstatt ihn zu überschreiben. Darüber hinaus werden die Aliasse (Pfadschlüsselwörter für relative Dateipfade) erweitert und überschrieben, wenn ein Duplikat definiert ist. Dies ermöglicht eine hervorragende Kontrolle über die Pfade und Referenzen der Inhaltsdatei.

Inhalt der Projektdatei

Projektdateien können die folgenden Einstellungen enthalten:

3D-Ansicht: Standardschattierungs-, HDR- und Szenenstatusdefinitionen.

Aliase: Stichwortaliasse für relative Pfade.

Baking: Einstellungen für das Baking von Namenskonventionen.

Allgemein: Standardeinstellungen für Graf-Vorlagen, Tangentialraum-Plug-ins, normale und Bildformate.

Bibliothek: Überwachte Pfade zur Anzeige in der Bibliothek.

Skripterstellung: Rückrufskripts und Interpreter.

Versionskontrolle: Einstellungen für die Integration von Versionskontrolle in Designer.

Ändern von Projektdateien

Projektkonfigurationen werden wie alle anderen Typen als strukturierte XML-Dateien gespeichert (mit einer .sbsprj-Erweiterung), die über die Designer-Benutzeroberfläche oder einen externen Texteditor geändert werden können.

Inside Substance 3D Designer

Weitere Informationen zum Verwalten von Projektdateien und zum Ändern von Projekteinstellungen finden Sie auf der Seite Projekteinstellungen.

Projektdateien enthalten auch benutzerdefinierte Kategorien und Filter für die Bibliothek. Weitere Informationen erhalten Sie auf der Seite Verwalten von benutzerdefiniertem Inhalt und Filtern.

Externes Bearbeiten von XML

Unter Windows ist Notepad++ eine gute kostenlose Option. Unter macOS ist Sublime Text eine Alternative. Das heißt, jeder Editor mit korrekter Einrückung, Abschnittsreduzierung und irgendeiner Form von Syntax-Hervorhebung wird Ihnen das Leben viel leichter machen.

Sobald Sie die SBSPRJ-Datei in einem Editor geöffnet haben, sollten Sie ein relativ einfaches strukturiertes Layout sehen, mit Abschnitten, die den Registerkarten in der Benutzeroberfläche entsprechen. Nicht jede Einstellung wird hier dokumentiert, da es ziemlich selbsterklärend ist.

Relative Pfade und Aliasse

Relative Pfade in Kombination mit Aliasen sind einer der komplizierteren, aber wichtigsten Teile einer Projektkonfiguration. In diesem Abschnitt werden sie erläutert. Das Hinzufügen benutzerdefinierter Aliase für eine bestimmte Projektdatei erfolgt in den Projekteinstellungen.

Eines der Hauptprobleme bei Dateien, die auf andere Dateien in einem System auf dem PC mehrerer Benutzer verweisen, ist, dass absolute Dateipfade nicht funktionieren. Benutzer können ihre SVN-Repositorys an völlig anderen Speicherorten definieren (z. B. C:/John/Gamedev/SubstanceLibrary oder D:/Dev/SubstanceLibrary). Aliase und relative Pfade arbeiten beide zusammen, um dieses Problem zu lösen. Andernfalls können Sie die Datei einer anderen Person öffnen und es wird versucht, nach dem benutzerdefinierten Knoten zu suchen, der an dem bestimmten Speicherort verwendet wird, an dem der Benutzer die Datei lokal gespeichert hat, was Sie wahrscheinlich nicht genau auf die gleiche Weise definiert haben.

Ein Alias ist ein Schlüsselwort, das (einen Teil) eines Pfads ersetzt. Es ähnelt einer Windows-Umgebungsvariable wie %TEMP%, bei der ein einzelnes Wort einen häufig verwendeten Pfad ersetzt, der dann zentral definiert wird. Der Vorteil ist, dass alle Pfade vereinfacht sind und Sie alle Referenzen auf einmal ändern können, wenn Sie diesen Pfad verschieben möchten.

Relative Pfade sind immer relativ zu der Datei, in der sie definiert sind. Das bedeutet, dass der aktuelle Speicherort der Konfigurationsdatei den größten Teil des Pfads bestimmt und Alias-Pfade darauf basieren, hauptsächlich durch Hinzufügen eines Unterordners. Es wird daher dringend empfohlen, die sbsprj-Dateien neben den Ordnern abzulegen, die Sie ansehen möchten!

Nehmen Sie beispielsweise ein Repository unter C:/Versioncontrol/Substance/ mit CustomProject.sbsprj und dann zwei Ordnern, /Base und /Tools, mit Knoten.

Das Definieren von zwei relativen Aliasen für “Basis” und “Werkzeuge” würde wie folgt in der SBSPRJ-Datei durchgeführt:

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>

Das Ergebnis dieser Konfigurationsdatei lautet:

BaseAlias:// ist C:/Versioncontrol/Substance/Base/ und ToolsAlias:// ist C:/Versioncontrol/Substance/Tools/.

Wenn Sie nur C:/Versioncontrol/Substance/ definieren möchten, wird der Pfad als “file:.” angegeben, wobei der Punkt den Speicherort der Datei selbst angibt.