DokumentationSubstance 3DSubstance 3D Designer

Projekteinstellungen

Letzte Aktualisierung: 11. September 2026

Auf dieser Seite werden die Projekteinstellungen in Substance 3D Designer und die darin enthaltenen Einstellungen angezeigt.

Mit Substance 3D Designer können Sie Voreinstellungen pro Projekt erstellen und auf Workstations freigeben. Diese Voreinstellungen finden Sie auf der Registerkarte Projekte im Fenster Voreinstellungen.

Dies ist sehr hilfreich, wenn Sie eine gemeinsame Arbeitsumgebung für ein Team einrichten möchten, das an demselben Projekt arbeitet, indem Sie die gleiche Projektdatei auf allen Systemen verwenden.

NOTE
Weitere Informationen zum Einrichten und Integrieren von Substance 3D Designer in einer Produktionspipeline erhalten Sie, wenn ausdrücklich empfohlen wird, auf den Abschnitt Pipeline und Projektkonfiguration der Dokumentation zu verweisen.

Projekteinstellungen {modal="regular"}

Konfiguration

Konfigurationsdatei

Dadurch können Sie den Pfad der Konfigurationsdatei für Substance 3D Designer festlegen. Eine Konfigurationsdatei verwendet die Erweiterung “*.sbscfg” und enthält eine Liste der Projektdateien zusammen mit einer festgelegten Kompatibilitätsanzeigeeinstellung.

Standard: default_configuration.sbscfg

NOTE
Sie können die Befehlszeilenoption "—config-file" verwenden, um Designer mit einer bestimmten Konfigurationsdatei zu starten.
Weitere Informationen zu Konfigurationsdateien finden Sie auf der Seite Konfigurationsliste - SBSCFG der Dokumentation.

Projektdateien

Eine Projektdatei enthält eine Reihe von Einstellungen, die die wichtigsten Aspekte der Arbeitsumgebung in Designer definieren. Diese Einstellungen sind in Registerkarten unterteilt. Diese Einstellungen sind im Kapitel “Projekt” auf dieser Seite aufgeführt. Projektdateien verwenden die Erweiterung *.sbsprj.

Sie können mehrere Projektdateien importieren, die in Ihrer Arbeitsumgebung in Designer verwendet werden sollen. Wenn mehrere Projektdateien vorhanden sind, werden Einstellungen, die Listen sind (z. B. von der Bibliothek überwachte Pfade, Aliasse usw.), kombiniert sind und Einstellungen, die eindeutige Satzwerte sind, durch die letzte Projektdatei der Liste definiert sind.

Standard: default_project.sbsprj (schreibgeschützt), user_project.sbsprj

NOTE
Weitere Informationen zur Verwendung von Projektdateien in einer Produktionspipeline finden Sie auf der Seite Projektkonfigurationsdateien - SBSPRJ der Dokumentation.

Kompatibilitätsanzeige

Einige der mit einer neueren Version von Designer erstellten Knoten sind nicht mit älteren Versionen des Substance Engine kompatibel.

Im Kompatibilitätsmodus werden die Knoten hervorgehoben, die nicht mit dem ausgewählten Substance Engine kompatibel sind, mit einer gelben Kontur.

Standard: Substance Engine v7

3D-Ansicht

Standard-Renderer
Mit dieser Einstellung können Sie den 3D-Renderer auswählen, der standardmäßig verwendet werden soll, wenn ein neuer 3D-Ansicht.

Standard: Standard (vordefinierter Renderer)
Standard-Shader
Mit dieser Einstellung können Sie den Shader auswählen, der standardmäßig verwendet werden soll, wenn Sie eine neue 3D-Ansicht ​

Standardeinstellung: open_pbr.glslfx
Standard-Umgebungs-Map
Mit dieser Einstellung können Sie die Textur auswählen, die standardmäßig auf die Umgebung angewendet werden soll, wenn new 3D-Ansicht ​

