DocumentazioneSubstance 3DSubstance 3D Designer

Visibile se le espressioni

Ultimo aggiornamento: 16 settembre 2026

L’espressione ‘Visible if’ consente di controllare la visibilità di input, output e parametri nei grafici.

Quando si espongono i parametri, è possibile nascondere o visualizzare i parametri o i connettori dei nodi in base allo stato degli altri parametri. Ad esempio, un cursore che viene visualizzato solo quando un pulsante del parametro booleano è impostato su true, perché altrimenti non avrebbe alcun effetto e questo potrebbe confondere gli utenti.

A tale scopo, è possibile immettere un’espressione logica nella proprietà Visible if di:

Attivazione/disattivazione della visibilità dei parametri di input {width="512px"}

Se l’espressione logica restituisce true, il parametro, l’input o l’output viene visualizzato in tutti i nodi di istanza che rappresentano il grafico corrente. In caso contrario, è nascosto.

Le condizioni complesse sono possibili, a condizione che l’espressione logica che indica tali condizioni sia valida.

NOTE
Caveats
  • Questa funzionalità solo influisce sulla visualizzazione di un parametro o di un connettore nell'interfaccia utente e non ha alcun effetto sui calcoli e sul risultato di un grafico.
  • Durante l'esposizione o l'applicazione di una funzione a qualsiasi parametro utilizzato nelle istruzioni 'Visible if', tali istruzioni verranno ignorate e impostate per impostazione predefinita su 'true'.
IMPORTANT
Sebbene questa funzionalità funzioni all'interno dell'ecosistema Substance 3D, alcune integrazioni potrebbero non supportarla. Se non supportata, la condizione di visibilità predefinita è true.

Scrittura delle espressioni ‘Visible if’ in corso

ACCESSO AI PARAMETRI DI INPUT

Qualsiasi valore Visible If Expression deve utilizzare almeno un input, che può essere eseguito tramite la sintassi seguente:

input.identifier

input["identifier"]
WARNING
L'identificatore deve essere il nome esatto della proprietà Identificatore di un parametro di input esistente e deve essere digitato con distinzione tra maiuscole e minuscole. L'utente non può fare riferimento a un parametro tramite la relativa etichetta.
Se non esiste un parametro a cui si fa riferimento o l'espressione logica non è valida, verrà visualizzato un avviso nella proprietà Visible if.

OPERATORI DISPONIBILI

I campi “Visible if” accettano i seguenti parametri:

  • Input Boolean, Float e Integer.
  • Valori true e false (con distinzione tra maiuscole e minuscole, senza maiuscole)
  • .x: accesso al sottoparametro
  • && : e
  • || : o
  • ! : non
  • <, >, <=, >=, ==, !=: confronto
  • (): parentesi

DEVE SEMPRE VALUTARE BOOLEANI

Un’espressione If visibile viene utilizzata come condizione per un’istruzione “IF”, ovvero deve sempre restituire true o false.

  • I valori booleani possono essere valutati direttamente come condizione. Un pulsante semplice con un valore booleano non richiede più di questo. Vedere gli esempi seguenti, primo caso;
  • I parametri non booleani richiedono in genere un’operazione di confronto. Vedere sopra per gli operatori di confronto, di seguito per gli esempi;
  • Alcuni valori non booleani possono essere veritieri o falsi, ovvero true di false, ad esempio un valore intero 0 restituisce false.

Esempi

Condizione (“If”)
Formula
Nota
True
input["my_input"] input.my_input input["my_input"] == true input.my_input == true
my_input è un valore booleano
False
!input["my_input"] !input.my_input input["my_input"] == false input.my_input == false input["my_input"] != true input.my_input != true
my_input è un valore booleano
Minore di
input["my_input"] < 3 input.my_input < 3
my_input è un valore intero
Uguale
input["param1"] == 2 input.param1 == 2
param1 è un valore float o integer
Minore di
input["my_input"].y < 3 input.my_input.y < 3
my_input è un valore float o integer con uno o più componenti, ad esempio float2(x, y), integer3(x, y, z)
Oppure
input["param1"] || input["param2"] input.param1 || input.param2
param1 e param2 sono valori booleani
E
input["param1"] > 0 && input["param2"] > 1 input.param1 > 0 && input.param2 > 1
param1 e param2 sono valori float o integer
recommendation-more-help
substance-3d-designer-help-guide