Documentation Substance 3D Substance 3D Designer

Exposition d’un paramètre

Dernière mise à jour : 11 septembre 2026

Exposer des paramètres est l’un des outils les plus puissants et est essentiel pour ouvrir vos graphes à d’autres applications telles que Substance 3D Painter, Substance 3D Sampler et Substance Integrations pour Maya et 3DS Max.

Cette page explique tous les concepts requis pour commencer à exposer. Il est recommandé de commencer par découvrir ce qu’est une Instance de grapheavant de continuer sur cette page. Il est également utile de comprendrela différence entre Publish et Exportation, ainsi que les types de fichiers concernés.

Exposer des paramètres simplifiés

*Les lignes transparentes en pointillés ci-dessus sont une représentation abstraite de la connexion
des paramètres exposés aux paramètres de Graphe.

Compréhension des paramètres et exposé

Qu’est-ce qu’un paramètre ?

Un paramètre est une valeur simple, avec un élément d’interface utilisateur, qui contrôle le comportement d’un graphe. Vous les utilisez constamment dans tous les logiciels de Substance : pour changer une couleur, pour définir un mode de fusion, pour choisir une valeur d’opacité, etc… Sans paramètres, les logiciels de Substance de données ne permettraient aucune personnalisation.

Les paramètres peuvent prendre différentes formes : curseurs, cadrans, zones de saisie, menus déroulants, etc… Les valeurs qu’ils représentent peuvent être de différents types : valeurs décimales, valeurs entières (entier), valeurs booléennes (vrai/faux), et même des fragments de texte.

Qu'est-ce qui « expose » ?

Exposer est le processus consistant à rendre un paramètre disponible pour une utilisation en dehors de votre Vue du graphe de données actuelle. Lors de la création d’un Graphe, vous sélectionnez généralement un nœud pour modifier les paramètres de ses propriétés. Lorsqu’il est exposé, vous activez l’accès à ce paramètre à partir d’un panneau de contrôle externe. Ce « panneau de contrôle externe » peut signifier différentes choses en fonction du contexte : lorsqu’il est utilisé en tant qu’Instance de graphe dans Designer, il agit simplement comme un autre nœud. Utilisés dans Substance 3D Painter, Substance 3D Sampler ou une intégration, ces paramètres exposés seront le seul contrôle dont vous disposez sur le graphe.

Pourquoi exposer est-il utile ?

Exposer des paramètres est ce qui fait que Substance 3D Designer va au-delà d’un simple éditeur de textures, en vous permettant de créer des outils de génération de textures personnalisables et dynamiques . Sans exposer, les Matériaux de Substance ne seraient pas très différents des textures statiques : vous n’auriez aucun moyen de modifier leurs sorties.

+++Pourquoi ne pas exposer chaque paramètre automatiquement, tout le temps ? graphes de Substance peuvent devenir compliqués et contenir des centaines de paramètres à la fois. Il n’est pas logique de toujours afficher tous les paramètres à un utilisateur, en particulier si vous créez des graphes avec un objectif simple, qui n’ont pas besoin de nombreux paramètres. Lorsque vous exposez des paramètres, vous travaillez en tant que concepteur d’interface utilisateur ou UX : vous vous demandez quelles commandes sont logiques, quelles valeurs sont requises et comment les rendre faciles à utiliser pour vous-même, pour les autres utilisateurs en ligne ou pour vos collègues.

+++

Dois-je faire des calculs pour exposer ? Dois-je comprendre les graphes de la fonction Substance ?

Les connaissances mathématiques ne sont pas requises pour utiliser correctement les paramètres Exposés, de même que l’utilisation des fonctions. En tant qu’utilisateur débutant, vous pouvez presque totalement éviter d’avoir à effectuer des opérations mathématiques dans les graphes de fonction. La seule chose fortement recommandée est une connaissance correcte des différents types de données tels que l’Entier, le Flottant et le Booléen.

Comment exposer

Actuellement, il existe deux méthodes principales pour exposer les paramètres. Une méthode est plus adaptée pour exposer rapidement un seul paramètre, la seconde méthode est plus adaptée pour exposer plusieurs paramètres en un seul balayage.

Procédure pas à pas de méthode à expose unique {width="512px"}

MÉTHODE D’EXPOSE UNIQUE