Standard: panorama_map.hdr
Standardstatusdatei
Die 3D-Ansicht Szene-Statusdatei umfasst eine Reihe von Einstellungen für die 3D-Ansicht, z. B. Kamera-Position, Umgebungsbelichtung und Mesh. Es wird verwendet, um den Status der 3D-Ansicht zu speichern, sodass Sie schnell eine Szene laden können, die auf Ihre Bedürfnisse zugeschnitten ist. Szene-Statusdateien verwenden die Erweiterung *.sbsscn.Mit dieser Einstellung können Sie die Statusdatei der 3D-Ansicht-Szene auswählen, die beim Starten einer neuen 3D-Ansicht verwendet werden soll. Warnung: Einige Softwareupdates können die Art und Weise ändern, wie Szenen gespeichert/geladen werden. Wenn die Szene nicht korrekt wiederhergestellt wurde, wird empfohlen, den gewünschten Status der Szene manuell festzulegen und die Szene-Statusdatei, die Sie als Standard verwenden, erneut zu exportieren.

Standard: Leer (in diesem Fall wird ein voreingestellter Szene-Status verwendet)
Standardbeleuchtungsstatus
Mit dieser Einstellung können Sie auswählen, welche der vordefinierten verfügbaren 3D-Ansichten aktiviert werden soll, wenn eine neue Datei mit dem Status 🔗, gestartet wird, wenn keine Datei im Feld StandardstatusdateiStandard: Nur Umgebungslicht **

Aliase

Aliase werden verwendet, um Systempfade zu verkürzen und es Teams zu ermöglichen, Assets effizienter freizugeben. Aliase werden in der gesamten Software sowie in SBS-Dateien verwendet.

Mit diesen Einstellungen können Sie Aliase hinzufügen und bearbeiten. Wenn ein Alias angewendet wird, ersetzt ** den zugeordneten Pfad mithilfe der folgenden Syntax: ://

Beispiel: Wenn eine Ressource “myResource” im Ordner “myFolder” am Speicherort “C:/Users/user/Documents” platziert wird, führt die Zuordnung dieses Speicherorts zu “myalias” dazu, dass der Pfad “myalias://myFolder/myResource” in der Anwendung “" und "” im SBS-Paket, zu dem die Ressource gehört, verwendet wird.

Standard: sbs; sd-3dview-shapes; sd-3dview-maps; sd-3dview-shaders (Standardprojekt)

WARNING
Für die Anwendung sind Aliase global. Dies bedeutet, dass sie auf alle in der Anwendung verwendeten Pfade sowie auf alle Pfade in geladenen SBSPRJ-Projekteinstellungsdateien angewendet werden. Berücksichtigen Sie dies beim Einrichten Ihrer Projektumgebung!
Außerdem wird empfohlen, keine Aliase zu verschachteln, d. h. einen Pfad zu aliasing, der auch in einem anderen Alias enthalten ist.

Baker

Standardressourcenname
Mit dieser Einstellung können Sie eine standardmäßige -Benennungsvorlage festlegen, die für die Ausgabebilddateien verwendet wird. Die Aliase, die im Backing-Fenster verfügbar sind, können auch hier verwendet werden (d. h. $(mesh), $(bakername), $(udim), $(custom))

Standard: $(mesh)_$(bakername)
Standardvorgabe
Wenn Sie das Backing-Fenster öffnen, können Sie es bereits mit bestimmten Backern und Einstellungen konfigurieren lassen, indem Sie mit dieser Option auf eine Voreinstellungsdatei JSON verweisen. Diese Datei kann aus dem Backfenster exportiert werden, nachdem sie gemäß Ihren Anforderungen eingerichtet wurde

Standard: Keine
Namensfiltermodus

