Panoramica

I file di configurazione del progetto sono i file più complessi ed estesi utilizzati per configurare Substance 3D Designer.

Sono speciali in quanto consentono di utilizzare più file di configurazione del progetto, in cui ogni successivo progetto “secondario” espande o sostituisce il precedente progetto “principale”. A meno che non sia esplicitamente necessario, le impostazioni non devono essere modificate o aggiunte ai file di progetto, in modo che Designer possa ripristinare la configurazione principale o persino le impostazioni predefinite.

Per impostazione predefinita, Designer dispone di due configurazioni di progetto attive:

Progetto predefinito: Contiene tutte le impostazioni predefinite e la libreria Designer viene fornita con una nuova installazione.Sola lettura, impossibile modificare o rimuovere.

Progetto utente: Poiché i valori predefiniti sono di sola lettura, le modifiche apportate dall’utente verranno inserite in questo progetto per impostazione predefinita. Impossibile rimuovere.

Questa configurazione di base garantisce che la libreria predefinita e le altre impostazioni non possano essere danneggiate o modificate, ma consente comunque a singoli utenti amatoriali di aggiungere le proprie modifiche senza doversi preoccupare di impostazioni complesse.

Espandi o sostituisci

La maggior parte delle impostazioni in un progetto consecutivo sovrascriverà quelle del progetto precedente. Ad esempio, un plug-in diverso dello spazio tangente in un file di progetto personalizzato sostituirà qualsiasi plug-in di Servizi terminal definito nel progetto Predefinito o Utente. Ciò significa che, a meno che non sia esplicitamente necessario, si consiglia di non sovrascrivere o modificare le impostazioni nei progetti secondari.

Tuttavia, alcune impostazioni espandono in base alle impostazioni principali, anziché sostituirle. In particolare, queste impostazioni sono rappresentate dai percorsi e dai filtri della libreria, quindi è sempre possibile aggiungere più contenuto alla libreria invece di sovrascriverlo. Inoltre, sono presenti gli alias (parole chiave del percorso per i relativi percorsi di file) che si espandono, nonché l’override se viene definito un duplicato. Questo consente un grande controllo sui percorsi dei file di contenuto e sui riferimenti.

Contenuto del file di progetto

I file di progetto possono contenere le seguenti impostazioni:

Vista 3D: Definizioni di shader predefinito, HDR e stato della scena.

Alias: Alias parole chiave per percorsi relativi.

Cottura: Impostazioni per le convenzioni di denominazione della cottura al forno.

Generali: Modelli di grafico, plug-in per lo spazio tangente, impostazioni predefinite per formato immagine e normale.

Libreria: Percorsi controllati da visualizzare nella libreria.

Scripting: Script e interpreti di richiamata.

Controllo versione: Impostazioni per l’integrazione del controllo versione in Designer.

Modifica dei file di progetto

Come tutti gli altri tipi, le configurazioni di progetto vengono salvate come file XML strutturati (con estensione .sbsprj) che possono essere modificati tramite l’interfaccia utente di Designer o un editor di testo esterno.

All’interno di Substance 3D Designer

Per ulteriori informazioni sulla gestione dei file di progetto e sulla modifica delle impostazioni del progetto, vedere la pagina Impostazioni progetto.

I file di progetto includono anche categorie e filtri personalizzati per la libreria. Ulteriori informazioni sono disponibili nella pagina Gestione di contenuti e filtri personalizzati.

Modifica XML esternamente

Per Windows, Blocco note++ è una buona opzione gratuita. In macOS, Sublime Text è un’alternativa. Detto questo, qualsiasi editor con un rientro appropriato, la compressione della sezione e una qualche forma di evidenziazione della sintassi renderà la tua vita molto più facile.

Una volta aperto il file SBSPRJ in un editor, dovresti vedere un layout strutturato abbastanza semplice, con sezioni corrispondenti alle schede nell’interfaccia utente. Non tutte le impostazioni saranno documentate qui, poiché è abbastanza autoesplicativo.

Percorsi e alias relativi

I percorsi relativi combinati con gli alias sono una delle parti più complicate, ma più importanti, di una configurazione di progetto. In questa sezione verranno illustrati i dettagli. L’aggiunta di alias personalizzati per un file di progetto specifico viene eseguita nelle Impostazioni progetto.

Uno dei principali problemi con i file che fanno riferimento ad altri file in un sistema su più PC dell’utente, è che i percorsi di file assoluti non funzioneranno. Gli utenti possono definire i propri repository SVN in posizioni completamente diverse (ad es. C:/John/Gamedev/SubstanceLibrary o D:/Dev/SubstanceLibrary). Gli alias e i percorsi relativi funzionano insieme per risolvere il problema. In caso contrario, è possibile che si apra il file di un altro utente, che proverà a cercare il nodo personalizzato utilizzato nel percorso specifico in cui l’utente lo aveva localmente, che probabilmente non sarà stato definito esattamente nello stesso modo.

Un alias è una parola chiave che sostituisce (parte di) un percorso. È simile a una variabile di ambiente Windows come %TEMP%, in cui una singola parola sostituisce un percorso spesso utilizzato che viene quindi definito centralmente. Il vantaggio è costituito da tracciati semplificati ovunque e da un modo per modificare tutti i riferimenti in una volta sola quando si decide di riposizionare il tracciato.

I percorsi relativi sono sempre relativi al file in cui sono definiti. Ciò significa che la posizione corrente del file di configurazione determina la maggior parte del percorso e i percorsi degli alias saranno basati su di esso, principalmente aggiungendo solo una sottocartella. Si consiglia vivamente di posizionare i file sbsprj accanto alle cartelle che si desidera guardare.

Considerare ad esempio un repository in C:/Versioncontrol/Substance/ contenente CustomProject.sbsprj e quindi due cartelle, /Base e /Tools, contenenti nodi.

Per definire due alias relativi per Base e Strumenti, si procede come segue all’interno del file 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>

Il risultato di questo file di configurazione è il seguente:

BaseAlias:// sarà C:/Versioncontrol/Substance/Base/ e ToolsAlias:// sarà C:/Versioncontrol/Substance/Tools/.

Se si desidera definire solo C:/Versioncontrol/Substance/, il percorso verrà elencato come “file:.”, ovvero il punto che indica la posizione del file stesso.