Proceso de sustitución de materiales | Twinmotion Documentación

Al importar o reimportar contenido en Twinmotion a través de Datasmith, puedes usar la función de sustitución de materiales para reemplazar los materiales de tus proyectos con otros de la biblioteca de Twinmotion. Cualquier material de la biblioteca de Twinmotion es válido para usar como reemplazo, incluidos también los siguientes:

Categoría Materiales
Megascans > Surfaces y las bibliotecas de Adobe Substance 3D
Biblioteca del usuario de Twinmotion

La información de las sustituciones de materiales se explica en el archivo de sustitución del material (una hoja de cálculo en formato CSV) que se instala automáticamente en el ordenador al mismo tiempo que Twinmotion. En esta hoja de cálculo, buscas el material del proyecto que quieres sustituir para hacerlo coincidir con el material de Twinmotion vas a usar como reemplazo.

Cuando hayas activado la función de sustitución de materiales e importado el proyecto en Twinmotion, podrás volver a sustituir otros elementos y aplicar los cambios en el proyecto reimportándolo a Twinmotion.

A la hora de seleccionar un material de Twinmotion como sustituto, tendrás la opción de usar los parámetros del material preestablecidos (como el color, la escala de UV o los ajustes de opacidad) o anularlos en el archivo de sustitución de materiales. Cuando importas o reimportas el proyecto en Twinmotion, los nuevos parámetros anulan automáticamente los ajustes predeterminados.

Por su parte, las texturas no se pueden establecer o anular durante el proceso de sustitución de materiales. Si quieres seleccionar o anular una textura, tendrás que editar el material directamente en Twinmotion.

Requisitos previos

Los materiales de la biblioteca de Twinmotion pueden ser locales o estar basados en la nube:

Los materiales locales se instalan automáticamente en el ordenador durante la instalación de Twinmotion.
Los materiales basados en la nube se guardan en un servidor dedicado en línea con el objetivo de disminuir los requisitos de almacenamiento local de tu ordenador. Antes de poder usarlos como sustitutos en Twinmotion, es necesario que descargues los materiales. Si quieres saber cómo descargar recursos en la nube de la biblioteca de Twinmotion, consulta Cómo acceder a recursos en la nube de Twinmotion.

Proceso para aplicar la sustitución de materiales

Durante el proceso de sustitución de materiales, se usan dos archivos en formato CSV, el archivo de sustitución de materiales y el archivo de identificación de materiales de Twinmotion. Puedes abrir archivos CSV con programas de hoja de cálculo como Microsoft Excel o Google Sheets, o con cualquier editor de texto, como Notepad o TextEdit.

Para sustituir materiales, haz lo siguiente:

Crea una nueva escena de Twinmotion.
Puedes importar el proyecto desde la aplicación de diseño en Twinmotion usando el Direct Link de Datasmith o el proceso de importación de archivos de Datasmith.
Tras realizar la importación de archivos, cuando se abra la ventana Import, haz lo siguiente:
1. En el menú desplegable Collapse, selecciona Collapse by material para agrupar por materiales. Esta opción agrupa todos los objetos del proyecto que usen el mismo material en una sola malla y muestra los nombres de todos los materiales incluidos en el proyecto en el gráfico de escena de Twinmotion. Más adelante, esta función será útil para identificar el nombre de los materiales que quieres sustituir.
2. Marca la casilla de verificación Enable Substitution para activar la función de sustitución de materiales. Si seleccionas esta opción, al importar o reimportar una escena en Twinmotion se aplicarán las sustituciones de materiales indicadas en el archivo CSV de sustitución.
3. Comprueba que la ruta del campo Substitution table lleve al archivo de sustitución de materiales (MaterialsSubstitutionTable_v[versión del archivo]_[versión de Twinmotion].csv) guardado en tu ordenador.
  Este archivo contiene la información de las sustituciones de materiales que se aplican durante la importación. Para obtener más información, consulta el apartado Información sobre el archivo de sustitución de materiales.