Das Szenenobjekt, dessen Name für den Abgleich der Objekte mit niedrigem und hohem Poly verwendet werden soll:

  • Geometriename: den Namen des Gittergeometrieobjekts verwenden
  • Übergeordneter Name (veraltet): den Namen des übergeordneten Objekts für die Gittergeometrie verwenden (wie in Designer 14.1 und niedriger)

Standard: Geometriename

Ressourcenname-Makros
Anstelle des Alias $(bakername) können Sie Ihre eigenen Zeichenfolgen für jeden Baker verwenden. Wenn der Alias “$(custom)” im Namen des Ausgabebilds für einen Bäcker verwendet wird, wird er durch die Zeichenfolge ersetzt, die mit diesem Bäcker in der Liste übereinstimmt. Wenn eine Zelle in der Liste, die einem Bäcker entspricht, leer gelassen wird, wird der Alias $(custom) für diesen Bäcker nicht ersetzt.Beispiel: Der dem Baker “Kurvenkarte aus Gitter” zugewiesene Wert “c-mesh” benennt automatisch t_mymesh_​$(custom) in t_mymesh_​c-mesh für die Ausgabe des Bäckers “Kurvenzeichner aus Gitter” um *nur *

Standard: Keine
Namensfilter für Teilnetze
Bei Verwendung der Option “Match By Name” in “bakers” sind die Teile der Low- und High-Definition-Versionen eines Gitters identisch, wenn der Name dieser Teile vor den definierten Suffixen identisch ist. Mit dieser Einstellung können Sie Ihre eigenen Suffixe für Ihren spezifischen Workflow festlegen. Passende Teile von Gittern können dazu führen, dass Strahlen unerwünschte Geometrie bei Backvorgängen ignorieren.Beispiel: Das body-torso​_low-Objekt im body.fbx-Gitter würde mit dem body-torso​_high ​-Objekt in body_high.fbx, übereinstimmen, wenn diese Objekte vorhanden sind in diesen Gittern .Standard: _low (Gitter mit niedriger Polung) / _high (Gitter mit hoher Polung)Ebenso können ​ Hintergrundflächen​selektiv ignoriert werden für die Teile eines Gitters, deren Name das definierte ​ Suffix​enthält, für spezifische Bäcker, die die ​ Option “Hintergrundfläche ignorieren”** enthalten. Standardeinstellung: _ignorebf

Hinweis: Die Suffixe “Hintergrundfläche ignorieren” und “Gitter mit niedriger/hoher Polung” können * in beliebiger Reihenfolge kombiniert werden (z. B. Body-Torso_low_ignorebf)

*

Farbmanagement

Weitere Informationen finden Sie auf der Seite Farbmanagement.

WARNING
Die Änderungen an diesen Einstellungen werden nach dem Neustart von Designer wirksam.

Allgemein

Substance von Vorlagen
Wenn Sie ein neues Diagramm erstellen, werden Sie aufgefordert, mit der Arbeit an einer Vorlage zu beginnen, die eine Reihe von Einstellungen und Inhalt vorkonfiguriert enthalten kann, z. B. Ausgaben (z. B. PBR (Metallic/Roughness)).Mit dieser Einstellung können Sie Designer auf Verzeichnisse verweisen, in denen Sie Ihre eigenen SBS-Dateien zur Verwendung als Vorlagen speichern können. Ihre benutzerdefinierten Vorlagen werden dann der Liste hinzugefügt, wenn ein neues Diagramm erstellt wird

*Standard: Keine *

Hinweis: Wir empfehlen, die aktuellen Vorlagen als Referenz für die Konfiguration und Formatierung Ihrer SBS-Vorlagendateien zu verwenden. Die Vorlagen befinden sich im Ordner Ressourcen > Vorlagen im Substance 3D Designer-Installationsverzeichnis.
3D-Szenen
Standardmäßig verwendet Designer den Tangentenraum MikkT in der 3D-Ansicht. MikkT wird häufig verwendet und ist die Standardeinstellung in Programmen wie Unity, Unreal Engine 4, Blender und xNormal. Sie können Ihren eigenen Tangentenraum für die 3D-Ansicht verwenden, den Sie Designer in Form einer DLL-Datei in dieser Einstellung zur Verfügung stellen. Die Bezeichnung wird automatisch in der DLL-Datei erkannt, und Sie können die Beschreibung für das Plug-In bearbeiten

