DocumentationSubstance 3DSubstance 3D Designer

Paramètres du projet

Dernière mise à jour : 11 septembre 2026

Cette page présente les paramètres des projets dans Substance 3D Designer, ainsi que les paramètres qu’ils contiennent.

Substance 3D Designer vous permet de créer des préférences par projet et de les partager sur plusieurs postes de travail. Ces préférences se trouvent dans l’onglet Projets de la fenêtre Préférences.

Cela est très utile si vous souhaitez configurer un environnement de travail commun pour une équipe travaillant sur le même projet, en utilisant le fichier de projet same sur les systèmes all.

NOTE
Pour plus d'informations sur la configuration et l'intégration de Substance 3D Designer dans un pipeline de production, nous vous recommandons vivement de vous référer à la section Configuration du pipeline et du projet de la documentation.

Paramètres du projet {modal="regular"}

Configuration

Fichier de configuration

Cela vous permet de définir le chemin d’accès du fichier de configuration pour Substance 3D Designer. Un fichier de configuration utilise l’extension *.sbscfg et contient une liste de fichiers de projet ainsi qu’un paramètre d’affichage de compatibilité défini.

Par défaut : default_configuration.sbscfg

NOTE
Vous pouvez utiliser l'option de ligne de commande —config-file pour lancer Designer avec un fichier de configuration spécifique.
Pour plus d'informations sur les fichiers de configuration, vous pouvez vous référer à la page Liste de configuration - SBSCFG de la documentation.

Fichiers de projet

Un fichier de projet contient un certain nombre de paramètres qui définissent des aspects essentiels de l’environnement de travail dans Designer, organisés en onglets. Ces paramètres sont répertoriés dans le chapitre Projet de cette page. Les fichiers de projet utilisent l’extension *.sbsprj.

Vous pouvez importer plusieurs fichiers de projet à utiliser pour votre environnement de travail dans Designer. Lorsque plusieurs fichiers de projet existent, les paramètres qui sont des listes (par exemple, les chemins de contrôle de bibliothèque, les alias, etc.) sont combinés et les paramètres qui sont des valeurs uniques sont définis par le dernier fichier de projet de la liste.

Par défaut : default_project.sbsprj (lecture seule), user_project.sbsprj

NOTE
Pour plus d'informations sur l'utilisation de fichiers de projet dans un pipeline de production, vous pouvez vous référer à la page Fichiers de configuration de projet - SBSPRJ de la documentation.

Affichage de compatibilité

Certains des nœuds créés avec une version récente de Designer ne sont pas compatibles avec les anciennes versions de la Substance Engine.

Le mode de compatibilité mettra en surbrillance les nœuds non compatibles avec la Substance Engine sélectionnée, avec un contour jaune.

Par défaut : Substance Engine v7

Vue 3D

Moteur de rendu par défaut
Ce paramètre vous permet de sélectionner le rendu 3D qui doit être utilisé par défaut lors du démarrage d’une nouvelle vue 3D.

Par défaut : par défaut (rendu prédéfini)
shader par défaut
Ce paramètre vous permet de sélectionner le shader qui doit être utilisé par défaut lors du démarrage d’une nouvelle vue 3D ​

Configuration par défaut : open_pbr.glslfx
map d’environnement par défaut
Ce paramètre vous permet de sélectionner la texture qui doit être appliquée par défaut à l’environnement lors du démarrage d’une nouvelle vue 3D ​

Par défaut : panorama_map.hdr
Fichier d’état par défaut
Le fichier vue 3D État de la Scène inclut un certain nombre de paramètres pour la vue 3D, tels que la position de la caméra, l’exposition de l’environnement et le maillage. Il est utilisé pour stocker l’état de la vue 3D afin que vous puissiez charger rapidement une scène adaptée à vos besoins. Les fichiers d’état de scène utilisent l’extension *.sbsscn.Ce paramètre vous permet de sélectionner le fichier d’état de Scène de données vue 3D qui doit être utilisé lors du démarrage d’une nouvelle vue 3D. Alerte : certaines mises à jour logicielles peuvent modifier la façon dont les états de scène sont enregistrés/chargés. Si la scène de données n’est pas restaurée correctement, il est recommandé de définir manuellement l’état souhaité de la scène de données et de réexporter le fichier d’état de Scène de données que vous utilisez par défaut.