Genera un archivo de identificación de materiales de Twinmotion que contiene los nombres e identificadores únicos globales (GUID) de todos los materiales disponibles en Twinmotion que puedes usar como sustitutos. Para ello, ve a File > Export Materials IDs y se abrirá la ventana Export library.
Introduce el nombre de un archivo y selecciona una ubicación del ordenador donde guardarlo. Después, haz clic en Save.
Abre el archivo de sustitución de materiales llamado MaterialsSubstitutionTable_v[versión del archivo]_[versión de Twinmotion].csv, ubicado en la siguiente carpeta:
Windows: C:\Users\[usuario]\Documents\Twinmotion[versión]\Twinmotion\Content\Substitution
MacOS: HD:Users:[usuario]:Documents:Twinmotion[versión]:Substitution
Busca el nombre del material que quieras sustituir en Twinmotion mediante Material picker para escoger materiales y elige el material de un objeto de la escena.
El nombre y las propiedades del material se muestran en el panel Properties.
Material que se sustituirá en el panel de propiedades.
Al importar una escena en Twinmotion, es posible que el nombre de los materiales sea diferente. Los espacios y caracteres especiales de los nombres se sustituirán por guiones bajos. Por ejemplo, si tienes un material llamado «Cantaria - 12 26» en tu aplicación de diseño, pasará a llamarse «Cantaria_-_12_26» en Twinmotion.
Abre el archivo de identificación de materiales de Twinmotion que se ha creado y busca el GUID del material de Twinmotion que quieres usar como sustituto. El GUID está formado por una serie de caracteres alfanuméricos separados por guiones. Para obtener más información sobre el contenido de este archivo, consulta Información sobre el archivo de identificación de materiales de Twinmotion.
GUID de un material de Twinmotion.
En el archivo de sustitución de materiales, introduce los datos de la sustitución a partir de la fila 12 de la tabla de sustitución de material. Por defecto, estas filas del archivo de sustitución de materiales incluyen ejemplos de sustituciones para todo tipo de materiales base de Twinmotion. Puedes editar estas filas para indicar tus propias sustituciones de materiales.
Datos de la sustitución de un material del archivo de sustitución de materiales.
Para obtener más información, consulta Reglas de sustitución de materiales del apartado Información sobre el archivo de sustitución de materiales.
Para anular algunos parámetros de los materiales de Twinmotion, completa la información del apartado Anulaciones de parámetros de la columna I. Para obtener más información sobre los parámetros que puedes anular, consulta el apartado Anulaciones de parámetros.
Cuando hayas terminado de especificar las sustituciones, si has editado el archivo de sustitución de materiales en otro lugar distinto a su ubicación original (por ejemplo, si lo has subido y editado en Hojas de cálculo de Google), copia la versión que has editado y sobrescribe el archivo de sustitución predeterminado de la ubicación primera.
Dependiendo de si has importado un archivo .udatasmith en Twinmotion o si has creado un Direct Link, vuelve a importar el archivo .udatasmith en Twinmotion y actualiza el Direct Link.
Si quieres saber cómo reimportar un archivo .udatasmith, consulta Reemplazamiento o actualización de archivos de Datasmith en Twinmotion de la documentación Importación de archivos de Datasmith.
Para obtener más información sobre cómo actualizar un Direct Link de Datasmith, echa un vistazo a Cómo actualizar una escena en Twinmotion de la documentación Uso de Direct Link de Datasmith.
Cuando hayas reimportado la escena, las sustituciones de materiales se aplicarán a los materiales de la escena.

Información sobre el archivo de sustitución de materiales

El archivo de sustitución de materiales llamado MaterialsSubstitutionTable_v[versión del archivo]_[versión de Twinmotion].csv, contiene la tabla donde debes indicar los datos de las sustituciones de materiales. Durante la instalación de Twinmotion, también se instala automáticamente este archivo en la siguiente carpeta de tu ordenador:

