DocumentaciónSubstance 3DSubstance 3D Designer

Configuración del proyecto

Última actualización: 11 de septiembre de 2026

Esta página presenta la configuración de proyectos en Substance 3D Designer y la configuración que contiene.

Substance 3D Designer le permite crear preferencias por proyecto y compartirlas entre estaciones de trabajo. Estas preferencias se encuentran en la pestaña Proyectos de la ventana Preferencias.

Esto es muy útil si quieres configurar un entorno de trabajo común para un equipo que trabaja en el mismo proyecto, usando el archivo de proyecto same en todos los sistemas.

NOTE
Para obtener más información sobre la configuración e integración de Substance 3D Designer en una canalización de producción, recomendamos encarecidamente que haga referencia a la sección Configuración de canalización y proyecto de la documentación.

Configuración del proyecto {modal="regular"}

Configuración

Archivo de configuración

Esto le permite establecer la ruta de acceso del archivo de configuración para Substance 3D Designer. Un archivo de configuración utiliza la extensión *.sbscfg y contiene una lista de archivos de proyecto junto con una configuración de presentación de compatibilidad establecida.

Valor predeterminado: default_configuration.sbscfg

NOTE
Puede usar la opción de línea de comandos —config-file para iniciar Designer con un archivo de configuración específico.
Para obtener más información sobre los archivos de configuración, consulte la página Lista de configuración - SBSCFG de la documentación.

Archivos de proyecto

Un archivo de proyecto contiene una serie de ajustes que definen aspectos clave del entorno de trabajo en Designer, organizados en fichas. Esta configuración se muestra en el capítulo Proyecto de esta página. Los archivos de proyecto utilizan la extensión *.sbsprj.

Puede importar varios archivos de proyecto para utilizarlos en su entorno de trabajo en Designer. Cuando existen varios archivos de proyecto, los ajustes que son listas (por ejemplo, rutas controladas de biblioteca, alias, etc.) son combined, y los valores de configuración que son valores de conjunto únicos están definidos por el último archivo de proyecto de la lista.

Valor predeterminado: default_project.sbsprj (solo lectura), user_project.sbsprj

NOTE
Para obtener más información sobre el uso de archivos de proyecto en una canalización de producción, consulte la página Archivos de configuración del proyecto - SBSPRJ de la documentación.

Pantalla de compatibilidad

Algunos de los nodos creados con una versión reciente de Designer no son compatibles con versiones anteriores del Substance Engine.

Modo de compatibilidad resaltará los nodos que no son compatibles con el Substance Engine seleccionado, con un contorno amarillo.

Valor predeterminado: Substance Engine v7

Vista 3D

Procesador predeterminado
Esta configuración le permite seleccionar el procesador 3D que debe usarse de forma predeterminada al iniciar una nueva vista 3D.

Valor predeterminado: Predeterminado (procesador predefinido)
Sombreador predeterminado
Esta configuración te permite seleccionar el sombreado que se debe usar de forma predeterminada al iniciar una nueva vista 3D ​

Predeterminada: open_pbr.glslfx
Mapa de entorno predeterminado
Esta configuración le permite seleccionar la textura que debe aplicarse de forma predeterminada al entorno al iniciar una nueva vista 3D ​

Predeterminada: panorama_map.hdr
Archivo de estado predeterminado
El archivo de estado de escena **de la ​vista 3D** incluye una serie de configuraciones para la vista 3D, como la posición de la cámara, la exposición del entorno y la malla. Se utiliza para almacenar el estado de la vista 3D para que pueda cargar rápidamente una escena que se adapte a sus necesidades. Los archivos de estado de escena utilizan la extensión *.sbsscn.Esta configuración le permite seleccionar el archivo de estado de escena de la vista 3D que debe utilizarse al iniciar una nueva vista 3D. Alerta: Algunas actualizaciones de software pueden cambiar la forma en que se guardan o cargan los estados de escena. Si la escena está no restaurada correctamente, se recomienda establecer manualmente el estado deseado de la escena y volver a exportar el archivo de estado de escena que usa como predeterminado.