Recherchez le paramètre à exposer dans le panneau Propriétés, sous l’onglet Paramètres spécifiques
Cliquez sur le bouton des options déroulantes
Choisissez Exposer comme nouvelle entrée de graphe dans la liste déroulante, la première option.
La boîte de dialogue Exposer le paramètre s’affiche. Définissez les propriétés du paramètre comme vous le souhaitez.

Il est recommandé de modifier au moins l’Identifiant et l’étiquette
Appuyez sur OK pour confirmer
Le nom du paramètre devient bleu et le
Le bouton Modifier la fonction de paramètre apparaît en regard des options du menu déroulant pour confirmer que le paramètre est exposé

NOTE

La plupart des champs numériques prennent en charge les formules mathématiques de base comme entrée, par exemple, 17+3.5, 7/3, (4+2)*3. Appuyez sur Entrée pour valider la formule. Le résultat sera saisi dans le champ. Si la formule n’est pas valide, le champ revient à sa valeur précédente.
Certains champs numériques d'autres parties de l'application, tels que dans le dock Propriétés, prennent également en charge cette fonctionnalité.

Procédure pas à pas de la méthode d'expose par lot {width="512px"}

Méthode d’expose par lots

Lorsque vous exposez un paramètre, cette méthode est un peu plus lente que la précédente. Lorsque vous exposez plusieurs paramètres, c’est beaucoup plus rapide.

Au lieu de rechercher un seul paramètre, recherchez le bouton exposes multiples en haut à droite de l’onglet Paramètres spécifiques
Choisissez Paramètres d’expose par lot… dans le menu déroulant
La boîte de dialogue expose par lot s’affiche, vous permettant de personnaliser l’expose de tous les paramètres spécifiques d’un nœud
Utilisez les cases à cocher Tous, Aucun ou spécifiques pour décider quels paramètres exposer
Cliquez sur un nom de paramètre sous la colonne identifiant d’entrée de Graphe dans la liste pour modifier son nom.
Cliquez sur un nom de groupe sous la colonne Groupe d’entrée par Graphe dans la liste pour ajouter un (sous-)groupe pour un paramètre spécifique
Utilisez les zones de saisie identifiant d’entrée de Graphe et Groupe d’entrée de Graphe en bas pour ajouter un préfixe, un suffixe et des groupes d’entrée à tous les paramètres exposés à la fois. Toutes ces valeurs sont appliquées en plus des réglages par paramètre.
Cliquez sur OK pour confirmer et exposer tous les paramètres sélectionnés. Les noms des paramètres affichent désormais bleu pour confirmer que les paramètres sont exposés, ainsi qu’un bouton Modifier la fonction.

Restrictions

Certaines limitations sont liées à l’expose de paramètres, comme indiqué dans le tableau ci-dessous.

Type de paramètre

Raison

Gradient Ramp, Curve Editor, Font, Levels Histogram

Exiger des widgets qui ne sont pas disponibles pour les paramètres créés par l’utilisateur.

Une autre limitation importante est liée aux paramètres statiques. Ils ne peuvent pas être modifiés dans une ressource Substance 3D publiée (SBSAR).

Les paramètres statiques (par opposition aux paramètres dynamiques) ne peuvent pas être modifiés à la volée une fois le graphe cuit, c’est-à-dire traité afin d’exécuter son algorithme rapidement et efficacement. La cuisson a lieu dans Designer chaque fois que le graphe est modifié ou publié.

Ainsi, les paramètres statiques sont visibles et modifiables dans Designer, mais sont masqués dans une ressource Substance 3D publiée. Vous pouvez utiliser le mode Aperçu pour voir ces limitations en vigueur avant de publier sur une ressource Substance 3D : voir « Prévisualisation des paramètres » ci-dessous.

Pour contourner le problème, vous pouvez utiliser un nœud Commutateur ou Commutateur multiple et plusieurs jeux de logique pour basculer entre différentes valeurs/états pour ces paramètres.

Nœud

Paramètre

Tous les nœuds

Mode répétition Format des pixels

Couleur uniforme

Mode colorimétrique

Processeur de pixels

Mode colorimétrique

Fusion

Zone de recadrage de Simulation de transparence du mode de fusion

FX-Map

Mode de fusion

Quadrant

Filtrage d’Image d’entrée alpha de motif

Modification des paramètres exposés

Une fois exposé, il n’est plus possible d’accéder à un paramètre comme auparavant. La modification de sa valeur, le renommage, l’organisation dans l’interface utilisateur et même la suppression du paramètre se produisent au niveau des propriétés du Graphe. Cette section explique comment procéder.

