DokumentationSubstance 3DSubstance 3D Designer

Exponieren von Parametern

Letzte Aktualisierung: 11. September 2026

Das Freigeben von Parametern ist eines der leistungsfähigsten Tools und der Schlüssel zum Öffnen Ihrer Diagramme für andere Anwendungen wie Substance 3D Painter, Substance 3D Sampler und Substance Integrationen für Maya und 3DS Max.

Auf dieser Seite werden alle erforderlichen Konzepte für den Einstieg in die Bereitstellung erläutert. Es wird ​ empfohlen, zuerst zu erfahren, was eine Diagramminstanz ist, bevor Sie mit dieser Seite fortfahren. Es ist auch gut, den Unterschied zwischen Publish und “Exportieren” sowie die betroffenen Dateitypen zu erfassen.

Verfügbarmachen von Parametern vereinfacht

*Gestrichelte, transparente Linien oben sind eine abstrakte Darstellung der Verbindung
von angezeigten Parametern zu Diagrammparametern.

Parameter verstehen und belichten

Was ist ein Parameter?

Ein Parameter ist ein einfacher Wert mit einem UI-Element, der das Verhalten eines Diagramms steuert. Sie verwenden sie ständig in allen Substance-Software: um eine Farbe zu ändern, den Mischmodus festzulegen, einen Deckkraftwert auszuwählen usw. Ohne Parameter würde die Substance-Software überhaupt keine Anpassung zulassen.

Parameter können in vielen verschiedenen Formen vorliegen: Regler, Zifferblätter, Eingabefelder, Dropdown-Menüs usw. Die Werte, die sie darstellen, können verschiedene Typen haben: Dezimalwerte, ganze (Ganzzahl) Werte, boolesche (Wahr-/Falsch) Werte, sogar Textausschnitte.

Was ist "Entlarven"?
Durch das Freigeben wird ein Parameter zur Verfügung gestellt, der außerhalb der aktuellen Diagrammansicht verwendet werden kann. Beim Erstellen eines Diagramms wählen Sie in der Regel einen Knoten aus, um die Parameter in seinen Eigenschaften zu ändern. Wenn sie verfügbar gemacht werden, aktivieren Sie den Zugriff auf diesen Parameter von einem externen Steuerungsfenster aus. Diese “externe Systemsteuerung” kann je nach Kontext verschiedene Dinge bedeuten: Wenn sie in Designer als Diagramminstanz verwendet wird, agiert sie nur als ein anderer Knoten. Bei Verwendung in Substance 3D Painter, Substance 3D Sampler oder einer Integration sind diese verfügbar gemachten Parameter das einzige Steuerelement, das Sie über das Diagramm verfügen.
Warum ist die Aufdeckung nützlich?
Das Verfügbarmachen von Parametern ist etwas, was Substance 3D Designer über einen einfachen Textur-Editor hinausführt und es Ihnen ermöglicht, anpassbare, dynamische Tools zur Texturgenerierung zu erstellen . Ohne Belichtung würden sich Substance-Materialien nicht sehr von statischen Texturen unterscheiden: können Sie ihre Ausgaben nicht ändern.

+++Warum werden nicht alle Parameter automatisch und ständig verfügbar gemacht? Substance-Graphen kann kompliziert werden und Hunderte von Parametern gleichzeitig enthalten. Es ist nicht sinnvoll, einem Benutzer immer alle Parameter anzuzeigen, insbesondere wenn Sie Diagramme mit einem einfachen Ziel erstellen, für die nicht viele Parameter erforderlich sind. Wenn Sie Parameter verfügbar machen, arbeiten Sie als UI- oder UX-Designer: Du denkst, welche Kontrollen sinnvoll sind, welche Werte erforderlich sind und wie du sie einfach für dich selbst, für andere Nutzer online oder für deine Mitarbeiter nutzen kannst.

+++

Muss ich Mathe für die Belichtung kennen? Soll ich Substance-Funktionsdiagramme verstehen?
Mathematisches Wissen ist nicht erforderlich, um die Verfügbarkeitsparameter richtig zu nutzen, und auch die Verwendung von Funktionen ist nicht erforderlich. Als Anfänger können Sie mathematische Operationen in Funktionsdiagrammen fast vollständig vermeiden. Es wird nur dringend empfohlen, die verschiedenen Datentypen wie Integer, Float und Boolean zu kennen.