Par défaut : vide (dans ce cas, un état de scène prédéfini est utilisé)
État d’éclairage par défaut
Ce paramètre vous permet de sélectionner les lumières disponibles prédéfinies qui doivent être activées lors du démarrage d’une nouvelle vue 3D, si aucun fichier n’est défini dans le champ Fichier d’état par défaut

Par défaut : Lumière ambiante uniquement

Alias

Les alias sont utilisés pour raccourcir les chemins système et permettre aux équipes de partager les ressources plus efficacement. Les alias sont utilisés dans tout le logiciel ainsi que dans les fichiers SBS.

Ces paramètres vous permettent de ajouter et de modifier des alias. Lorsqu’un alias est appliqué, il remplace le chemin mappé en utilisant la syntaxe suivante : ://.

Exemple : si une ressource myResource dans le dossier myFolder est placée à l’emplacement C :/Users/user/Documents, le mappage de cet emplacement à myalias entraînera l’utilisation du chemin d’accès myalias://myFolder/myResource dans l’application et dans le package SBS auquel appartient la ressource.

Par défaut : sbs ; sd-3dview-shapes ; sd-3dview-maps ; sd-3dview-shaders (projet par défaut)

WARNING
Les alias sont globaux pour l'application. Cela signifie qu'ils seront appliqués à tous les chemins utilisés dans l'application, ainsi qu'à tous les chemins dans les fichiers de paramètres de projet SBSPRJ chargés. Gardez cela à l’esprit lors de la configuration de votre environnement de projet !
En outre, nous vous recommandons de ne pas imbriquer les alias, c'est-à-dire de créneler un chemin qui est également inclus dans un autre alias.

Bakers

Nom de ressource par défaut
Ce paramètre vous permet de définir un modèle de dénomination par défaut qui sera utilisé pour les fichiers image de sortie. Les alias disponibles dans la fenêtre de baking peuvent également être utilisés ici (par exemple, $(maillage), $(bakername), $(udim), $(custom))

Par défaut : $(maillage)_$(bakername)
Paramètre prédéfini par défaut
Lors de l’ouverture de la fenêtre de baking, vous pouvez la configurer avec des bakers et des paramètres spécifiques en utilisant cette option pour pointer vers un fichier JSON prédéfini. Ce fichier peut être exporté à partir de la fenêtre de baking une fois qu’il a été configuré selon vos besoins

Par défaut : aucun
mode de filtrage de nom

L’objet des scènes dont le nom doit être utilisé pour correspondre aux objets des scènes à faible et à fort poly :

  • Nom de la géométrie : utilisez le nom de l’objet géométrique du maillage
  • Nom du parent (hérité) : utilisez le nom du parent de l’objet géométrique du maillage (identique à celui utilisé dans Designer versions 14.1 et antérieures)

Par défaut : nom de la géométrie

Macros de nom de ressource
Au lieu de l’alias $(bakername), vous pouvez utiliser vos propres chaînes de caractères pour chaque baker. Lorsque l’alias $(personnalisé) est utilisé dans le nom d’image de sortie pour un baker, il est remplacé par la chaîne de caractères correspondant à ce baker dans la liste. Si une cellule de la liste correspondant à un baker reste vide, l’alias $(personnalisé) ne sera pas remplacé pour ce baker. Exemple : la valeur de 'c-maillage affectée au baker ‘Map curvature depuis le maillage’ renommera automatiquement t_mymesh_​$(personnalisé) en t_mymesh_​c-maillage pour la sortie du baker Courbure à partir du Maillage *uniquement *