Standard: mikktspace.dll Tangentenrahmen immer neu berechnen

Standard: Deaktiviert Normal und Tangentialglättungswinkel

Standard: 180.0°
Sonstiges
Normale Zuordnungen können mit dem Format DirectX oder OpenGL generiert oder verarbeitet werden. Diese Einstellung legt den Wert für dieses Format an mehreren Stellen fest, z. B. Materialeigenschaften in der 3D-Ansicht und die Normal-Filterknotenparameter.

Standard: DirectX

In Bezug auf den Filterknoten Normal können Sie den Standardwert für den Parameter Alpha Channel Content festlegen. Sie können entweder festlegen, dass der Alpha-Wert in allen Fällen auf 1 gesetzt wird, oder ihn mit Informationen aus der Eingabe füllen.

Standard: Alpha auf 1 erzwingen
Bildformate
Dadurch können Sie die Standardformateinstellungen für exportierte Bilder

Standard festlegen: Standard (BMP)/Piz-basiertes Wavelet, nicht aktiviert, nicht aktiviert (EXR)/nicht aktiviert, nicht aktiviert, 75 (JPG)/Beste Geschwindigkeit, nicht aktiviert (PNG)/Standard (TGA)/LZW (TIF)/nicht aktiviert, 75 (WEBP)
Abhängigkeitspfade

SBS Pakete haben im Allgemeinen Abhängigkeiten, d. h. die Abhängigkeit von externen Ressourcen wie anderen SBS, Bitmaps oder Vektordateien.
Diese Abhängigkeiten, die im Abhängigkeitsmanager aufgeführt sind, werden gespeichert und im SBS mit einem Pfad referenziert, der auf diese Ressourcen verweist.

Für Abhängigkeiten, die den gleichen Pfad wie das SBS-Paket enthalten (d. h. sie befinden sich an denselben Speicherorten oder Unterordnern von diesem Speicherort), wird der Verweispfad relativ zu dem Speicherort des SBS-Pakets geschrieben.

Beispiel: für ein SBS Paket myproject/mypackage.sbs, ein Bild myproject/myfolder/myimage.png wird auf myfolder/myimage.png verwiesen. Pfad in mypackage.sbs).

Für Abhängigkeiten, die nicht enthalten, den gleichen Pfad wie das SBS-Paket (d. h. sie befinden sich an einem anderen Speicherort als das SBS-Paket), können Sie auswählen, wie der Pfad geschrieben wird.

Wenn sie auf relative Pfade festgelegt ist, wird auf die Ressource auf die gleiche Weise wie oben beschrieben verwiesen.

Beispiel: für ein SBS-Paket myparentfolder/myproject/mypackage.sbs, ein Bild myparentfolder/myotherfolder/myimage.png wird auf …/myotherfolder/myimage.png verwiesen. Pfad in mypackage.sbs.

Wenn sie auf absolute Pfade festgelegt ist, wird die Ressource durch ihren vollständigen Systempfad referenziert.

Beispiel: für ein SBS-Paket myparentfolder/myproject/mypackage.sbs, ein Bild myparentfolder/myotherfolder/myimage.png wird auf diesen vollständigen Pfad in mypackage.sbs verwiesen.

Standard: …Relative Pfade.

Hinweis: Das Verschieben der Ressourcen unterbricht in allen Fällen Abhängigkeiten , was zu Ghost instance Knoten in Diagrammen führt. Um alle Abhängigkeiten in einem einzelnen Projektordner zusammen mit dem SBS-Paket zu konsolidieren, können Sie den Export mit Abhängigkeiten verwenden… Features im Bereich Explorer. Dadurch wird ein eigenständiger -Projektordner erstellt, der frei verschoben werden kann.