Valor predeterminado: Vacío (en este caso, se usa un estado de escena preestablecido)
Estado de iluminación predeterminado
Esta configuración le permite seleccionar cuál de las luces disponibles predefinidas debe habilitarse al iniciar un nuevo Vista 3D, si no hay ningún archivo establecido en el campo Archivo de estado predeterminado

Valor predeterminado: Solo luz ambiente

Alias

Los alias se usan para acortar rutas del sistema y permitir que los equipos compartan activos de manera más eficiente. Se utilizan alias en todo el software, así como en archivos SBS.

Esta configuración le permite agregar y editar alias. Cuando se aplica un alias, reemplaza la ruta asignada con la siguiente sintaxis: ://.

Ejemplo: si se coloca un recurso myResource en la carpeta myFolder en la ubicación C:/Users/user/Documents, al asignar esta ubicación a myalias se generará la ruta de acceso myalias://myFolder/myResource que se está utilizando en la aplicación y el paquete SBS al que pertenece el recurso.

Valor predeterminado: sbs; sd-3dview-shapes; sd-3dview-maps; sd-3dview-shaders (proyecto predeterminado)

WARNING
Los alias son globales para la aplicación. Esto significa que se aplicarán a todas las rutas utilizadas en la aplicación, así como a todas las rutas de archivos de configuración de proyecto SBSPRJ cargados. Tenga esto en cuenta al configurar el entorno del proyecto.
Además, se recomienda no anidar alias, es decir, asignar un alias a una ruta que también está incluida en otro alias.

Bakers

Nombre de recurso predeterminado
Esta configuración le permite establecer una plantilla de nomenclatura predeterminada que se utilizará para los archivos de imagen de salida. Los alias disponibles en la ventana de hacer un bake también se pueden usar aquí (p. ej. $(mesh), $(bakername), $(udim), $(custom))

Valor predeterminado: $(mesh)_$(bakername)
Ajuste preestablecido predeterminado
Al abrir la ventana de hacer un bake, puedes configurarla ya con bakeres y configuraciones específicas usando esta opción para apuntar a un archivo JSON de ajustes preestablecidos. Este archivo se puede exportar desde la ventana de hacer un bake una vez que se haya configurado según sus necesidades

Valor predeterminado: Ninguno
modo de filtro de nombres

El objeto de escena cuyo nombre debe utilizarse para hacer coincidir los objetos de escena de poli bajo y poli alto:

  • Nombre de la geometría: utilizar el nombre del objeto de geometría de malla
  • Nombre del padre (heredado): usar el nombre del padre del objeto de geometría de malla (igual que en las versiones 14.1 y anteriores de Designer)

Valor predeterminado: Nombre de geometría

Macros de nombre de recurso
En lugar del alias $(bakername), puede usar sus propias cadenas de caracteres para cada baker. Cuando se use el alias $(custom) en el nombre de imagen de salida de cualquier baker, se reemplazará por la cadena de caracteres que coincida con ese baker en la lista. Si se deja en blanco una celda de la lista correspondiente a un panadero, el alias $(custom) no se reemplazará para este panadero.Ejemplo: El valor “c-mesh” asignado al panadero “Curvature Map From Mesh” cambiará automáticamente el nombre de t_mymesh_​$(custom) por t_mymesh_​c-mesh para la salida del panadero Curvature From Mesh *only *