Belichtung.

Derzeit gibt es zwei Hauptmethoden zum Anzeigen von Parametern. Die eine Methode eignet sich besser für die schnelle Belichtung eines einzelnen Parameters, die zweite Methode eignet sich besser für die Belichtung mehrerer Parameter in einem Sweep.

Exemplarische Vorgehensweise für Methoden zur einmaligen Verfügbarmachung {width="512px"}

EINZELBELICHTUNGSMETHODE

  1. Suchen Sie den Parameter, der im Bereich Eigenschaften auf der Registerkarte Spezifische Parameter angezeigt werden soll.

  2. Klicken Sie auf die Schaltfläche mit den Dropdownoptionen .

  3. Wählen Sie Als neue Diagrammeingabe verfügbar machen aus der Dropdown-Liste, die erste Option.

  4. Das Dialogfeld “Parameter verfügbar machen” wird angezeigt. Legen Sie alle Parametereigenschaften wie gewünscht fest.

    Es wird empfohlen, mindestens die ID und Bezeichnung zu ändern.

  5. Drücken Sie OK, um den Vorgang zu bestätigen.

  6. Der Name des Parameters wird blau, und der Name
    Neben den Dropdownoptionen wird die Schaltfläche Parameterfunktion bearbeiten angezeigt, um zu bestätigen, dass der Parameter angezeigt wird.

NOTE
Die meisten Zahlenfelder unterstützen einfache mathematische Formeln als Eingabe, z. B. 17+3.5, 7/3, (4+2)*3. Drücken Sie Eingabe, um die Formel zu validieren, und das Ergebnis wird in das Feld eingegeben. Wenn die Formel ungültig ist, wird das Feld auf den vorherigen Wert zurückgesetzt.
Einige numerische Felder in anderen Teilen der Anwendung, z. B. im Dock Eigenschaften, unterstützen diese Funktion ebenfalls.

Schritt-für-Schritt-Anleitung zur Methode zur Batch-Bereitstellung {width="512px"}

Stapelbelichtungsmethode

Wenn ein Parameter angezeigt wird, ist diese Methode etwas langsamer als die vorherige. Wenn mehrere Parameter verfügbar gemacht werden, ist dies viel schneller.

  1. Suchen Sie statt eines einzelnen Parameters die Schaltfläche Mehrfachbelichtung oben rechts auf der Registerkarte Spezifische Parameter.
  2. Wählen Sie Stapelbereitstellungsparameter aus… aus dem Dropdownmenü
  3. Das Dialogfeld “Batch-Bereitstellung” wird angezeigt, in dem Sie die Bereitstellung aller spezifischen Parameter eines Knotens anpassen können.
  4. Verwenden Sie Alle, Keine oder bestimmte Kontrollkästchen, um zu entscheiden, welche Parameter verfügbar gemacht werden sollen.
  5. Klicken Sie in der Liste auf einen Parameternamen unter der Spalte Graph input identifier, um den Namen zu ändern.
  6. Klicken Sie auf einen Gruppennamen in der Spalte Graph-Eingabegruppe in der Liste, um eine (Unter-)Gruppe für einen bestimmten Parameter hinzuzufügen.
  7. Verwenden Sie die Graph-Eingabekennung und die Graph-Eingabegruppe-Eingabefelder am unteren Rand, um allen angezeigten Parametern Präfix, Suffix und Eingabegruppen gleichzeitig hinzuzufügen. Alle diese Werte werden zusätzlich zu den Einstellungen pro Parameter angewendet.
  8. Klicken Sie auf OK, um alle ausgewählten Parameter zu bestätigen und anzuzeigen. Die Parameternamen zeigen jetzt blau an, um zu bestätigen, dass die Parameter angezeigt werden, sowie eine Schaltfläche zum Bearbeiten der Funktion.

Einschränkungen

Es gibt einige Einschränkungen in Bezug auf das Verfügbarmachen von Parametern, wie in der folgenden Tabelle aufgeführt.

