Documentazione Substance 3D Substance 3D Designer

Impostazioni progetto

Ultimo aggiornamento: 11 settembre 2026

Questa pagina presenta le impostazioni dei progetti in Substance 3D Designer e le impostazioni contenute in.

Substance 3D Designer consente di creare preferenze per progetto e di condividerle tra le workstation. Queste preferenze sono disponibili nella scheda Progetti della finestra Preferenze.

Questo è molto utile se desideri configurare un ambiente di lavoro comune per un team che lavora sullo stesso progetto, utilizzando lo stesso file di progetto su tutti i sistemi.

NOTE

Per ulteriori informazioni sulla configurazione e l'integrazione di Substance 3D Designer in una pipeline di produzione, consigliamo vivamente facendo riferimento alla sezione Configurazione della pipeline e del progetto della documentazione.

Impostazioni progetto {modal="regular"}

Configurazione

File di configurazione

Ciò consente di impostare il percorso del file di configurazione per Substance 3D Designer. Un file di configurazione utilizza l’estensione *.sbscfg e contiene un elenco di file di progetto con un’impostazione di visualizzazione della compatibilità impostata.

Impostazione predefinita: default_configuration.sbscfg

NOTE

È possibile utilizzare l'opzione della riga di comando —config-file per avviare Designer con un file di configurazione specifico.
Per ulteriori informazioni sui file di configurazione, è possibile fare riferimento alla pagina Elenco di configurazione - SBSCFG della documentazione.

File di progetto

Un file di progetto contiene diverse impostazioni che definiscono gli aspetti principali dell’ambiente di lavoro in Designer, suddivise in schede. Queste impostazioni sono elencate nel capitolo Progetto di questa pagina. I file di progetto utilizzano l’estensione *.sbsprj.

Puoi importare più file di progetto da utilizzare per il tuo ambiente di lavoro in Designer. Quando sono presenti più file di progetto, le impostazioni che sono elenchi (ad esempio, percorsi controllati dalla libreria, alias e così via) sono combinati e le impostazioni che sono valori di set univoci sono definite dall’ultimo file di progetto dell’elenco.

Impostazione predefinita: default_project.sbsprj (sola lettura), user_project.sbsprj

NOTE

Per ulteriori informazioni sull'utilizzo dei file di progetto in una pipeline di produzione, è possibile fare riferimento alla pagina File di configurazione del progetto - SBSPRJ della documentazione.

Visualizzazione della compatibilità

Alcuni nodi creati con una versione recente di Designer non sono compatibili con versioni precedenti della Substance Engine.

La modalità di compatibilità evidenzierà i nodi non compatibili con la Substance Engine selezionata, con un contorno giallo.

Impostazione predefinita: Substance Engine v7

Vista 3D

Modulo di rendering predefinito

Questa impostazione consente di selezionare il modulo di rendering 3D che deve essere utilizzato per impostazione predefinita quando si avvia una nuova visualizzazione 3D.

Impostazione predefinita: impostazione predefinita (modulo di rendering predefinito)

Shader predefinito

Questa impostazione consente di selezionare lo shader da utilizzare per impostazione predefinita all’avvio di una nuova vista 3D

Impostazione predefinita: open_pbr.glslfx

Mappa ambiente predefinita

Questa impostazione consente di selezionare la texture da applicare per impostazione predefinita all’ambiente quando si avvia una nuova vista 3D

Impostazione predefinita: panorama_map.hdr

File di stato predefinito

Il file dello stato della scena della vista 3D include diverse impostazioni per la vista 3D, quali la posizione della fotocamera, l’esposizione dell’ambiente e la trama. Viene utilizzato per memorizzare lo stato della vista 3D in modo da poter caricare rapidamente una scena personalizzata in base alle proprie esigenze. I file di stato della scena utilizzano l’estensione *.sbsscn.Questa impostazione consente di selezionare il file di stato della scena della vista 3D da utilizzare quando si avvia una nuova vista 3D. Avviso: alcuni aggiornamenti software possono modificare il modo in cui gli stati della scena vengono salvati/caricati. Se la scena non è ripristinata correttamente, si consiglia di impostare manualmente lo stato desiderato della scena e di riesportare il file di stato della scena utilizzato come predefinito.