Predeterminado: Ninguno
Filtro de nombre de submallas
Cuando se usa la opción Coincidir por nombre en panaderos, las partes de las versiones de baja y alta definición de una malla se coinciden si el nombre de las partes anteriores a los sufijos definidos es idéntico. Esta configuración le permite establecer sus propios sufijos para que se ajusten a su flujo de trabajo específico. Las partes coincidentes de las mallas pueden hacer que los rayos ignoren la geometría no deseada en las operaciones de horneado.Ejemplo: el objeto body-torso​_low de la malla body.fbx coincidiría con el objeto body-torso​_high ​ en body_high.fbx, si estos objetos existen en estas mallas .Valor predeterminado: _low (Malla de poli baja) / _high (Malla de poli alta)*Del mismo modo,​backfaces​se pueden omitir de forma selectiva para las partes de una malla cuyo nombre incluya el ​ sufijo​definido, para panaderos específicos que incluyen la opción ​ Ignorar cara posterior*

* Valor predeterminado: _ignorebf Nota:* Los sufijos Ignorar malla de fondo y Poly alta/baja se pueden combinar en cualquier orden (p. ej. body-torso_low_ignorebf)

Gestión de colores

Consulte la página Administración de color.

WARNING
Los cambios realizados en esta configuración surtirán efecto después de reiniciar Designer.

General

Plantillas de Substance
Al crear un nuevo gráfico, se le pide que empiece a trabajar con una plantilla que puede tener una serie de configuraciones y contenido preconfigurados, como salidas (p. ej. PBR (Metallic/Roughness)). Esta configuración le permite dirigir Designer a directorios en los que puede almacenar sus propios archivos SBS para utilizarlos como plantillas. Las plantillas personalizadas se agregarán a la lista al crear un nuevo gráfico

*Valor predeterminado: Ninguno *

Nota: Se recomienda utilizar las plantillas actuales como referencia para configurar y dar formato a los archivos SBS de plantilla. Las plantillas se encuentran en la carpeta resources > templates del directorio de instalación de Substance 3D Designer.
Escenas 3D
De forma predeterminada, Designer utiliza el espacio de tangente MikkT en la vista 3D. MikkT se usa mucho y es el valor predeterminado en programas como Unity, Unreal Engine 4, Blender y xNormal. Puede usar su propio espacio tangente para la vista 3D, que proporciona a Designer en forma de una entrada de archivo DLL en esta configuración. La etiqueta se detecta automáticamente a partir del archivo DLL y puede editar la descripción del complemento

Default: mikktspace.dll Volver a calcular siempre los fotogramas tangentes

Valor predeterminado: Desmarcado​Ángulo de suavizado normal y tangente

Valor predeterminado: 180,0°
Misc
Las asignaciones normales se pueden generar o procesar usando el formato DirectX o OpenGL. Esta configuración establece el valor de este formato en varios lugares, como propiedades de material en la Vista 3D y los parámetros de nodo de filtro Normal.

Valor predeterminado: DirectX

En lo que respecta al nodo de filtro Normal, puedes establecer el valor predeterminado para el parámetro Contenido del canal del Alpha. Puede elegir forzar el valor alfa a 1 en todos los casos o rellenarlo con información de su entrada.

Valor predeterminado: Forzar el Alpha a 1
Formatos de imagen
Esto te permite especificar la configuración de formato predeterminada para imágenes exportadas

Valor predeterminado: Predeterminado (BMP) / Onda basada en Piz, sin marcar, sin marcar (EXR) / Sin marcar, sin marcar, 75 (JPG) / Mejor velocidad, sin marcar (PNG) / Predeterminado (TGA) / LZW (TIF) / Sin marcar, 75 (WEBP)
Rutas de dependencias

Los paquetes SBS suelen tener dependencias, es decir, dependen de recursos externos, como otros paquetes SBS, mapas de bits o archivos de vectores.
Estas dependencias, que se enumeran en el Administrador de dependencias, se almacenan y se hace referencia a ellas en el paquete SBS con una ruta que señala a estos recursos.

Para las dependencias que incluyen la misma ruta que el paquete SBS (es decir, que se encuentran en las mismas ubicaciones o subcarpetas de esa ubicación), la ruta de referencia se escribe relativa a la ubicación del paquete SBS.