Parametertyp
Ursache
Verlaufsbalken, Kurveneditor, Schrift, Tonwertkorrektur-Histogramm
Widgets erforderlich, die für vom Benutzer erstellte Parameter nicht verfügbar sind.

Eine weitere wichtige Einschränkung betrifft statische Parameter. Diese können in einem veröffentlichten Substance 3D-Asset (SBSAR) nicht geändert werden.

Statische Parameter - im Gegensatz zu dynamischen Parametern - können nicht sofort bearbeitet werden, nachdem das Diagramm gekocht wurde - d. h. verarbeitet, um den Algorithmus schnell und effizient auszuführen. Das Kochen erfolgt in Designer jedes Mal, wenn das Diagramm bearbeitet oder veröffentlicht ist.

Daher sind statische Parameter in Designer sichtbar und bearbeitbar, in einem veröffentlichten Substance 3D-Asset jedoch ausgeblendet. Sie können den Vorschaumodus verwenden, um diese Einschränkungen zu sehen, bevor Sie auf einem Substance 3D-Element veröffentlichen: Siehe “Vorschau der Parameter” weiter unten.

Als Problemumgehung können Sie einen Switch- oder Multi Switch-Knoten und mehrere Logiksätze verwenden, um zwischen verschiedenen Werten/Zuständen für diese Parameter zu wechseln.

Knoten
Parameter
Alle Knoten
Pixelverhältnis im Kachelmodus
Einheitliche Farbe
Farbmodus
Pixelprozessor
Farbmodus
Überblendung
Füllmethode Alpha-Füllmethode Zuschneidebereich
FX-Map
Mischmodus
Quadrant
Alpha-Eingabebildfilter für Muster

Ändern der angezeigten Parameter

Nach dem Belichten ist es nicht mehr möglich, auf einen Parameter wie zuvor zuzugreifen. Sie können den Wert ändern, die Elemente umbenennen, in der Benutzeroberfläche anordnen und sogar den Parameter entfernen. Das alles geschieht auf der Ebene “Diagrammeigenschaften”. In diesem Abschnitt wird die entsprechende Vorgehensweise beschrieben.

So ändern Sie die Optionen eines angezeigten Parameters:

  1. Klicken Sie auf die Schaltfläche “Dropdown-Optionen” neben dem bereits angezeigten Parameter.
  2. Wählen Sie “ ” aus, um den angezeigten Diagrammeingang zu bearbeiten.. Dadurch gelangen Sie direkt zum entsprechenden Eintrag in den Diagrammeigenschaften.
  3. Doppelklicken Sie in einen leeren Bereich des Diagramms, um zu den Diagrammeigenschaften zu gelangen. Suchen Sie dann den Parameter in der Liste mit Eingabeparametern.
  4. Klicken Sie im Explorer einmal auf das Diagramm, und suchen Sie dann den Parameter in der Liste der Eingabeparameter.

Eingabeparameter {width="512px"}

EINGABEPARAMETER