Pour modifier les options d’un paramètre exposé :

Cliquez sur le bouton Options de liste déroulante en regard du paramètre exposé déjà sélectionné
Sélectionnez Modifier l’entrée de graphe exposée. Cela vous amène directement à l’entrée correspondante dans les propriétés du graphe
Double-cliquez dans une zone vide de votre graphe pour accéder aux propriétés du graphe, puis recherchez le paramètre dans la liste des Paramètres d’entrée
Cliquez sur votre graphe dans l’Explorateur, puis recherchez le paramètre dans la liste des Paramètres d’entrée

Paramètres d'entrée {width="512px"}

PARAMÈTRES D’ENTRÉE

Tous les paramètres exposés sont répertoriés sous l’onglet Paramètres d’entrée. Les propriétés suivantes sont disponibles pour les cas les plus courants tels que les Flottants et les Entiers avec le type d’éditeur par défaut.

Identifiant : identifiant unique pour ce paramètre. Ne peut pas contenir d’espaces ni de caractères spéciaux.
Libellé : libellé réservé à l’interface utilisateur. Si aucun libellé n’est défini, l’identifiant est affiché dans l’interface utilisateur. Peut contenir des espaces et des caractères spéciaux
Groupe : regroupez les paramètres dans une section réductible pour garder de longues listes de paramètres propres et gérables. Les paramètres sont regroupés s’ils partagent exactement le même nom de groupe. Utilisez le caractère / pour créer des sous-groupes, par exemple My Group/My Sub-group
Description : champ de texte pour la description, utilisé comme info-bulle.
Type/Éditeur : définissez le type de données ainsi que le type de l’éditeur d’interface utilisateur. Certains éditeurs ne sont disponibles que pour certains types de données (par exemple, une liste déroulante uniquement pour l’Entier). Dans de nombreux cas, la modification de l’éditeur efface les valeurs par défaut. Faites attention.
Par défaut : valeur par défaut à laquelle le paramètre commence. Il s’agit également de la valeur utilisée dans le graphe lors de l’affichage de l’aperçu des nœuds. Essayez d’utiliser une valeur facile et utilisable ici, évitez les cas extrêmes.
Min : valeur minimale pour l’interface utilisateur.
Max : valeur maximale pour l’interface utilisateur.
Verrouille : définissez si Min et Max sont des limites souples ou strictes (autorisez l’utilisateur à dépasser les limites).
Étape:Set de précision ou de granularité de la valeur.
Données utilisateur : données utilisateur personnalisées, disponibles à toutes fins.
Visible si : système d’expression spécial permettant d’afficher ou de masquer les paramètres en fonction des conditions externes. Voir Visible si : contrôlez la visibilité des entrées, sorties et paramètres

Éditeur de liste déroulante pour le paramètre Entier {width="512px"}

Liste déroulante

La liste déroulante pour les types d’Entier est un cas particulier. Il n’y a pas de Valeur par défaut, Min ou Max, mais un seul paramètre Valeur qui vous permet de définir une liste d’éléments.

Chaque élément correspond à un élément de la liste déroulante.
La première valeur d’un article est l’entier interne réel utilisé par le graphe. Assurez-vous de les configurer correctement pour votre commutateur multiple par exemple (ils commencent à 1, pas à 0).
La deuxième valeur est l’étiquette d’interface utilisateur affichée à l’utilisateur.
La troisième case vous permet de marquer un élément comme élément sélectionné par défaut.
La croix X supprime un élément, la croix + en ajoute un

Réorganiser les paramètres d'entrée {width="512px"}

Réorganiser

Vous pouvez facilement réorganiser les paramètres en faisant glisser les poignées foncées à bandes vers la gauche du nom du paramètre d’entrée dans la liste. Gardez à l’esprit que les paramètres de regroupement peuvent affecter l’ordre.

Aperçu Des paramètres d'entrée {width="512px"}

PRÉVISUALISATION DES PARAMÈTRES

Comme la configuration des paramètres peut être difficile sans voir le résultat final, un mode Aperçu peut être activé pour vérifier l’apparence et le comportement externe de l’interface utilisateur des paramètres. Cliquez sur l’onglet Aperçu en haut au milieu du panneau déroulant Paramètres d’entrée.