Ejemplo: para un paquete SBS myproject/mypackage.sbs, una imagen myproject/myfolder/myimage.png se hará referencia a myfolder/myimage.png ruta de acceso en mypackage.sbs).

Para las dependencias que no incluyen la misma ruta de acceso que el paquete SBS (es decir, están ubicadas en una ubicación totalmente diferente del paquete SBS), puede elegir cómo se escribe la ruta de acceso.

Si se establece en rutas relativas, se hará referencia al recurso de la misma manera que se describe anteriormente.

Ejemplo: para un paquete SBS myparentfolder/myproject/mypackage.sbs, una imagen myparentfolder/myotherfolder/myimage.png se hará referencia a …/myotherfolder/myimage.png ruta de acceso en mypackage.sbs.

Si se establece en rutas absolutas, se hará referencia al recurso mediante su ruta de acceso completa del sistema.

Ejemplo: para un paquete SBS myparentfolder/myproject/mypackage.sbs, una imagen myparentfolder/myotherfolder/myimage.png se hará referencia a esta misma ruta completa en mypackage.sbs

Valor predeterminado: …rutas relativas.

Nota: En todos los casos, mover los recursos romperá dependencias , lo que dará como resultado nodos de instancia de Ghost en gráficos. Para consolidar todas las dependencias en una sola carpeta de proyecto junto con el paquete SBS, puede usar la opción Exportar con dependencias… características en el panel Explorador. Esto crea de manera efectiva una carpeta de proyecto autocontenida que se puede mover libremente.

Biblioteca

Esta sección te permite administrar el contenido personalizado de la biblioteca.

El contenido de todas las carpetas enumeradas en la lista Rutas añadidas se incluirá en la biblioteca. Cualquier cambio en el contenido se refleja en la biblioteca, después de un período de actualización que se puede establecer en la biblioteca pestaña de la ventana Preferencias.

En las columnas de la lista, puede encontrar opciones que le proporcionan un control más granular sobre la forma en que el contenido de estas carpetas se agrega a la biblioteca:

  • Habilitado: El contenido de la carpeta se muestra en la biblioteca (Predeterminado: Comprobado)
  • Recursivo: El contenido de todas las carpetas secundarias también se muestra en la biblioteca (Predeterminado: Comprobado)
  • Excluir patrón: Los archivos cuyo nombre coincide con la entrada Regex (expresión regular) son no mostrados en la biblioteca (p. ej. wip-*). Obtenga más información sobre la sintaxis de la expresión regular aquí
  • Excluir extensión: Los archivos que extensión incluye la cadena de texto de entrada no se muestran en la biblioteca. Las cadenas múltiples deben estar separadas por ; puntos y comas. (E.g. jpg;png;tif;fbx)

Si SBS paquetes se agregan a la biblioteca, los gráficos y recursos que contiene se pueden mostrar en la biblioteca como entradas independientes, si su parámetro Visible en biblioteca está establecido en ‘Sí’.
Hay opciones disponibles para definir si este parámetro debe establecerse en ‘Sí’ de forma predeterminada al crear o agregar un nuevo gráfico o recurso en un paquete.

Valor predeterminado: Comprobado

Si un documento de Photoshop (*.PSD file) incluido en la biblioteca tiene varias capas, una opción te permite mostrar el contenido de* cada capa como una entrada de imagen independiente* en la biblioteca.

Valor predeterminado: Comprobado

NOTE
Aunque los recursos personalizados se agregarán a la biblioteca, es posible que no esté visible debido a las reglas de filtrado establecidas para las categorías de biblioteca existentes. Se recomienda crear filtros propios organizados en carpetas para garantizar que el contenido se pueda encontrar de manera fiable mientras se trabaja en los proyectos.
Consulte la sección Administración de contenido y filtros personalizados de la documentación para obtener más información.

Python