Bibliothek

In diesem Abschnitt können Sie den benutzerdefinierten Inhalt der Bibliothek verwalten.

Der Inhalt aller Ordner, die in der Liste Hinzugefügte Pfade aufgeführt sind, wird in die Bibliothek aufgenommen. Änderungen am Inhalt werden in der Bibliothek nach einem Aktualisierungszeitraum widergespiegelt, der in der Bibliothek Registerkarte des Fensters Voreinstellungen festgelegt werden kann.

In den Spalten der Liste finden Sie Optionen, die Ihnen eine detailliertere Kontrolle darüber geben, wie der Inhalt dieser Ordner der Bibliothek hinzugefügt wird:

  • Aktiviert: Der Inhalt des Ordners wird in der Bibliothek angezeigt (Standard: Aktiviert)
  • Rekursiv: Der Inhalt aller untergeordneten Ordner wird auch in der Bibliothek angezeigt (Standard: Aktiviert)
  • Muster ausschließen: Dateien, deren Name mit dem eingegebenen Regex (regulärer Ausdruck) übereinstimmt, sind nicht, die in der Bibliothek angezeigt werden (z. B. wip-*) . Weitere Informationen zur Syntax für reguläre Ausdrücke finden Sie hier
  • Erweiterung ausschließen: Dateien, die Erweiterung die Eingabetextzeichenfolge enthalten, sind nicht, die in der Bibliothek angezeigt werden. Mehrere Zeichenfolgen sollten durch ; Semikolons getrennt werden. (E.g. jpg;png;tif;fbx)

Wenn SBS-Pakete zur Bibliothek hinzugefügt werden, können die Diagramme und Ressourcen, die darin enthalten sind, in der Bibliothek als separate Einträge angezeigt werden, wenn ihr Parameter Sichtbar in Bibliothek auf “Ja” festgelegt ist.
Es sind Optionen verfügbar, mit denen definiert werden kann, ob dieser Parameter beim Erstellen/Hinzufügen eines neuen Diagramms oder einer neuen Ressource in einem Paket standardmäßig auf ‘Yes’ ** festgelegt werden soll.

Standard: Aktiviert

Wenn ein in der Library enthaltenes Photoshop-Dokument (*.PSD-Datei) mehrere Ebenen enthält, können Sie den Inhalt von* jeder Ebene als separaten Bildeintrag* in der Library anzeigen.

Standard: Aktiviert

NOTE
Ihre benutzerdefinierten Ressourcen werden der Bibliothek hinzugefügt. Möglicherweise ist nicht sichtbar, da die Filterregeln für die vorhandenen Bibliothekskategorien festgelegt wurden. Wir empfehlen, eigene Filter zu erstellen, die in Ordnern organisiert sind, um sicherzustellen, dass Ihre Inhalte während der Arbeit an Ihren Projekten zuverlässig gefunden werden können.
Weitere Informationen finden Sie im Abschnitt Verwalten von benutzerdefiniertem Inhalt und Filtern der Dokumentation.

Python

Substance 3D Designer lädt automatisch alle Plug-ins, die sich in den Ordnern befinden, die Sie der Liste URL hinzufügen.

Standard: Keine

WARNING
Die Änderungen an diesen Einstellungen werden nach dem Neustart von Designer wirksam.
Plug-In-Pakete müssen noch manuell mithilfe des Plug-In-Managers installiert werden.

Skripting

WARNING
Diese Funktion wird in einer zukünftigen Version eingestellt sein und die robustere Python-API unterstützen. Daher empfehlen wir, den Wechsel in Ihren Skripten so schnell wie möglich vorzunehmen.
Sie können die Seite Anwendungsrückrufe im Abschnitt Skripterstellung unserer Dokumentation aufrufen, um loszulegen.