Alle angezeigten Parameter werden auf der Registerkarte Eingabeparameter aufgelistet. Die folgenden Eigenschaften sind für die meisten gängigen Fälle verfügbar, z. B. “Gleitkomma” und “Ganzzahlen” mit dem Standard-Editortyp.

  1. Kennung: Eindeutiger Bezeichner für diesen Parameter Darf keine Leerzeichen oder Sonderzeichen enthalten.
  2. Bezeichnung: Bezeichnung nur für Benutzeroberfläche. Wenn kein Label definiert ist, wird der Bezeichner in der Benutzeroberfläche angezeigt. Kann Leerzeichen und Sonderzeichen enthalten
  3. Gruppe: Gruppieren Sie Parameter in einem reduzierbaren Abschnitt, damit lange Parameterlisten übersichtlich und verwaltbar bleiben. Die Parameter werden gruppiert, wenn sie den Gruppennamen “", der exakt mit dem Gruppennamen "” übereinstimmt, gemeinsam verwenden. Verwenden Sie das Zeichen /, um Untergruppen zu erstellen - z. B. 3My Group/My Sub-group
  4. Beschreibung: Textfeld für die Beschreibung, als QuickInfo verwendet.
  5. Typ / Editor: Legen Sie den Datentyp sowie den Typ des UI-Editors fest. Bestimmte Editoren sind nur für bestimmte Datentypen verfügbar (z. B. eine Dropdown-Liste nur für Ganzzahl). Das Ändern des Editors löscht in vielen Fällen die Standardwerte, Vorsicht!
  6. Standard: Standardwert, bei dem der Parameter beginnt. Dies ist auch der Wert, der in Ihrem Graphen bei der Knotenvorschau verwendet wird. Versuchen Sie, einen einfachen, nutzbaren Wert hier zu verwenden, vermeiden Sie Extremfälle.
  7. Min: Mindestwert für die Benutzeroberfläche
  8. Max: Maximalwert für die Benutzeroberfläche
  9. Klemme: Legen Sie fest, ob Min und Max weiche oder harte Grenzen sind (erlauben Sie dem Benutzer, die Grenzen zu überschreiten).
  10. Schritt:Set die Präzision oder Granularität des Werts.
  11. Benutzerdaten: benutzerdefinierte Benutzerdaten, die für jeden Zweck verfügbar sind.
  12. Sichtbar, wenn: spezielles Ausdruckssystem zum Ein- oder Ausblenden von Parametern basierend auf externen Bedingungen. Siehe Sichtbar, wenn: Kontrollieren der Sichtbarkeit von Eingängen, Ausgängen und Parametern

Dropdownlisten-Editor für Integer-Parameter {width="512px"}

Ein Sonderfall ist die Dropdownliste für Integer-Typen. Es gibt keine Standard-, Min- oder Max-Werte, sondern nur eine einzelne Werteinstellung, mit der Sie eine Liste von Elementen definieren können.

  • Jedes Element entspricht einem Element in der Dropdownliste.
  • Der erste Wert für ein Item ist die tatsächliche, interne ganze Zahl, die vom Graphen verwendet wird. Stellen Sie sicher, dass diese für Ihren Multiswitch richtig eingerichtet sind (sie beginnen bei 1, nicht bei 0).
  • Der zweite Wert ist die dem Benutzer angezeigte UI-Bezeichnung.
  • Mit dem dritten Kontrollkästchen können Sie ein Element als das standardmäßig ausgewählte Element markieren.
  • Das X löscht ein Element, das + fügt ein Element hinzu.

Eingabeparameter neu anordnen {width="512px"}

Neuanordnung

Sie können die Parameter neu anordnen, indem Sie die dunklen, gestreiften Handles auf die linke Seite des Namens der Eingabeparameter in der Liste ziehen und ablegen. Beachten Sie, dass sich Gruppierungsparameter auf die Reihenfolge auswirken können.

Vorschau der Eingabeparameter {width="512px"}

VORSCHAU VON PARAMETERN

Da das Einrichten von Parametern schwierig sein kann, ohne das Endergebnis zu sehen, kann ein Vorschaumodus aktiviert werden, um zu überprüfen, wie die Parameterbenutzeroberfläche extern aussehen und sich verhalten wird. Klicken Sie oben in der Mitte des Rollouts für Eingabeparameter auf die Registerkarte Vorschau.

Normalerweise werden alle im Vorschaumodus vorgenommenen Änderungen verworfen. Sie können jedoch die Schaltfläche zum Anwenden neben dem Augensymbol verwenden, um die aktuellen Werte des -Vorschaumodus als neue Standardwerte festzulegen.

Im Vorschaumodus können Sie auch eingebettete Vorgaben erstellen.

IMPORTANT
Der Vorschaumodus ist deaktiviert, wenn die -kontextbezogene Bearbeitung ​ verwendet wird.
WARNING
Im Vorschaumodus soll das Erlebnis eines veröffentlichten Substance 3D-Assets (SBSAR) so genau wie möglich dargestellt werden. Daher gelten die auf dieser Seite aufgeführten Einschränkungen in diesem Modus, z. B. statische Parameter, die in der Liste nicht vorhanden sind.

Eingabeparameter werden kopiert und eingefügt {width="512px"}

KOPIEREN UND EINFÜGEN VON PARAMETERN

