Visão geral

Os arquivos de configuração do projeto são os arquivos mais complexos e expansivos usados para configurar o Substance 3D Designer.

Eles são especiais porque você pode usar vários arquivos de configuração de projeto, onde cada próximo projeto “filho” expande ou substitui o anterior “pai”. A menos que seja explicitamente necessário, as configurações não devem ser modificadas nem adicionadas aos arquivos de projeto, para que o Designer possa recorrer à sua configuração pai ou até mesmo aos padrões.

Por padrão, o Designer tem duas configurações de projeto ativas:

Projeto Padrão: Contém todas as configurações padrão e a biblioteca com a qual o Designer vem em uma nova instalação.Somente leitura, não pode ser modificado nem removido.

Projeto de Usuário: como os Padrões são somente leitura, todas as alterações feitas pelo usuário entram neste projeto por padrão. Não pode ser removido.

Esta configuração básica garante que a biblioteca padrão e outras configurações não possam ser corrompidas ou modificadas, mas ainda permite que usuários amadores únicos adicionem suas próprias modificações sem ter que se preocupar com configurações complexas.

Expandir ou substituir

A maioria das configurações em um Projeto consecutivo substituirá as do Projeto anterior. Por exemplo, um plug-in diferente do Tangent Space em um arquivo de projeto personalizado substituirá qualquer plug-in TS definido no projeto padrão ou do usuário. Isso significa que, a menos que explicitamente necessário, é recomendado não substituir ou alterar as configurações em projetos filho.

No entanto, há algumas configurações que se expandem nas configurações pai, em vez de substituí-las. Essas configurações destacam-se pelos caminhos e filtros da biblioteca, então adicione mais conteúdo à biblioteca em vez de substituí-lo. Além disso, há os aliases (palavras-chave de caminho para caminhos de arquivo relativos) que se expandem, bem como substituem se uma duplicata for definida. Isso permite um grande controle sobre caminhos de arquivo de conteúdo e referências.

Conteúdo do arquivo de projeto

Os arquivos de projeto podem conter as seguintes configurações:

Visualização 3D: Sombreador padrão, HDR e definições de estado de cena.

Aliases: Aliases de palavras-chave para caminhos relativos.

Preparação: Configurações para convenções de nomenclatura de cozimento.

Geral: Modelos de gráfico, plug-ins de espaço tangente, padrões de formato normal e de imagem.

Biblioteca: caminhos observados a serem exibidos na biblioteca.

Script: Scripts e interpretadores de retorno de chamada.

Controle de Versão: Configurações para integrar o controle de Versão no Designer.

Modificação de arquivos de projeto

As configurações de projeto são, como todos os outros tipos, salvas como arquivos XML estruturados (usando uma extensão .sbsprj) que podem ser modificados por meio da interface do usuário do Designer ou de um editor de texto externo.

Por dentro do Substance 3D Designer

Consulte a página Configurações do projeto para saber mais sobre como gerenciar arquivos de projeto e alterar as configurações do projeto.

Os arquivos de projeto também incluem categorias e filtros personalizados para a Biblioteca, sobre a qual você pode saber mais na página Gerenciar conteúdo e filtros personalizados.

Editar XML Externamente

Para o Windows, o Bloco de Notas++ é uma boa opção gratuita. No macOS, o Texto Sublime é uma alternativa. Dito isso, qualquer editor com recuo apropriado, seção recolhendo e alguma forma de realce de sintaxe vai tornar sua vida muito mais fácil.

Depois de abrir o arquivo SBSPRJ em um editor, você verá um layout estruturado bastante direto, com seções correspondentes a guias na interface do usuário. Nem todas as configurações serão documentadas aqui, pois isso é razoavelmente autoexplicativo.

Caminhos e aliases relativos

Os caminhos relativos combinados com aliases são uma das partes mais complicadas, mas importantes, de uma configuração de projeto. Esta seção irá esclarecê-los. A adição de aliases personalizados para um arquivo de projeto específico é feita em Configurações do Projeto.

Um dos principais problemas com arquivos que fazem referência a outros arquivos em um sistema no computador de vários usuários é que os caminhos de arquivo absolutos não funcionarão. Os usuários podem definir seus repositórios SVN em locais completamente diferentes (por exemplo, C:/John/Gamedev/SubstanceLibrary ou D:/Dev/SubstanceLibrary). Aliases e caminhos relativos funcionam juntos para resolver esse problema. Caso contrário, você pode abrir o arquivo de outra pessoa e ele tentará procurar o nó personalizado usado no local específico em que o usuário o tinha localmente, o que você provavelmente não terá definido exatamente da mesma maneira.

Um alias é uma palavra-chave que substitui (parte de) um caminho. É semelhante a uma variável de ambiente do Windows, como %TEMP%, onde uma única palavra substitui um caminho frequentemente usado que é então definido centralmente. A vantagem é que há caminhos simplificados em todos os lugares e uma maneira de modificar todas as referências de uma só vez ao decidir realocar esse caminho.

Os caminhos relativos são sempre relativos ao arquivo em que estão definidos. Isso significa que o local atual do arquivo de configuração determina a maior parte do caminho, e os caminhos de alias serão baseados nele, principalmente apenas adicionando uma subpasta. Isso significa que é altamente recomendável colocar os arquivos sbsprj próximos às pastas que você deseja observar!

Por exemplo, pegue um repositório em C:/Versioncontrol/Substance/ contendo CustomProject.sbsprj e, em seguida, duas pastas, /Base e /Tools, contendo nós.

Para definir dois Aliases relativos para Base e Ferramentas, seria feito o seguinte no arquivo 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>

O resultado desse arquivo de configuração é o seguinte:

BaseAlias:// será C:/Versioncontrol/Substance/Base/ e ToolsAlias:// será C:/Versioncontrol/Substance/Tools/.

Se você desejar definir apenas C:/Versioncontrol/Substance/, o caminho será listado como ”file:.”, o ponto que significa o local do próprio arquivo.