Données utilisateur
Cette page décrit les propriétés personnalisées (données utilisateur) qui peuvent être ajoutées sur le graphe Substance pour exécuter des comportements spécifiques.
Les paramètres de données utilisateur sont généralement appliqués aux nœuds d’entrée ou de sortie d’un graphe pour indiquer comment l’application doit les interpréter. Cela permet de demander à l’entrée d’un graphe d’être d’une certaine manière pour appliquer des effets dans un contexte connu (par exemple : demander un espace colorimétrique spécifique) ou d’indiquer comment une sortie a été effectuée au cas où l’application aurait besoin d’appliquer des conversions supplémentaires par la suite.
- Les paramètres Utiliser les données sont définis comme clé = valeur
- Plusieurs paramètres sont séparés par un point-virgule ( ; )
Espace colorimétrique
Le paramètre colorspace peut être utilisé pour demander des entrées de graphe de Substance avec un espace colorimétrique spécifique ou pour définir une sortie configurée d’une certaine manière. Par exemple, spécifier le format de la sortie de map normal.
Exemple de syntaxe : colorspace=$working
Présentation des contextes :
- Bouton de couleur : widget de bouton de couleur dans les propriétés d’un graphe de Substance.
- Entrée/Sortie de Graphe : nœud d’entrée ou de sortie d’un graphe connecté à un canal (ex : BaseColor).
- Entrée d’image : entrée générique d’un graphe, non liée à des canaux spécifiques.
- Le tableau ci-dessous répertorie d’abord les paramètres d’espace colorimétrique compatibles avec les versions antérieures à la version 8.1. La deuxième section est réservée à la version 8.1 et aux versions plus récentes.
- En ce qui concerne les contextes dans lesquels le paramètre d’espace colorimétrique peut être utilisé, ce n’est que depuis la version 8.1 que le bouton de couleur peut définir un espace colorimétrique. Dans les versions précédentes, ils étaient supposés se trouver dans l’espace d’affichage (sRVB).
mode Alpha
Le paramètre alpha peut être utilisé pour spécifier la façon dont l’alpha d’une entrée ou d’une sortie couleur (RVBA) est combinée.
Exemple de syntaxe : alpha=premultiplied
Couleur d’entrée par défaut de l’image
La couleur par défaut d’une entrée d’image de graphe de Substance est le noir avec son alpha défini sur 0. Le paramètre defaultcolor permet de définir une valeur différente lorsque l’entrée d’image d’un graphe est vide
Des valeurs flottantes (plage [0, 1]) ou des valeurs entiers (plage [0, 255]) peuvent être utilisées pour spécifier la couleur. Chaque valeur du composant est séparée par une virgule, tandis que la valeur de point flottant utilise un point comme séparateur décimal. Si un objet flottant n’a pas de point, il sera considéré comme un entier.
Exemple de syntaxe :
- defaultcolor=(1.0,0.5,0.0)
- defaultcolor=(0,128,255)
Remplissage d’entrée d’image
Par défaut, les entrées d’image d’un graphe de Substance n’ont pas de remplissage, la zone en dehors de l’Îlot UV est généralement remplie d’une couleur uniforme pour des raisons de performances. Le paramètre de remplissage peut être utilisé pour demander une dilatation infinie, qui peut être utilisée pour les filtres afin d’éviter la création de seams, par exemple.
Exemple de syntaxe : padding=extend
Désactiver une sortie par défaut
Lors de l’ajout d’une substance dans une fente (comme la fente de matériau de l’outil d’un calque de remplissage), il est possible de spécifier via le champ de texte des métadonnées de ne pas activer un canal spécifique :
- Sur un nœud de sortie spécifique (comme un matériau) : disable=(true)
- Sur un nœud de sortie générique (comme un filtre) : disable=(height, diffusion, specular)
Lors du chargement de la substance, ce canal ne sera pas activé dans l’interface utilisateur et n’aura donc aucun effet sur la pile de calques. L’utilisateur peut toujours réactiver le canal.
Désigner une sortie comme masque/alpha commun
La sortie d’un graphe de Substance peut être utilisée comme canal Alpha/masque partagé sur les autres sorties.
Il y a deux façons de le faire :
- Créer un nœud de sortie avec l’identifiant canaux_Alpha
- Ou ajoutez les données utilisateur suivantes sur un nœud de sortie spécifique : IsChannelsAlpha=true
Certaines conditions peuvent s’appliquer :
- Si un nœud de sortie avec l’identifiant canaux_Alpha existe et que d’autres sorties ne disposent pas des données utilisateur, ce nœud sera utilisé comme masque de canaux.
- Si une sortie contient les données utilisateur, elle sera utilisée comme masque de canaux tant qu’aucun nœud canaux_Alpha n’existe.
- S’il existe à la fois un nœud canaux_Alpha et un nœud avec les données utilisateur, le nœud de sortie canaux_Alpha sera utilisé en premier.
- Si plusieurs nœuds possèdent les données utilisateur, le premier nœud trouvé par l’application sera utilisé comme masque de canaux. L’ordre dans lequel les sorties sont trouvées n’est pas garanti de la même manière que celle définie par le graphe de Substance.
Définition du mode de fusion par défaut pour les sorties Matériau
Il est possible de définir ce que doit être le mode de fusion d’une sortie spécifique dans un graphe de Substance lorsque vous faites glisser des matériaux depuis l’Étagère vers le viewport ou la pile de calques.
- Sur un nœud de sortie spécifique : blendingmode=normal
Liste des modes de fusion pris en charge :
- normal
- passthrough
- désactiver
- remplacer
- multiplier
- diviser
- inverser la division
- obscurcir
- éclaircir
- densité linéaire
- soustraire
- inversesubtract
- différence
- exclusion
- signedaddition
- incrustation
- écran
- brûlure linéaire
- brûlure de couleur
- colordodge
- lumière douce
- lumière crue
- vividlight
- lumière du jour
- teinte
- saturation
- couleur
- valeur
- combinaison normale
- détail normal
- normalinversedetail