Par défaut : aucun
Filtre Nom des sous-maillages
Lorsque vous utilisez l’option Correspondance par nom dans les bakers, les parties des versions basse et haute définition d’un maillage sont correspondantes si le nom de ces parties avant les suffixes définis est identique. Ce paramètre vous permet de définir vos propres suffixes en fonction de votre workflow spécifique. La correspondance de parties de maillages peut faire que les rayons ignorent la géométrie indésirable dans les opérations de baking. Exemple : l’objet body-torso​_low dans le maillage body.fbx correspondrait à l’objet body-torso​_high ​ dans body_high.fbx, si ces objets existent dans ces maillages .Par défaut : _low (Maillage low poly) / _high (Maillage high poly)*De même,​les faces arrière​peuvent être sélectionnées ignoré pour les parties d’un maillage dont le nom inclut le ​ suffixe​défini, pour les bakers spécifiques qui incluent l’option ​ Ignorer le dos*

* Par défaut : _ignorebf Remarque :* Les suffixes Ignorer le dos et Faible/Maillage high poly peuvent être combinés dans n’importe quel ordre (par exemple body-torso_low_ignorebf)

Gestion des couleurs

Consultez la page Gestion des couleurs.

WARNING
Les modifications apportées à ces paramètres prendront effet après le redémarrage de Designer.

Général

Modèles de Substance
Lors de la création d’un nouveau graphe, vous êtes invité à commencer à travailler à partir d’un modèle qui peut avoir un certain nombre de paramètres et de contenus préconfigurés, tels que des sorties (par exemple PBR (Métallique/Rugosité)). Ce paramètre vous permet de pointer Designer vers des répertoires où vous pouvez stocker vos propres fichiers SBS à utiliser comme modèles. Vos modèles personnalisés seront ensuite ajoutés à la liste lors de la création d’un nouveau graphe

*Par défaut : aucun *

Remarque : Nous vous recommandons d’utiliser les modèles actuels comme référence pour la configuration et le formatage de vos fichiers SBS de modèles. Les modèles se trouvent dans le dossier ressources > modèles du répertoire d’installation de Substance 3D Designer.
scènes 3D
Par défaut, Designer utilise l’espace de tangente MikkT dans vue 3D. MikkT est largement utilisé et constitue la valeur par défaut dans des programmes tels que Unity, Unreal Moteur 4, Blender et xNormal. Vous pouvez utiliser votre propre espace de tangente pour la vue 3D, que vous fournissez à Designer sous la forme d’un fichier DLL d’entrée dans ce paramètre. Le libellé est détecté automatiquement à partir du fichier DLL et vous pouvez modifier la description du plug-in

Par défaut : mikktspace.dll Toujours recalculer les cadres de tangente

Par défaut : décoché Angle de lissage normal et de Tangente

Par défaut : 180,0°
Divers
Les maps normal peuvent être générées ou traitées à l’aide du format DirectX ou OpenGL. Ce paramètre définit la valeur de ce format à plusieurs endroits, tels que les propriétés de matériau dans les paramètres de noeud de filtrage vue 3D et Normal.

Par défaut :

En ce qui concerne le noeud de filtrage Normal, vous pouvez définir la valeur par défaut pour le paramètre Contenu de Canal Alpha. Vous pouvez choisir de forcer l’alpha à 1 dans tous les cas ou de la remplir avec les informations de son entrée.

Par défaut : Forcer l’Alpha à 1
Formats d’image
Cela vous permet de spécifier les paramètres de format par défaut pour les images exportées

Par défaut : Ondelette par défaut (BMP)/Piz, décochée, décochée (EXR) / Décochée, décochée, 75 (JPG) / Meilleure vitesse, décochée (PNG) / Par défaut (TGA) / LZW (TIF) / Décochée, 75 (WEBP)
Chemins des dépendances

Les packages SBS ont généralement des dépendances, c’est-à-dire qu’ils dépendent de ressources externes telles que d’autres packages SBS, bitmaps ou fichiers vectoriels.
Ces dépendances, qui sont répertoriées dans le Gestionnaire de dépendances, sont stockées et référencées dans le package SBS avec un chemin qui pointe vers ces ressources.