Windows: C:\Users\[usuario]\Documents\Twinmotion[versión]\Twinmotion\Content\Substitution
MacOS: HD:Users:[usuario]:Documents:Twinmotion[versión]:Substitution

Al importar una escena en Twinmotion, la ruta por defecto del campo Substitution table de la ventana Import lleva al archivo de sustitución de materiales instalado en tu ordenador.

Haz clic en los tres puntos (…) que hay junto al campo Substitution table y se abrirá un menú con las siguientes opciones:

Clear: Borra el campo de Substitution table.
Copy: Copia la ruta del campo de Substitution table. Si quieres encontrar el archivo de sustitución de materiales en tu ordenador, selecciona Copy y pega la ruta en la barra de búsqueda de Finder o del explorador de archivos de Windows.
Paste: Pega el contenido del portapapeles en el campo de la tabla de sustitución. Puedes copiar la ruta del archivo de sustitución de materiales desde Finder o desde el explorador de archivos. Después, selecciona Pegar para pegarla en la tabla de sustitución.
Generate default table: Genera un nuevo archivo de sustitución de materiales predeterminado.

Reglas de sustitución de materiales

Es necesario crear una regla de sustitución de material para cada uno de los materiales que quieras sustituir. Las reglas de sustitución de materiales definen la información de la sustitución, como por ejemplo el material que vas a usar como sustituto, y las condiciones en las que se basará Twinmotion para decidir si el material puede sustituirse o no.

Las reglas de sustitución de materiales empiezan en la fila 12 y comprenden las columnas A («Row ID») y H («Instance Type»). De igual modo, puedes definir anulaciones para los parámetros predeterminados de los materiales de Twinmotion desde la sección Parameter Overrides, que empieza en la columna I e incluye las columnas siguientes.

La imagen de abajo abarca desde la fila 12 a la 22 del archivo de sustitución de materiales predeterminado. El propósito del contenido de estas filas es meramente informativo y lo que se pretende es dar algunos ejemplos sobre cómo establecer reglas de sustitución de materiales para tipo de material base de Twinmotion. Puedes sustituir esta información por tus propias reglas de sustitución.

Filas 12 a 22 del archivo de sustitución — Reglas de sustitución de materiales del archivo de sustitución.

Cada una de las filas incluye las reglas de sustitución de un material en cuestión.
Puedes definir tantas reglas de sustitución como quieras.
Las reglas de sustitución deben definirse a partir de la fila 12.
Las celdas entre las columnas C («Substitution Type») y H («Instance») definen las reglas básicas de sustitución de materiales que se aplican a todos los materiales sustituidos, y deben incluir un valor. Para obtener más información al respecto, consulta las Reglas básicas de sustitución de materiales.
Las anulaciones que se aplican a los parámetros de los materiales de Twinmotion se definen en la columna I («Parameter Overrides»). Para obtener más información, consulta el apartado Anulaciones de parámetros.
Las reglas de sustitución se aplican en orden descendente, de arriba abajo, durante el proceso de sustitución de materiales. Por ejemplo, una regla en la fila 12 se aplicará antes que otra en la fila 13 y así sucesivamente.

Reglas básicas de sustitución de materiales

La tabla de abajo enumera el contenido de la columna A a la columna H, que define las siguientes reglas de sustitución de materiales: tipo de sustitución, filtro, condición, valor, GUID de la biblioteca de Twinmotion y tipo de instancia.

