DokumentationSubstance 3DSubstance 3D Designer

Sichtbar, wenn Expressions

Letzte Aktualisierung: 16. September 2026

Mit dem Ausdruck “Sichtbar, wenn” können Sie die Sichtbarkeit von Eingängen, Ausgaben und Parametern in Diagrammen steuern.

Wenn Parameter ​ verfügbar gemacht werden, sollten Sie Parameter oder Knotenkonnektoren basierend auf dem Status anderer Parameter ein- oder ausblenden. Beispiel: Ein Schieberegler wird nur angezeigt, wenn eine boolesche Parameterschaltfläche auf “true” festgelegt ist, da er sonst keine Auswirkungen hätte und Benutzer möglicherweise verwirrt werden.

Um dies zu erreichen, können Sie einen logischen Ausdruck in die Visible if-Eigenschaft von eingeben:

Sichtbarkeit von Eingabeparametern umschalten {width="512px"}

Wenn die Auswertung des logischen Ausdrucks “true” ergibt, wird der Parameter, die Eingabe oder die Ausgabe in allen Instanzknoten angezeigt, die das aktuelle Diagramm darstellen. Andernfalls ist sie ausgeblendet.

Komplexe Bedingungen sind möglich, sofern der logische Ausdruck, der diese Bedingungen angibt, gültig ist.

NOTE
Caveats
  • Dieses Feature only wirkt sich darauf aus, ob ein Parameter oder ein Connector in der Benutzeroberfläche angezeigt wird, und hat keine Auswirkungen auf die Berechnungen und das Ergebnis eines Diagramms.
  • Wenn eine Funktion für einen Parameter verfügbar gemacht oder angewendet wird, der in 'Visible if'-Anweisungen verwendet wird, werden diese Anweisungen ignoriert und standardmäßig auf 'true' festgelegt.
IMPORTANT
Diese Funktion kann für das Substance 3D-Ökosystem genutzt werden, ist aber in einigen Integrationen möglicherweise nicht verfügbar. Wenn diese Option nicht unterstützt wird, wird die Sichtbarkeitsbedingung standardmäßig auf "true" festgelegt.

Schreiben von “Visible if”-Ausdrücken

ZUGRIFF AUF EINGABEPARAMETER

“Beliebig” Wenn für “Ausdruck” mindestens eine Eingabe erforderlich ist, kann dies durch die folgende Syntax erfolgen:

input.identifier

input["identifier"]
WARNING
Der Bezeichner muss der genaue Name der Bezeichner-Eigenschaft eines vorhandenen Eingabeparameters sein, und er muss Groß- und Kleinschreibung beachten eingegeben werden. kann nicht auf einen Parameter über dessen Bezeichnung verweisen.
Wenn kein referenzierter Parameter vorhanden ist oder der logische Ausdruck ungültig ist, wird eine Warnung in der Visible if-Eigenschaft angezeigt.

VERFÜGBARE OPERATOREN

Die Felder “Sichtbar wenn” akzeptieren die folgenden Parameter:

  • Boolesche, Float- und Integer-Eingaben.
  • true und false Werte (Groß- und Kleinschreibung beachten, keine Großbuchstaben!)
  • .x : auf den Unterparameter zugreifen
  • && und
  • || oder
  • ! nicht
  • <, >, <=, >=, ==, !=: Vergleich
  • () : Klammern

MUSS IMMER AUF BOOLESCHE AUSWERTEN

Ein "Sichtbar, wenn Ausdruck als Bedingung für eine “IF”-Anweisung verwendet wird, d. h., er muss immer true oder false ergeben.

  • Boolesche Werte können direkt als Bedingung ausgewertet werden. Eine einfache Schaltfläche mit einem booleschen Wert erfordert nicht mehr als diesen Wert. Siehe nachstehende Beispiele, erster Fall;
  • Für nicht boolesche Parameter ist im Allgemeinen ein Vergleichsvorgang erforderlich. Vergleichsoperatoren finden Sie oben, Beispiele unten.
  • Einige nicht-boolesche Werte können wahrheitsgetreu oder falsch sein, was bedeutet, dass sie als true von false ausgewertet werden können - z. B. Ein ganzzahliger Wert von 0 wird als false ausgewertet.

Beispiele

Bedingung (“If”)
Formel
Anmerkung
Wahr
input["my_input"] input.my_input input["my_input"] == true input.my_input == true
my_input ist ein boolescher Wert.
Falsch
!input["my_input"] !input.my_input input["my_input"] == false input.my_input == false input["my_input"] != true input.my_input != true
my_input ist ein boolescher Wert.
Unterer als
input["my_input"] < 3 input.my_input < 3
my_input ist eine Ganzzahl
Equal
input["param1"] == 2 input.param1 == 2
param1 ist ein float- oder integer-Wert
Unterer als
input["my_input"].y < 3 input.my_input.y < 3
my_input ist ein float- oder integer-Wert mit einer oder mehreren Komponenten - z.B. float2(x, y), integer3(x, y, z)
Or
input["param1"] || input["param2"] input.param1 || input.param2
param1 und param2 sind boolesche Werte
Und
input["param1"] > 0 && input["param2"] > 1 input.param1 > 0 && input.param2 > 1
param1 und param2 sind float- oder integer-Werte.
recommendation-more-help
substance-3d-designer-help-guide