Pour les dépendances qui incluent le même chemin que le package SBS (c’est-à-dire qu’elles se trouvent aux mêmes emplacements ou dans le(s) sous-dossier(s) à partir de cet emplacement), le chemin de référence est écrit par rapport à l’emplacement du package SBS.

Exemple : pour un package SBS myproject/mypackage.sbs, une image myproject/myfolder/myimage.png sera référencé à myfolder/myimage.png chemin dans mypackage.sbs).

Pour les dépendances qui n’incluent pas le même chemin d’accès que le package SBS (c’est-à-dire qui se trouvent à un emplacement complètement différent du package SBS), vous pouvez choisir la façon dont le chemin d’accès est écrit.

S’il est défini sur chemins relatifs, la ressource sera référencée de la même manière que décrite ci-dessus.

Exemple : pour un package SBS myparentfolder/myproject/mypackage.sbs, une image myparentfolder/myotherfolder/myimage.png sera référencé à …/myotherfolder/myimage.png chemin dans mypackage.sbs.

S’il est défini sur chemins absolus, la ressource sera référencée par son chemin système complet.

Exemple : pour un package SBS myparentfolder/myproject/mypackage.sbs, une image myparentfolder/myotherfolder/myimage.png sera référencé à ce même chemin complet dans mypackage.sbs

Par défaut : …chemins relatifs.

Remarque : dans tous les cas, le déplacement des ressources rompra les dépendances , ce qui entraînera la présence de nœuds d’instance de Fantôme dans les graphes. Pour consolider toutes les dépendances dans un seul dossier de projet avec le package SBS, vous pouvez utiliser les fonctionnalités Exporter avec les dépendances… dans le panneau Explorateur. Cela crée efficacement un dossier de projet autonome qui peut être déplacé librement.

Bibliothèque

Cette section vous permet de gérer le contenu personnalisé de la bibliothèque.

Le contenu de tous les dossiers répertoriés dans la liste Chemins ajoutés sera inclus dans la bibliothèque. Toute modification apportée au contenu est répercutée dans la bibliothèque, après une période d’actualisation qui peut être définie dans l’🔗ongletBibliothèque de la fenêtre Préférences.

Dans les colonnes de la liste, vous trouverez des options vous donnant un contrôle plus précis sur la façon dont le contenu de ces dossiers est ajouté à la bibliothèque :

  • Activé : le contenu du dossier est affiché dans la bibliothèque (Par défaut : coché)
  • Récursif : le contenu de tous les dossiers enfants est également affiché dans la bibliothèque (Par défaut : coché)
  • Exclure le modèle : Les fichiers dont name correspond à l’expression régulière d’entrée Regex (expression régulière) sont non affichés dans la bibliothèque (par exemple wip-*). En savoir plus sur la syntaxe d’expression régulière ici
  • Exclure l’extension : les fichiers qui incluent la chaîne de texte d’entrée ne sont pas affichés dans la bibliothèque. Les chaînes multiples doivent être séparées par ; points-virgules. (E.g. jpg;png;tif;fbx)

Si des packages SBS sont ajoutés à la bibliothèque, les graphes et les ressources qu’elle contient peuvent être affichés dans la bibliothèque en tant qu’entrées distinctes, si leur paramètre Visible dans la bibliothèque est défini sur ‘Oui’.
Des options sont disponibles pour définir si ce paramètre doit être défini sur ‘Oui’ par défaut lors de la création/l’ajout d’un nouveau graphe ou d’une nouvelle ressource dans un package.

Par défaut : coché

Si un document Photoshop (fichier*.PSD) inclus dans la bibliothèque comporte plusieurs calques, une option vous permet d’afficher le contenu de* chaque calque sous la forme d’une entrée d’image distincte* dans la bibliothèque.

Par défaut : coché

NOTE
Vos ressources personnalisées seront ajoutées à la bibliothèque, mais elles risquent de ne pas être visibles en raison des règles de filtrage définies pour les catégories de bibliothèque existantes. Nous vous recommandons de créer vos propres filtres organisés dans des dossiers, pour garantir la fiabilité de la recherche de votre contenu lorsque vous travaillez sur vos projets.
Voir la section Gestion du contenu et des filtres personnalisés de la documentation pour plus d'informations.