Columna	Name	Descripción	Posibles valores
A	Identificador de fila	En el archivo de sustitución predeterminado, esta columna está formada por un número y el tipo de material que se sustituye. Por ejemplo, «01-Standard Stones». El contenido de las filas también puede servir para ordenarlas numérica o alfabéticamente en un programa de hojas de cálculo. La tabla debe incluir esta fila, pero no se llevará a cabo el proceso de sustitución del material. Puedes dejarla vacía o añadir etiquetas personalizadas en ella.	[cualquiera]
B	Nombre de fila	En el caso del archivo de sustitución de materiales predeterminado, esta columna sirve para nombrar los materiales de Twinmotion. Por ejemplo, «Stone Wall 2». La tabla debe incluir esta fila, pero no se llevará a cabo el proceso de sustitución del material. Puedes dejarla vacía o añadir etiquetas personalizadas en ella.	[cualquiera]
C	Substitution Type	Determina el tipo de sustitución. Este valor no se puede cambiar.	Material
D	Filtro	Indica el tipo de valor, además de la condición («Condition»), que se usará para buscar los materiales que se sustituirán. De momento, no se puede cambiar el tipo de valor, por lo que se usa el nombre del material en la columna F Value.	Name
E	Condición	Los criterios o condiciones que se aplicarán al filtro para buscar los materiales que sustituir según se indique en la columna F (Value). Por ejemplo, si la columna F (Value) contiene la palabra «Glass» y la condición es «Contains», se sustituirán todos los materiales que contengan dicho término. Se pueden usar signos de interrogación de cierre (?) y asteriscos (*) como comodines.	Contains Equals Starts With Ends With Match Not Contains Not Equals Not Starts With Not Ends With Not Match
F	Valor	El nombre del material que quieres sustituir. Los nombres distinguen entre mayúsculas y minúsculas. Por ejemplo, «Grass» no es igual que «grass».	[cualquiera]
G	TM Library GUID	El GUID, es decir, el conjunto de números propio del material de Twinmotion que se usará como sustituto. Todos los materiales de Twinmotion, ya sean locales o descargados de la nube, se identifican con un GUID exclusivo, formado por un conjunto de caracteres alfanuméricos separados por guiones. Puedes ver los GUID en el archivo de identificación de materiales exportado de Twinmotion. Para obtener más información al respecto, consulta Información sobre el archivo de identificación de materiales de Twinmotion.	[cualquiera]
H	Tipo de instancia	Si un material de Twinmotion sustituye a más de un material del proyecto importado, puedes indicar si el sustituto es una copia o una instancia.	Copiar Instancia

Anulaciones de parámetros

A la hora de seleccionar un material de Twinmotion como sustituto, tendrás la opción de usar los parámetros del material preestablecidos (como el color, la rugosidad o la escala) o anularlos. Durante el proceso de sustitución de materiales, se usan las anulaciones de parámetros que definas en la columna I, Parameter Overrides, en lugar de los parámetros de Twinmotion predeterminados.

En la siguiente imagen, vemos la sección de anulaciones de parámetros Parameter Overrides, que parte de la columna I del archivo de sustitución de materiales predeterminado. El propósito del contenido de estas filas es meramente informativo y lo que se pretende es dar algunos ejemplos sobre cómo establecer anulaciones de parámetros. Siempre puedes eliminar estas celdas o sustituirlas por tus propias reglas de sustitución.

Sección Anulaciones de parámetros — La sección Anulaciones de parámetros del archivo de sustitución de materiales.

Las anulaciones de parámetros que quieres aplicar a un material se introducen en celdas independientes de la columna I.
Puedes indicar tantas anulaciones como quieras.
Los parámetros y sus valores deben estar entre corchetes ([ ]) y usar la siguiente sintaxis: [ParameterName Value]. Por ejemplo, [TintColor 95 128 230].

IMPORTANTE: Tiene que definirse, al menos, una anulación de parámetro por cada sustitución de material. Si no quieres anular ningún parámetro, introduce uno de los valores predeterminados de un parámetro existente. Por ejemplo, si el material Clean Brick 01 tiene un color de tinte y su valor predeterminado es 231 134 113, deberías escribir «[TintColor 231 134 113]» en la columna I.

Referencias de las anulaciones de parámetros