Normalement, toutes les modifications apportées en mode Aperçu sont supprimées. Vous pouvez toutefois utiliser le bouton Appliqueren regard de l’icône en forme d’œil pour définir les valeurs actuelles du mode Aperçu comme nouvelles valeurs par défaut.

Le mode Aperçu vous permet également de créer des paramètres prédéfinis intégrés.

IMPORTANT

Le mode Aperçu est désactivé lors de l'utilisation de l'édition contextuelle.

WARNING

Le mode Aperçu vise à représenter l'expérience d'une ressource Substance 3D publiée (SBSAR) de la manière la plus précise possible. Par conséquent, les limitations répertoriées sur cette page s'appliquent dans ce mode, notamment l'absence de paramètres statiques dans la liste.

Copier et coller les paramètres d'entrée {width="512px"}

COPIER-COLLER DES PARAMÈTRES

Les paramètres peuvent être copiés-collés entre les graphes.

Un seul paramètre peut être copié avec le bouton Copier . Plusieurs paramètres peuvent être copiés via le menu Paramètres . Sélectionnez Copier les entrées pour copier toutes les entrées.

Sélectionnez Coller les entrées dans le menu Paramètres pour coller un ou plusieurs paramètres.

Si vous souhaitez transférer des valeurs, et non le paramètre exposé lui-même, en savoir plus sur les paramètres prédéfinis.

Retrait et nettoyage des paramètres exposés

En raison de la nature des paramètres, lorsque vous pouvez avoir un Paramètre d’entrée contrôlant plusieurs nœuds, ou lorsque des Paramètres d’entrée peuvent exister sans contrôler un nœud, des problèmes peuvent se produire avec des paramètres manquants ou inutilisés. Vous trouverez ci-dessous une description des problèmes courants et de leurs solutions.

Erreurs sur les paramètres de nœud {width="512px"}

SUIVI DES PARAMÈTRES ROMPUS SUR LES NOEUDS

Vous pouvez suivre quel paramètre est utilisé par quel nœud via l’outil Node Finder Tool , qui se trouve dans la barre supérieure de la Vue du graphe. Cliquez dessus pour rechercher des nœuds à l’aide de paramètres spécifiques.

Si un nœud a un problème réel, il affichera un badge d’avertissement dans son coin supérieur gauche. Placer le pointeur de la souris sur le badge affiche une info-bulle contenant plus d’informations.

Pour réinitialiser et supprimer un problème, pour le paramètre que vous souhaitez corriger ou réinitialiser, cliquez sur le bouton déroulant en regard du bouton Modifier la fonction et sélectionnez Réinitialiser. Cela ramène un paramètre à son état précédent, non exposé. Le nom bleu redevient gris pour refléter cela.

Nettoyage des paramètres d'entrée inutilisés {width="512px"}

NETTOYAGE DES PARAMÈTRES D’ENTRÉE INUTILISÉS

Si vous avez perdu la trace de vos Paramètres d’entrée et ne savez plus lesquels sont utilisés, ils peuvent être nettoyés à l’aide d’un petit outil. Cliquez sur le bouton du menu Paramètre d’entrée et sélectionnez Nettoyer les entrées.

Une nouvelle boîte de dialogue contenant la liste de tous les paramètres inutilisés s’affiche. Cochez ou décochez les paramètres à supprimer ou à conserver, puis cliquez sur OK. Si aucune boîte de dialogue ne s’affiche, il n’y a actuellement aucun paramètre inutilisé à nettoyer.

Suppression de paramètres {width="512px"}

SUPPRESSION DE PARAMÈTRES

La suppression d’un paramètre en cours d’utilisation nécessite deux étapes distinctes.

Sur le nœud doté du paramètre exposé, cliquez sur la flèche de déroulement à droite du bouton Exposition de la fonction, qui est de couleur bleue : . Choisissez ensuite « Rétablir la valeur par défaut ». Cela supprime l’utilisation du paramètre sur ce nœud. répétez l’opération pour tout autre nœud utilisant le même paramètre. « Rétablir la valeur par défaut » réinitialise également la plage du widget de paramètre à sa plage souple.
Dans la liste Paramètres d’entrée du Graphe, cliquez sur le X à droite de l’entrée du paramètre. Le paramètre est ainsi complètement supprimé. Si des nœuds tentent d’utiliser ce paramètre, un badge d’avertissement s’affiche (voir ci-dessus).

recommendation-more-help

substance-3d-designer-help-guide