Impostazione predefinita: vuota (in questo caso, viene utilizzato uno stato di scena predefinito)

Stato illuminazione predefinito

Questa impostazione consente di selezionare quale delle luci disponibili predefinite attivare all’avvio di una nuova vista 3D, se non è impostato alcun file nel campo file di stato predefinito

Impostazione predefinita: solo luce ambiente

Alias

Gli alias vengono utilizzati per abbreviare i percorsi di sistema e consentire ai team di condividere le risorse in modo più efficiente. Gli alias vengono utilizzati in tutto il software e in file SBS.

Queste impostazioni consentono di aggiungere e modificare alias. Quando viene applicato un alias, sostituisce il percorso mappato utilizzando la seguente sintassi: ://.

Esempio: se una risorsa myResource nella cartella myFolder si trova nel percorso C:/Users/user/Documents, la mappatura di questo percorso a myalias determinerà l’utilizzo del percorso myalias://myFolder/myResource nell’applicazione e nel pacchetto SBS a cui appartiene la risorsa.

Predefinito: sbs; sd-3dview-shapes; sd-3dview-maps; sd-3dview-shaders (progetto predefinito)

WARNING

Gli alias sono globali per l'applicazione. Ciò significa che verranno applicati a tutti i percorsi utilizzati nell'applicazione, nonché a tutti i percorsi nei file delle impostazioni del progetto SBSPRJ caricati. È importante tenere presente questa limitazione quando si imposta l'ambiente del progetto.
Si consiglia inoltre di non nidificare alias, ad esempio eseguendo l'alias di un percorso incluso anche in un altro alias.

Baker

Nome risorsa predefinito

Questa impostazione consente di impostare un modello di denominazione predefinito che verrà utilizzato per i file di immagine di output. Gli alias disponibili nella finestra di cottura possono essere utilizzati anche qui (ad esempio $(mesh), $(bakername), $(udim), $(custom))

Impostazione predefinita: $(mesh)_$(bakername)

Predefinito predefinito

Quando apri la finestra di cottura, puoi configurarla già con specifici forni e impostazioni utilizzando questa opzione per puntare a un file di predefiniti JSON. Questo file può essere esportato dalla finestra di cottura una volta impostato in base alle tue esigenze

Impostazione predefinita: nessuna

Modalità filtro nomi

Oggetto scena che deve essere utilizzato come nome per abbinare gli oggetti di scena low poli e high poli:

Nome geometria: utilizzate il nome dell’oggetto geometria mesh
Nome principale (versione precedente): utilizzate il nome dell’elemento principale dell’oggetto della geometria della trama (come in Designer 14.1 e versioni precedenti)

Predefinito: nome geometria

Macro nome risorsa

Invece dell’alias $(bakername), puoi utilizzare stringhe di caratteri personalizzate per ogni fornaio. Quando l’alias $(custom) viene utilizzato nel nome dell’immagine di output per qualsiasi baker, verrà sostituito dalla stringa di caratteri corrispondente a tale baker nell’elenco. Se una cella dell’elenco corrispondente a un fornaio viene lasciata vuota, l’alias $(personalizzato) non verrà sostituito per questo fornaio.Esempio: il valore ‘c-mesh’ assegnato al fornaio ‘Curvature Map From Mesh’ rinominerà automaticamente t_mymesh_$(personalizzato) in t_mymesh_c-mesh per l’output del fornaio Curvature From Mesh *only *

Impostazione predefinita: None

Filtro nome mesh secondarie