Parameter können zwischen Graphen kopiert und eingefügt werden.

Ein einzelner Parameter kann mit der Schaltfläche “Kopieren” kopiert werden. Mehrere Parameter können über das Parametermenü “ ” kopiert werden. Wählen Sie “Eingaben kopieren”, um alle Eingaben zu kopieren.

Wählen Sie “Eingaben einfügen” im Menü “Parameter” , um einen oder mehrere Parameter einzufügen.

Wenn Sie Werte und nicht den tatsächlich angezeigten Parameter selbst übertragen möchten, lesen Sie die Informationen zu Parametervorgaben.

Entfernen und Reinigen exponierter Parameter

Aufgrund der Art von Parametern können Probleme mit fehlenden oder nicht verwendeten Parametern auftreten, wenn Sie über einen Eingabeparameter verfügen, der mehrere Knoten steuert, oder wenn Eingabeparameter vorhanden sein können, ohne einen Knoten zu steuern. Nachfolgend werden häufige Probleme und deren Lösungen beschrieben.

Fehler bei Knotenparametern {width="512px"}

VERFOLGEN VON FEHLERHAFTEN PARAMETERN AUF KNOTEN

Mit dem Knotensuche-Tool “ ”, das sich in der oberen Leiste der Diagrammansicht befindet, können Sie nachverfolgen, welcher Parameter von welchem Knoten verwendet wird. Klicken Sie darauf, um Knoten mithilfe bestimmter Parameter zu suchen.

Wenn ein Knoten ein tatsächliches Problem aufweist, zeigt er oben links ein Warnungskennzeichen an. Wenn Sie den Mauszeiger über das Abzeichen bewegen, wird eine QuickInfo mit weiteren Informationen angezeigt.

Um ein Problem zurückzusetzen und zu entfernen, klicken Sie für den Parameter, den Sie reparieren oder zurücksetzen möchten, auf die Dropdown-Schaltfläche “ ” neben der Schaltfläche “Funktion bearbeiten” und wählen Sie " Zurücksetzen". Hiermit wird ein Parameter auf seinen vorherigen, nicht gelegt Zustand zurückgesetzt. Der blaue Name wird wieder grau, um dies widerzuspiegeln.

Nicht verwendete Eingabeparameter löschen {width="512px"}

BEREINIGEN NICHT VERWENDETER EINGABEPARAMETER

Wenn du den Überblick über deine Eingabeparameter verloren hast und nicht mehr weißt, welche davon verwendet werden, kannst du sie mit einem kleinen Tool bereinigen. Klicken Sie auf die Menüschaltfläche “ ” des Eingabeparameters und wählen Sie “Eingaben bereinigen” aus.

Ein neues Dialogfeld mit allen nicht verwendeten Parametern wird angezeigt. Aktivieren bzw. deaktivieren Sie die Parameter, die Sie entfernen bzw. beibehalten möchten, und klicken Sie auf “OK”. Wenn kein Dialogfeld angezeigt wird, sind derzeit keine nicht verwendeten Parameter zum Bereinigen vorhanden.

Parameter werden entfernt {width="512px"}

PARAMETER ENTFERNEN

Um einen verwendeten Parameter tatsächlich zu entfernen, sind zwei unterschiedliche Schritte erforderlich.

  1. Klicken Sie auf dem Knoten mit dem offengelegten Parameter auf den Dropdown-Pfeil rechts neben der blau eingefärbten Schaltfläche „Funktion“: . Wählen Sie dann “Auf Standardwert zurücksetzen”. Dadurch wird die Verwendung des Parameters auf diesem einen Knoten entfernt. für jeden anderen Knoten, der denselben Parameter verwendet, zu wiederholen. “Auf Standardwert zurücksetzen” setzt auch den Bereich des Parameter-Widgets auf den weichen Bereich zurück.
  2. Klicken Sie in der Liste “Eingabeparameter” des Grafen auf das X rechts neben dem Parametereintrag. Dadurch wird der Parameter vollständig gelöscht. Wenn Knoten versuchen, diesen Parameter zu verwenden, wird ein Warnschild angezeigt (siehe oben).
recommendation-more-help
substance-3d-designer-help-guide