Vue d’ensemble

Les fichiers de configuration de projet sont les fichiers les plus complexes et les plus volumineux utilisés pour configurer Substance 3D Designer.

Ils sont spéciaux dans la mesure où vous pouvez utiliser plusieurs fichiers de configuration de projet, où chaque projet « enfant » suivant développe ou remplace le « parent » précédent. À moins que cela ne soit explicitement nécessaire, les paramètres ne doivent pas être modifiés ou ajoutés aux fichiers du projet, de sorte que Designer puisse revenir à sa configuration parent, voire même aux valeurs par défaut.

Icône de fichier

Par défaut, Designer a deux configurations de projet actives :

Projet par défaut :contient tous les paramètres par défaut et la bibliothèque Designer est livrée avec une nouvelle installation.Lecture seule, modification ou suppression impossible.

Projet utilisateur :Étant donné que les valeurs par défaut sont en lecture seule, toutes les modifications effectuées par l’utilisateur sont appliquées par défaut à ce projet. Impossible de supprimer.

Cette configuration de base garantit que la bibliothèque par défaut et les autres paramètres ne peuvent pas être corrompus ou modifiés, tout en permettant aux utilisateurs amateurs uniques d’ajouter leurs propres modifications sans avoir à se soucier des configurations complexes.

Développer ou remplacer

La plupart des paramètres d’un projet consécutif remplaceront ceux du projet précédent. Par exemple, un autre Plugin de repère tangent dans un fichier de projet personnalisé remplacera tout plug-in TS défini dans le projet Default ou User. Cela signifie qu’à moins d’en avoir explicitement besoin, il est recommandé de ne pas remplacer ou modifier les paramètres dans les projets enfants.

Certains paramètres se développent sur les paramètres parents, au lieu de les remplacer. Il s’agit principalement des chemins et des filtres de bibliothèque. Vous devez donc toujours ajouter plus de contenu à la bibliothèque au lieu de le remplacer. En outre, il y a les alias (mots-clés de chemin pour les chemins de fichiers relatifs) qui se développent, ainsi que le remplacement si un doublon est défini. Cela permet un excellent contrôle sur les chemins de fichiers de contenu et les références.

Contenu du fichier de projet

Les fichiers de projet peuvent contenir les paramètres suivants :

vue 3D :définitions d’état de Shader, HDR et scène par défaut.

Alias :Alias de mots-clés pour les chemins relatifs.

Baking :paramètres de baking des conventions de dénomination.

Général :modèles Graphe, plug-ins Repère tangent, formats normal et image par défaut.

Bibliothèque :Tracés suivis à afficher dans la bibliothèque.

Scripts :scripts et interpréteurs de rappel.

Gestion de versions :Paramètres d’intégration de la Gestion de versions dans Designer.

Modification de fichiers de projet

Les configurations de projet sont, comme tous les autres types, enregistrées en tant que fichiers XML structurés (à l’aide d’une extension .sbsprj) qui peuvent être modifiés via l’interface utilisateur de Designer ou via un éditeur de texte externe.

Dans Substance 3D Designer

Consultez la page Paramètres du projet pour en savoir plus sur la gestion des fichiers de projet et la modification des paramètres du projet.

Les fichiers de projet incluent également des catégories personnalisées et des filtres pour la bibliothèque, pour en savoir plus sur la page Gestion du contenu et des filtres personnalisés.

Modifier XML en externe

Pour Windows, le Bloc-notes++ est une bonne option gratuite. Sur macOS, Sublime Text est une alternative. Cela dit, n’importe quel éditeur avec la mise en retrait appropriée, la réduction de section et une certaine forme de mise en surbrillance de syntaxe vous rendra la vie beaucoup plus facile.

Une fois que vous avez ouvert le fichier SBSPRJ dans un éditeur, vous devriez voir une disposition structurée assez simple, avec des sections correspondant aux onglets dans l’interface utilisateur. Tous les paramètres ne seront pas documentés ici, car ils sont assez explicites.

Chemins relatifs et alias

Les chemins relatifs combinés avec des alias sont l’une des parties les plus complexes, mais les plus importantes d’une configuration de projet. Cette section les clarifiera. L’ajout d’alias personnalisés pour un fichier de projet spécifique est effectué dans les Paramètres du projet.

L’un des principaux problèmes avec les fichiers référençant d’autres fichiers dans un système sur le PC de plusieurs utilisateurs, est que les chemins de fichiers absolus ne fonctionneront pas. Les utilisateurs peuvent définir leurs référentiels SVN dans des emplacements complètement différents (p ex. C :/John/Gamedev/SubstanceLibrary ou D :/Dev/SubstanceLibrary). Les alias et les chemins relatifs fonctionnent ensemble pour résoudre ce problème. Sinon, vous pourriez ouvrir le fichier de quelqu’un d’autre et il essaiera de rechercher le nœud personnalisé utilisé dans l’emplacement spécifique où l’utilisateur l’avait localement, que vous n’aurez probablement pas défini exactement de la même manière.

Un alias est un mot-clé qui remplace (fait partie) d’un chemin. Il est similaire à une variable d’environnement Windows comme %TEMP%, où un seul mot remplace un chemin souvent utilisé qui est ensuite défini de manière centralisée. L’avantage est que les tracés sont simplifiés partout et qu’ils permettent de modifier toutes les références en une seule fois lorsque vous décidez de redéfinir l’emplacement ce tracé.

Les chemins relatifs sont toujours relatifs au fichier dans lequel ils sont définis. Cela signifie que l’emplacement actuel du fichier de configuration détermine la plupart du chemin, et les chemins d’alias seront basés sur celui-ci, principalement en ajoutant simplement un sous-dossier. Cela signifie qu’il est fortement recommandé de placer vos fichiers sbsprj à côté des dossiers que vous souhaitez consulter !

Par exemple, prenez un référentiel à l’emplacement C :/Versioncontrol/Substance/ contenant CustomProject.sbsprj, puis deux dossiers, /Base et /Tools, contenant des nœuds.

Pour définir deux alias relatifs pour Base et Outils, procédez comme suit dans le fichier SBSPRJ :

C:/Versioncontrol/Substance/CustomProject.sbsprj

   <urlaliases>

    <size>2</size>

    <_2 prefix="_">

     <path>file:Base</path>

     <name>BaseAlias</name>

    </_2>

    <_1 prefix="_">

     <path>file:Tools</path>

     <name>ToolsAlias</name>

    </_1>

   </urlaliases>

Le résultat de ce fichier de configuration est le suivant :

BaseAlias:// sera C :/Versioncontrol/Substance/Base/ et ToolsAlias:// sera C :/Versioncontrol/Substance/Tools/.

Si vous souhaitez définir uniquement C :/Versioncontrol/Substance/, le chemin d’accès sera indiqué comme « file:.«, le point indiquant l’emplacement du fichier lui-même.