Documentation Substance 3D Substance 3D Designer

Variables

Dernière mise à jour : 11 septembre 2026

Les variables permettent de stocker des valeurs pour les récupérer ultérieurement (Get) et/ou les modifier (Set).

graphe de fonction de Substance - Get float {modal="regular"}

Ce que fait essentiellement un nœud Get, c’est d’attraper une variable dynamique, et de la retourner à partir de la sortie des nœuds Get pour l’utiliser dans une fonction. Ces nœuds Get constituent le lien entre les Paramètres d’entrée définis dans les paramètres de graphe et les fonctions de paramètre.

Chaque fois que vous utilisez un nœud Get, vous devez choisir une valeur disponible dans le menu déroulant. Les nœuds Get récupèrent une valeur du type correspondant. Cela signifie que vous ne verrez que les options valides dans le menu d’un nœud Get, vous ne pouvez jamais choisir une option non valide. Si une variable n’est pas disponible, cela signifie qu’il existe une incompatibilité de type

Il existe un certain nombre de « Variables système » : variables spéciales prédéfinies que vous ne pouvez pas déclarer vous-même. Ceux-ci sont très importants, et pour les nœuds ci-dessous, il est indiqué quelles variables système sont disponibles.

Lorsqu’un paramètre est exposé, il consiste à lui appliquer une fonction de paramètre qui inclut uniquement un nœud Get du type approprié.

Obtenir

Définir

Est défini

Obtenir

{width="200px"}

Ces nœuds vous permettent de récupérer la valeur d’une variable qui existe dans l’étendue actuelle.

Le nom de la variable en cours de récupération est défini dans le dock Propriétés.

Les nœuds ‘Get’ présentent des limitations dont vous devez tenir compte :

Ils sont tapés. Vous devez donc vous assurer que la variable contient une valeur du même type que le nœud. Les incohérences de type sont signalées dans la console.
Ils ne vérifient pas l’existence de la variable dans l’étendue actuelle. Des variables introuvables sont signalées dans la console.
Dans les fonctions complexes utilisant des nœuds de flux de contrôle tels que Séquence, soyez attentif à l’ordre dans lequel vous définissez et obtenez des variables. Lorsque Designer détecte un cas de paramètre « Obtenir avant ensemble », il est signalé dans la console.

NOTE

Variables intégrées

Plusieurs nœuds « Get » offriront des variables intégrées pour accéder aux valeurs existantes en fonction du contexte actuel - par exemple : la position actuelle des pixels dans un Processeur de pixels, le mode de répétition actuel d'un nœud, …

Toutes les variables intégrées sont répertoriées dans cette page dédiée.