In diesem Abschnitt können Sie Skripte einrichten und steuern, die ausgeführt werden sollen, wenn bestimmte Ereignisse in Designer stattfinden. Dies ist besonders nützlich, wenn es in Verbindung mit der Perforce-Integration verwendet wird, die auf der Registerkarte Versionskontrolle der Projekteinstellungen konfiguriert werden kann.

Aktionen

Designer hat Rückrufauslöser vorkonfiguriert, die das Skript ausführen, das Sie mithilfe des Interpreters bereitstellen, der in der unten beschriebenen Liste Interpreters eingerichtet ist.Folgende Rückrufe sind enthalten:

  • onBeforeFileLoaded - führt das Skript aus, bevor ein SBS-Paket geladen wurde.
  • onAfterFileLoaded - führt das Skript aus, nachdem ein SBS-Paket geladen wurde.
  • onBeforeFileSaved - führt das Skript aus, bevor ein SBS-Paket gespeichert wird.
  • onAfterFileSaved - führt das Skript aus, nachdem ein SBS-Paket gespeichert wurde.
  • getGraphExportOptions - führt das Skript aus, wenn die Exportausgabeoptionen aufgerufen werden.

Ein Python-Skript ist in den Installationsdateien enthalten, wobei die Funktionen, die durch jeden Rückruf ausgelöst werden, bereits eingerichtet sind und einsatzbereit sind. Sie können sie als Ausgangspunkt verwenden und Ihren Anforderungen entsprechende Funktionen hinzufügen. Dieses Skript ist functions.py und befindet sich im Ordner tools > scripting der Installationsdateien

*Standard: Keine *

Hinweis: Wenn Sie zunächst ein Skript für einen der Rückrufe auswählen, wird dieses Skript aus Zweckmäßigkeitsgründen in alle Rückrufe eingegeben. Sie können verschiedene Skripte für bestimmte Rückrufe nach diesem Zeitpunkt frei einrichten.

Dolmetscher
In dieser Liste können Sie bestimmte Interpreter angeben, die Designer verwenden sollte, um die Skripts auszuführen, die in der oben beschriebenen Liste Aktionen eingerichtet wurden. Interpreter werden mit einem benutzerdefinierten Alias identifiziert, das Sie im Textfeld jedes Eintrags in der Liste bearbeiten können. Ein Python 3.6-Interpreter wird mit den Installationsdateien von Designer gebündelt. Sie finden sie im Ordner plugins > pythonsdk der Installationsdateien

Standard: Keine

Versionskontrolle

WARNING
Perforce ist das only-Tool, das derzeit für die Versionskontrolle unterstützt wird.

Weitere Informationen finden Sie auf der Seite Versionskontrolle.

Wie sollten Sie das verwenden?

Sie sollten alle Voreinstellungen festlegen, die projektspezifisch in einer Projektdatei (*.sbsprj) in Designer sind. Zu diesen Voreinstellungen gehören:

Alle Pfade werden relativ zu der Projektdatei (.spsprj) gespeichert. , damit Sie einen Ordner library am selben Speicherort wie Ihre Projektdatei in Perforce mit der folgenden Unterordnerstruktur haben können:

  • maps/
  • Meshes/
  • sbs/
  • sbsar/
  • psd/
  • 3Dview/
  • …

Auf derselben Ebene wie die Projektdatei können Sie auch einen Tangentialraum-Plug-in oder Standard-Shader speichern.

Die Konfigurationsdatei (*.sbscfg) sollte neben der Projektdatei im Perforce-Arbeitsbereich platziert werden.

NOTE
Für weitere Informationen zum Einrichten und Integrieren von Substance 3D Designer in einer Produktionspipeline empfehlen wir dringend, auf den Abschnitt Pipeline und Projektkonfiguration der Dokumentation zu verweisen.
recommendation-more-help
substance-3d-designer-help-guide