Quando si utilizza l’opzione Corrispondenza per nome nei forni, le parti delle versioni a bassa e alta definizione di una trama sono corrispondenti se il nome di tali parti prima dei suffissi definiti è identico. Questa impostazione consente di impostare suffissi personalizzati in base al flusso di lavoro specifico. Le parti corrispondenti delle trame possono far sì che i raggi ignorino la geometria indesiderata nelle operazioni di cottura.Esempio: l’oggetto body-torso_low nella trama body.fbx corrisponderebbe all’oggetto body-torso_high  nel body_high.fbx, se questi oggetti esistono in queste trame .Impostazione predefinita: _low (Low Poly Mesh) / _high (High Poly Mesh)*Analogamente,backfacespossono essere ignorati in modo selettivo per le parti di una trama il cui nome include il  suffissodefinito, per specifici forni che includono l’opzione  Ignora backface*

* Impostazione predefinita: _ignorebf Nota:* I suffissi Ignora backface e Poly mesh bassa/alta possono essere combinati in qualsiasi ordine (ad esempio busto del corpo_basso_ignorebf)

Gestione del colore

Consultare la pagina Gestione colore.

WARNING

Le modifiche a queste impostazioni saranno effettive dopo il riavvio di Designer.

Generale

Modelli di Substance

Quando crei un nuovo grafico, ti viene chiesto di iniziare a lavorare su un modello che può avere diverse impostazioni e contenuti preconfigurati, come output (ad esempio PBR (metallizzato/rugosità)).Questa impostazione ti consente di puntare Designer verso directory in cui puoi archiviare i tuoi file SBS da utilizzare come modelli. I modelli personalizzati verranno quindi aggiunti all’elenco durante la creazione di un nuovo grafico

*Predefinito: Nessuno *

Nota: Si consiglia di utilizzare i modelli correnti come riferimento per la configurazione e la formattazione dei file SBS dei modelli. I modelli si trovano nella cartella risorse > modelli nella directory di installazione di Substance 3D Designer.

Scene 3D

Per impostazione predefinita, Designer utilizza lo spazio tangente MikkT nella vista 3D. MikkT è ampiamente utilizzato ed è l’impostazione predefinita in programmi quali Unity, Unreal Engine 4, Blender e xNormal.È possibile utilizzare il proprio spazio tangente per la vista 3D, che viene fornito a Designer sotto forma di un file DLL input in questa impostazione. L’etichetta viene rilevata automaticamente dal file DLL ed è possibile modificare la descrizione del plug-in

Predefinito: mikktspace.dll Ricalcola sempre i fotogrammi tangenti

Predefinito: Non selezionato Angolo di arrotondamento normale e tangente

Predefinito: 180.0°

Varie

Le mappe normali possono essere generate o elaborate utilizzando il formato DirectX o OpenGL. Questa impostazione consente di impostare il valore di questo formato in diversi punti, ad esempio proprietà materiali nella vista 3D e i parametri del nodo filtro Normale.

Impostazione predefinita:

Per quanto riguarda il nodo filtro Normale, è possibile impostare il valore predefinito per il parametro Contenuto canale Alpha. Puoi scegliere di forzare l’alfa a 1 in tutti i casi o riempirlo con informazioni dal suo input.

Impostazione predefinita: forza l’Alpha a 1

Formati immagine

Ciò consente di specificare le impostazioni di formato predefinite per immagini esportate

Predefinito: Wavelet predefinito (BMP) / basato su pixel, deselezionato, non selezionato (EXR) / Non selezionato, non selezionato, 75 (JPG) / Velocità massima, non selezionato (PNG) / Predefinito (TGA) / LZW (TIF) / Non selezionato, 75 (WEBP)

Percorsi dipendenze

I pacchetti SBS generalmente hanno dipendenze, ovvero dipendono da risorse esterne come altri pacchetti SBS, bitmap o file vettoriali.
Queste dipendenze, elencate in Gestione dipendenze, sono archiviate e referenziate nel pacchetto SBS con un percorso che punta a queste risorse.

Per le dipendenze che includono lo stesso percorso del pacchetto SBS (ovvero che si trovano nelle stesse posizioni o sottocartelle da quella posizione), il percorso di riferimento viene scritto rispetto a il percorso del pacchetto SBS.