Desde la fila 43, las celdas entre las columnas A (Color Properties) y F (Example) contienen referencias sobre las anulaciones de parámetros que puedes aplicar a los materiales de Twinmotion. Todas las filas empiezan con el signo de almohadilla (#), lo cual indica que tiene únicamente fines informativos y no afectan al proceso de sustitución de materiales.

Sección de referencia de las anulaciones de parámetros del archivo de sustitución de materiales.

Columna	Name	Descripción
A	Color Properties	Indica el nombre de la propiedad que debes usar para identificar un parámetro en la tabla de sustitución de materiales. Este nombre no tiene por qué ser el mismo del parámetro que aparece en la interfaz de usuario de Twinmotion. Por ejemplo, si quieres indicar el parámetro «Color» en el archivo de sustitución de materiales, tendrás que usar «TintColor».
B	Twinmotion UI Name	Indica el nombre del parámetro tal y como aparece en la interfaz de usuario de Twinmotion.
C	Value Type	Muestra qué formato debe tener el valor de la anulación de parámetro según el tipo de valor. Boolean: Un valor que puede alternar entre «On» y «Off» (1 = On; 0 = Off). Por ejemplo, si tenemos «[UseMask 1]», quiere decir que la máscara estará en activada en «On». Si usas valores decimales, como 1,2, o cualquier otro valor, provocarás un error. FLinearColor: Un valor que representa un color del modelo RGB. Por ejemplo, «[LuminanceFilter 95 128 230]». Float: Un número entero que representa el valor mínimo y máximo de un parámetro. Por ejemplo, «Min: 0» y «Max: 2». Opciones: Un valor seleccionado de entre una lista de opciones disponibles. Por ejemplo, el tipo de material «Glass» cuenta con las siguientes opciones: «Translucent», «ThinTranslucent» y «Basic». TFVector3D: Un tipo de valor que puede tener varios números. Deben enumerarse en el orden que se muestran y, en este caso, sí pueden ser valores decimales.
D	Intervalo mínimo	Indica el valor mínimo del rango. Por ejemplo, si tenemos «Min: 0.0», quiere decir que el valor no puede ser menor que 0,0.
E	Intervalo máximo	Indica el valor máximo del rango. Por ejemplo, si tenemos «Min: 2.0», quiere decir que el valor no puede ser menor que 2,0.
F	Ejemplo	Muestra ejemplos de la sintaxis que se puede usar para aplicar anulaciones de parámetros.

Otros contenidos del archivo de sustitución de materiales

Las siguientes filas del archivo de sustitución de materiales empiezan con el signo de almohadilla (#), lo cual indica que tiene únicamente fines informativos y no afectan al proceso de sustitución de materiales.

Filas de 1 a 9

Información general sobre el archivo de sustitución de materiales.

Filas de 23 a 39

Información sobre las columnas de la tabla de sustitución y los filtros y condiciones que se usan para identificar los materiales que se sustituirán.

Información acerca del archivo de identificación de materiales de Twinmotion.

Todos los materiales de Twinmotion se identifican con un nombre y un GUID, que es un conjunto de números único. Cuando indicas un material de Twinmotion como sustituto, tienes que usar el GUID para identificarlo en la tabla de sustitución. Si quieres ver el GUID de todos los materiales locales y descargados de Twinmotion, puedes generar un archivo de identificación de materiales en formato CSV directamente en Twinmotion.

Para generar el archivo de identificación de materiales de Twinmotion, ve a File > Export Materials IDs. Elige un nombre para el archivo y guárdalo donde quieras.

Este archivo incluye una fila para cada material presente en la escena.

La columna A indica la ubicación del material de la biblioteca de Twinmotion.
La columna B incluye el nombre del material de la biblioteca de Twinmotion.
La columna C es el GUID del material. Necesitas esta serie de números para identificar el material que usarás como sustituto en el archivo de sustitución de materiales.