Substance 3D Designer cargará automáticamente todos los complementos ubicados en las carpetas que agregue a la lista Url.

Valor predeterminado: Ninguno

WARNING
Los cambios realizados en esta configuración surtirán efecto después de reiniciar Designer.
Los paquetes de complementos aún deben instalarse manualmente con el Administrador de complementos.

Scripts

WARNING
Esta característica se retirará en una futura versión para favorecer la API de Python, que es más robusta. Por lo tanto, le recomendamos que modifique los scripts lo antes posible.
Puede ir a la página Devoluciones de llamadas de aplicación en la sección Secuencias de comandos de nuestra documentación para comenzar.

Esta sección te permite configurar y controlar scripts para que se ejecuten cuando se produzcan eventos específicos en Designer. Resulta especialmente útil cuando se usa junto con la integración de Perforce, que se puede configurar en la ficha Control de versiones de la configuración del proyecto.

Acciones

Designer tiene desencadenadores de devolución de llamada preconfigurados, que ejecutarán el script que proporciones mediante el intérprete configurado en la lista de intérpretes que se describe a continuación.Las devoluciones de llamada incluidas son las siguientes:

  • onBeforeFileLoaded: ejecuta el script antes de que se cargue un paquete de SBS
  • onAfterFileLoaded: ejecuta el script after después de cargar un paquete de SBS
  • onBeforeFileSaved: ejecuta el script antes de que se guarde un paquete SBS
  • onAfterFileSaved: ejecuta el script después de guardar un paquete SBS
  • getGraphExportOptions: ejecuta el script cuando se llaman las opciones Export Outputs

Se incluye un script Python en los archivos de instalación, con las funciones desencadenadas por cada devolución de llamada ya configuradas y listas para usarse. Puede utilizarlo como punto de partida y añadir funciones según sus necesidades. Este script es functions.py, que se encuentra en la carpeta tools > scripting de los archivos de instalación

*Predeterminado: Ninguno *

Nota: Al principio, al seleccionar un script para cualquiera de las devoluciones de llamada, se introducirá ese script en todas las devoluciones de llamada para mayor comodidad. Puede configurar libremente diferentes scripts para devoluciones de llamada específicas después de ese punto.

Intérpretes
En esta lista, puede proporcionar intérpretes específicos que Designer debe usar para ejecutar los scripts configurados en la lista Actions descrita anteriormente. Los intérpretes se identifican mediante un alias personalizado que puedes editar en el campo de texto de cada entrada de la lista.Un intérprete de Python 3.6 se incluye con los archivos de instalación de Designer. Puedes encontrarlo en la carpeta plugins > pythonsdk de los archivos de instalación

Predeterminado: Ninguno

Control de versión

WARNING
Perforce es la herramienta only que se admite actualmente para el control de versiones.

Consulte la página Control de versiones.

¿Cómo deberías usar esto?

Debe establecer todas las preferencias específicas del proyecto en un archivo de proyecto (*.sbsprj) en Designer. Estas preferencias incluyen:

Todas las rutas de acceso se almacenan en relación con el archivo de proyecto (.spsprj). para que puedas tener una carpeta library en la misma ubicación que tu archivo de proyecto en Perforce, con el siguiente árbol de subcarpetas :

  • mapas/
  • mallas/
  • sbs/
  • sbsar/
  • psd/
  • Vista 3D/
  • …

En el mismo nivel que el archivo de proyecto, también puede almacenar un complemento de espacio tangente o un sombreador predeterminado.

El archivo de configuración (*.sbscfg) debe colocarse en el espacio de trabajo de Perforce, junto al archivo de proyecto.

NOTE
Para obtener más información sobre la configuración e integración de Substance 3D Designer en una canalización de producción, recomendamos encarecidamente que haga referencia a la sección Configuración de canalización y proyecto de la documentación.
recommendation-more-help
substance-3d-designer-help-guide