Python

Substance 3D Designer chargera automatiquement tous les plug-ins situés dans les dossiers que vous ajoutez à la liste Url.

Par défaut : aucun

WARNING
Les modifications apportées à ces paramètres prendront effet après le redémarrage de Designer.
Les packages de plug-ins doivent encore être installés manuellement à l'aide du gestionnaire de plug-ins.

Script

WARNING
Cette fonctionnalité sera retirée dans une prochaine version en faveur de l'API Python plus robuste. Par conséquent, nous vous recommandons de basculer vos scripts dès que possible.
Pour commencer, vous pouvez accéder à la page Rappels d'application dans la section Scripts de notre documentation.

Cette section vous permet de configurer et de contrôler scripts à exécuter lorsque des événements spécifiques se produisent dans Designer. Elle est particulièrement utile lorsqu’elle est utilisée conjointement avec l’intégration Perforce qui peut être configurée dans l’onglet Gestion de versions des paramètres du projet.

Actions

Designer a préconfiguré des déclencheurs de rappels, qui exécuteront le script que vous fournissez à l’aide de l’interpréteur configuré dans la liste Interpréteurs décrite ci-dessous.Les rappels inclus sont les suivants :

  • onBeforeFileLoaded : exécute le script avant le chargement d’un package SBS
  • onAfterFileLoaded : exécute le script après le chargement d’un package SBS
  • onBeforeFileSaved : exécute le script avant l’enregistrement d’un package SBS
  • onAfterFileSaved : exécute le script après l’enregistrement d’un package SBS
  • getGraphExportOptions : exécute le script lorsque les options Exporter les sorties sont appelées

Un script Python est inclus dans les fichiers d’installation. Les fonctions déclenchées par chaque rappel sont déjà configurées et prêtes à être utilisées. Vous pouvez l’utiliser comme point de départ et ajouter des fonctionnalités en fonction de vos besoins. Ce script est function.py. Il se trouve dans le dossier tools > scripting des fichiers d’installation

*Par défaut : aucun *

Remarque : Au départ, la sélection d’un script pour l’un des rappels entrera ce script dans les rappels tous pour des raisons de commodité. Vous pouvez librement configurer différents scripts pour des rappels spécifiques après ce point.

Interprètes
Dans cette liste, vous pouvez fournir des interpréteurs spécifiques que Designer doit utiliser pour exécuter les scripts configurés dans la liste Actions décrite ci-dessus. Les interprètes sont identifiés à l’aide d’un alias personnalisé que vous pouvez modifier dans le champ de texte de chaque entrée de la liste.Un interpréteur Python 3.6 est fourni avec les fichiers d’installation de Designer. Vous le trouverez dans le dossier plug-ins > pythonsdk des fichiers d’installation

Par défaut : aucun

Gestion de versions

WARNING
Perforce est l'outil uniquement qui est actuellement pris en charge pour la gestion de versions.

Reportez-vous à la page Gestion de versions.

Comment devriez-vous l’utiliser ?

Vous devez définir toutes les préférences spécifiques au projet dans un fichier de projet (*.sbsprj) dans Designer. Ces préférences sont les suivantes :

Tous les chemins sont stockés par rapport à le fichier de projet (.spsprj). ainsi, vous pouvez avoir un dossier bibliothèque au même emplacement que votre fichier de projet dans Perforce, avec l’arborescence de sous-dossiers suivante :

  • maps/
  • maillages/
  • sbs/
  • sbsar/
  • psd/
  • 3Dview/
  • …

Au même niveau que le fichier de projet, vous pouvez également stocker un plugin de repère tangent ou un shader par défaut.

Le fichier de configuration (*.sbscfg) doit être placé dans l’espace de travail Perforce à côté du fichier de projet.

NOTE
Pour plus d'informations sur la configuration et l'intégration de Substance 3D Designer dans un pipeline de production, nous recommandons vivement en nous référant à la section Configuration du pipeline et du projet de la documentation.
recommendation-more-help
substance-3d-designer-help-guide