Esempio: per un pacchetto SBS myproject/mypackage.sbs, un’immagine myproject/myfolder/myimage.png verrà fatto riferimento a myfolder/myimage.png percorso in pacchetto.sbs).

Per le dipendenze che non includono lo stesso percorso del pacchetto SBS (ovvero si trovano in una posizione completamente diversa dal pacchetto SBS), è possibile scegliere la modalità di scrittura del percorso.

Se è impostato su percorsi relativi, alla risorsa verrà fatto riferimento nello stesso modo descritto in precedenza.

Esempio: per un pacchetto SBS myparentfolder/myproject/mypackage.sbs, un’immagine myparentfolder/myotherfolder/myimage.png verrà fatto riferimento a …/myotherfolder/myimage.png percorso in pacchetto.sbs.

Se è impostato su percorsi assoluti, alla risorsa verrà fatto riferimento dal percorso di sistema completo.

Esempio: per un pacchetto SBS myparentfolder/myproject/mypackage.sbs, un’immagine myparentfolder/myotherfolder/myimage.png verrà fatto riferimento allo stesso percorso completo in mypackage.sbs

Impostazione predefinita: …percorsi relativi.

Nota: in tutti i casi, lo spostamento delle risorse comporterà interruzioni delle dipendenze, che produrranno nodi di istanza fantasma nei grafici. Per consolidare tutte le dipendenze in una singola cartella di progetto insieme al pacchetto SBS, puoi utilizzare le funzionalità Esporta con dipendenze… nel pannello Esplora risorse. In questo modo viene creata una cartella di progetto autonoma che può essere spostata liberamente.

Libreria

Questa sezione consente di gestire il contenuto personalizzato della libreria.

Il contenuto di tutte le cartelle elencate nell’elenco Percorsi aggiunti verrà incluso nella libreria. Eventuali modifiche apportate al contenuto vengono applicate alla libreria, dopo un periodo di aggiornamento che può essere impostato nella 🔗scheda scheda della finestra Preferenze della libreria.

Nelle colonne dell’elenco sono disponibili opzioni che consentono di controllare in modo più dettagliato il modo in cui il contenuto di queste cartelle viene aggiunto alla libreria:

Abilitato: Il contenuto della cartella è visualizzato nella libreria (Predefinito: Selezionato)
Ricorsivo: Il contenuto di tutte le cartelle secondarie viene visualizzato anche nella libreria (Predefinito: Selezionato)
Escludi modello: I file che nome corrisponde all’input Regex (espressione regolare) sono non visualizzati nella libreria (ad esempio wip-*). Ulteriori informazioni sulla sintassi dell’espressione regolare qui
Escludi estensione: I file che estensione includono la stringa di testo di input sono non visualizzati nella libreria. Più stringhe devono essere separate da ; punti e virgola. (E.g. jpg;png;tif;fbx)

Se i pacchetti SBS vengono aggiunti alla libreria, le grafiche e le risorse in essa contenute possono essere visualizzate nella libreria come voci separate, se il relativo parametro Visibile nella libreria è impostato su ‘Sì’.
Sono disponibili opzioni per definire se il parametro deve essere impostato su ‘Sì’ per impostazione predefinita durante la creazione o l’aggiunta di un nuovo grafico o di una nuova risorsa in un pacchetto.

Impostazione predefinita: selezionata

Se un documento di Photoshop (*.file PSD) incluso nella libreria contiene più livelli, un’opzione consente di visualizzare il contenuto di* ogni livello come voce di immagine separata* nella libreria.

Impostazione predefinita: selezionata

NOTE

Anche se le risorse personalizzate verranno aggiunte alla libreria, potrebbero non essere visibili a causa delle regole di filtro impostate per le categorie di libreria esistenti. Ti consigliamo di creare i tuoi filtri organizzati in cartelle, per garantire che i tuoi contenuti possano essere trovati in modo affidabile mentre lavori ai tuoi progetti.
Per ulteriori informazioni, vedere la sezione Gestione di contenuti e filtri personalizzati della documentazione.

Python

Substance 3D Designer caricherà automaticamente tutti i plug-in che si trovano nelle cartelle aggiunte all’URL.

Impostazione predefinita: nessuna

WARNING

Le modifiche a queste impostazioni saranno effettive dopo il riavvio di Designer.
I pacchetti di plug-in devono ancora essere installati manualmente utilizzando Gestione plug-in.

Scripting

WARNING

Questa funzione sarà ritirata in una versione futura, a favore della più robusta API Python. Pertanto, si consiglia di effettuare il cambiamento negli script il prima possibile.
Per iniziare, puoi accedere alla pagina Callback dell'applicazione nella sezione Scripting della nostra documentazione.

Questa sezione consente di impostare e controllare script da eseguire quando si verificano eventi specifici in Designer. È particolarmente utile se utilizzato insieme all’integrazione Perforce che può essere configurata nella scheda Controllo versione delle impostazioni del progetto.

Azioni

Designer ha preconfigurato trigger di callback, che eseguiranno lo script fornito utilizzando l’interprete configurato nell’elenco Interpreti descritto di seguito.I callback inclusi sono i seguenti:

onBeforeFileLoaded - esegue lo script prima del caricamento di un pacchetto SBS
onAfterFileLoaded: esegue lo script after quando viene caricato un pacchetto SBS
onBeforeFileSaved - esegue lo script prima del salvataggio di un pacchetto SBS
onAfterFileSaved - esegue lo script dopo il salvataggio di un pacchetto SBS
getGraphExportOptions: esegue lo script quando vengono chiamate le opzioni Output di esportazione

Nei file di installazione è incluso uno script Python, con le funzioni attivate da ogni callback già configurato e pronto per l’uso. Puoi usarlo come punto di partenza e aggiungere funzionalità in base alle tue esigenze. Questo script è functions.py e si trova nella cartella tools > scripting dei file di installazione

*Default: None *

Nota: Inizialmente, selezionando uno script per uno qualsiasi dei callback si immetterà lo script in tutti i callback. È possibile impostare liberamente script diversi per callback specifici dopo tale punto.

Interpreti

In questo elenco è possibile fornire interpreti specifici che Designer deve utilizzare per eseguire gli script impostati nell’elenco Azioni descritto in precedenza. Gli interpreti vengono identificati utilizzando un alias personalizzato che è possibile modificare nel campo di testo di ogni voce dell’elenco.Un interprete Python 3.6 è incluso nei file di installazione di Designer. Potete trovarlo nella cartella plugin > pythonsdk dei file di installazione

Predefinito: Nessuno

Controllo versioni

WARNING

Perforce è lo strumento only attualmente supportato per il controllo delle versioni.

Fare riferimento alla pagina Controllo versione.

Come si utilizza questo elemento?

È consigliabile impostare tutte le preferenze specifiche per il progetto in un file di progetto (*.sbsprj) in Designer. Queste preferenze includono:

Plug-in spazio tangente
Libreria
Alias
Impostazioni vista 3D
Impostazioni di cottura
Impostazioni controllo versione

Tutti i percorsi sono archiviati rispetto a il file di progetto (.sprj). in modo da avere una cartella libreria nella stessa posizione del file di progetto in Perforce, con la seguente struttura di sottocartelle:

mappe/
mesh/
sbs/
sbsar/
psd/
3Dview/
…

Sullo stesso livello del file di progetto, potete anche memorizzare un plug-in per lo spazio tangente o uno shader predefinito.

Il file di configurazione (*.sbscfg) deve essere inserito nell’area di lavoro di Perforce insieme al file di progetto.

NOTE

Per ulteriori informazioni sulla configurazione e l'integrazione di Substance 3D Designer in una pipeline di produzione , consigliamo vivamente facendo riferimento alla sezione Configurazione della pipeline e del progetto della documentazione.

recommendation-more-help

substance-3d-designer-help-guide