Esta página ofrece una descripción general del sistema Visual Dataprep y explica cómo empezar a crear tus propias instrucciones de importación personalizadas con las que preparar los datos en 3D para su visualización en tiempo real.
Activación de Visual Dataprep
Habilita los siguientes complementos para tu proyecto:
- Editor de Dataprep
- Importador de Datasmith
- Operaciones de geometría de Dataprep: este complemento es necesario para ciertos filtros y operaciones.
- Si quieres importar desde otros tipos de archivo de origen compatibles con Datasmith, es posible que tengas que activar otros complementos de importación para esos tipos de archivo. Para obtener más información, consulta la sección Importación de contenido de Datasmith en Unreal Engine.
Para saber cómo activar los complementos, consulta la página Uso de complementos.
Si has iniciado tu proyecto de Unreal Engine desde una plantilla de las categorías Arquitectura, ingeniería y construcción o Automoción, diseño de productos y fabricación, es posible que algunos de estos complementos ya estén activados.
Recursos de Visual Dataprep
El sistema Visual Dataprep se basa en un nuevo tipo de recurso llamado Dataprep. Este recurso es como un blueprint, en el sentido de que presenta una serie de pasos en una representación visual. Sin embargo, la finalidad de este grafo de Dataprep es transformar los datos de escena leídos de uno o más archivos de entrada que especifiques.
Para crear un nuevo recurso de Dataprep, haz clic derecho en el explorador de contenido y selecciona Dataprep > Recurso de Dataprep en el menú contextual.
Haz clic en la imagen para verla a tamaño completo.
Interfaz del editor de Dataprep
Al igual que las clases de blueprint, los recursos de Dataprep tienen su propia ventana de editor especializada. Puedes abrir esta ventana haciendo doble clic en cualquier recurso de Dataprep en el explorador de contenido.
La interfaz del editor de Dataprep se divide en varios paneles que usarás en distintos puntos del proceso de trabajo de Dataprep.
Haz clic en la imagen para verla a tamaño completo.
| Número | Nombre | Descripción |
|---|---|---|
| 1 | Barra de herramientas | Atajos para las acciones de usuario más importantes en proceso de trabajo de Dataprep, incluidas las acciones Importar, Ejecutar y Confirmar. |
| 2 | Vista previa del explorador de contenido | Muestra una lista de todos los recursos que has importado de tus archivos de entrada. Esta es una vista previa de los recursos que el sistema Visual Dataprep creará en tu explorador de contenido cuando confirmes tu grafo. |
| 3 | Vista previa del visor | Muestra una vista previa de las escenas en 3D que has importado de tus archivos de entrada. |
| 4 | Vista previa del esquematizador | Muestra una lista de todos los actores de las escenas en 3D que has importado de tus archivos de entrada. Esta es una vista previa de los actores que el sistema Visual Dataprep creará en tu nivel y de la jerarquía de escenas que se creará en el esquematizador. |
| 5 | Panel Ajustes | Usa este panel para especificar los archivos de entrada desde los que quieres importar tus escenas en 3D y dónde quieres que se creen los recursos dentro del explorador de contenido de tu proyecto. Si has expuesto parámetros en tu grafo de Dataprep para que puedan anularse en instancias de tu recurso de Dataprep, también verás esos parámetros enumerados aquí en la sección Parametrización. Para obtener más información, consulta Cómo trabajar con instancias de Dataprep. |
| 6 | Paleta | Ofrece bloques de creación que puedes arrastrar al editor de grafos de Dataprep para crear tu instrucciones de importación. |
| 7 | Editor de grafos de Dataprep | Área en la que puedes preparar instrucciones de Dataprep, que son pasos de izquierda a derecha que quieres que el sistema Dataprep siga para preparar el contenido de entrada y poder visualizarlo en tiempo real en Unreal Engine. |
| 8 | Panel Detalles | Al igual que el panel Detalles del editor de niveles principal, muestra información sobre cualquier actor que hayas seleccionado en la vista previa del esquematizador. Ten en cuenta que estos ajustes son de solo lectura. Se proporcionan solo a título informativo para que puedas evaluar los efectos de tu grafo de Dataprep en tus actores. |
Proceso de trabajo de Dataprep
El proceso de trabajo típico para ajustes un recurso de Visual Dataprep sigue estos pasos:
-
Especificación de los archivos de entrada: en el panel Ajustes situado arriba a la derecha, crea un nuevo productor de entradas para cada archivo que quieras importar o cada carpeta de archivos de entrada. Haz clic en el icono de engranaje para configurar más opciones de geometría y teselado, como Tolerancia de acordes y Técnica de cosido.
Haz clic en la imagen para verla a tamaño completo.
También puedes personalizar los siguientes ajustes de Salida:
- Carpeta determina el nombre de la carpeta que se creará en el explorador de contenido de tu proyecto para almacenar los recursos importados. Por defecto, Datasmith distribuye tus recursos en subcarpetas dentro de esta carpeta según su tipo: una para recursos de malla estática, otra para materiales, otra para texturas, etc. (Puedes anular esta distribución predeterminada cuando compiles tu grafo con Dataprep mediante la operación Salida a carpeta).
- Nombre de nivel establece el nombre de un nuevo recurso de nivel que se creará para alojar la escena. Después de confirmar los resultados del grafo de Dataprep, podrás añadir la escena importada a cualquier nivel de tu proyecto añadiendo ese subnivel.
-
Importación preliminar: pulsa el botón Importar de la barra de herramientas para importar tus archivos de origen a un mundo temporal.
Verás que el visor 3D y otros paneles de vista previa se actualizan con el contenido leído de tu archivo. Este contenido aún no se ha añadido a tu proyecto. Está en un mundo temporal que solo existe en el editor de Dataprep. Esto te da la oportunidad de modificar los recursos y la jerarquía de escenas que se leen de tus archivos de entrada antes de guardar los resultados en el proyecto.
Técnicamente, este paso es optativo, pero te permite evaluar más fácilmente los efectos del grafo de Dataprep a medida que lo creas.
-
Creación del grafo de Dataprep: arrastra los nodos Select By y Operations de la paleta al editor de grafos de Dataprep y conecta tus nodos de acción en el orden en el que quieras que se ejecuten. Consulta Grafos de Dataprep más abajo.
-
Prueba del grafo: pulsa el botón Ejecutar de la barra de herramientas para ejecutar los datos que has importado de tus archivos de origen al grafo de Dataprep creado. Verás cómo se actualizan los paneles de vista previa para mostrar los resultados.
Se pueden desactivar bloques individuales o nodos de acción para la depuración haciendo clic derecho sobre el nombre y eligiendo la opciónDesactivar. Los bloques o las acciones desactivados aparecerán atenuados en el grafo. Se pueden activar volviendo a abrir el menú y seleccionando la opciónActivar.
-
Confirmación: cuando te parezcan bien los efectos del grafo en los datos 3D importados de los archivos de entrada, pulsa el botón Confirmar de la barra de herramientas para finalizar el proceso de importación.
Cuando confirmas los resultados, el sistema Visual Dataprep guarda los recursos de la vista previa del explorador de contenido en los recursos de tu proyecto. También modifica el nivel que tienes abierto para añadir la jerarquía de actores que se muestra en la vista previa del esquematizador.
Si prefieres importar tu jerarquía de actores a un nuevo nivel, fija el nombre del nivel en el ajuste Subnivel del panel Ajustes. El sistema Visual Dataprep creará un nuevo nivel con este nombre (si aún no existe), añadirá tus actores a ese nivel y, a continuación, añadirá ese nivel como subnivel dentro del nivel que tengas abierto en la ventana principal de Unreal Editor.
Panel Estadísticas
Abre el panel Estadísticas en el menú principal del editor de recursos de Visual Dataprep: Ventana > Estadísticas. Este panel muestra una comparación sencilla de las métricas de tus datos, como las llamadas de dibujo, la cantidad de actores o el recuento total de vértices, antes y después de ejecutar el grafo de Dataprep.
Haz clic en la imagen para verla a tamaño completo.
Grafos de Dataprep
En el centro de cada recurso de Dataprep se encuentra el grafo de Dataprep: el conjunto de operaciones que el sistema llevará a cabo en los archivos de entrada que especifiques.
Haz clic en la imagen para verla a tamaño completo.
Cada grafo de Dataprep se compone de bloques de construcción llamados nodos de acción: pilas verticales de bloques. Por ejemplo, el grafo anterior contiene tres nodos de acción. Cuando ejecutas el grafo de Dataprep, comienza en el nodo Start de la izquierda y ejecuta cada nodo de acción en orden, de izquierda a derecha.
Puedes cambiar el tamaño de las acciones horizontalmente para que se lea el texto completo arrastrando sus límites.

A diferencia de los grafos de Blueprint, donde se permite la ramificación condicional, los grafos de Dataprep siempre progresan de izquierda a derecha, a lo largo de una única ruta de ejecución lineal. Además, no hay flujo de datos entre nodos de acción sucesivos. Todas las acciones usan el mismo contexto: un conjunto de recursos y actores que se importan de los archivos de entrada que proporcionas.
Cada acción es una pila de uno o más bloques. Cuando el grafo de Dataprep realiza una acción, trata cada bloque del nodo de acción de arriba abajo.
Para empezar a crear una acción, puedes arrastrar bloques desde la paleta de la izquierda al editor de grafos o hacer clic derecho en el fondo del editor de grafos y seleccionar los bloques de la paleta contextual.
Se pueden agrupar varias acciones. Para ello:
- Haz clic y arrastra para seleccionar las acciones que quieras agrupar.
- Haz clic derecho en el grupo.
- En el menú contextual, selecciona Agrupar acciones.
Puedes desactivar todas las acciones de un grupo de acciones haciendo clic derecho en el grupo y seleccionando Desactivar grupo de acciones en el menú contextual.
Para desagrupar acciones, haz clic derecho en el grupo y selecciona Desagrupar acciones.
Operaciones, filtros y transformaciones
Hay tres tipos básicos de bloques que puedes usar en un nodo de acción de Dataprep:
-
Las operaciones modifican recursos, actores o componentes de alguna forma predefinida. Por ejemplo, los bloques Establecer material, Compactar grafo de escena y Establecer colisión simple que se muestran arriba son distintos tipos de operaciones.
Para obtener más información sobre las distintas operaciones que puedes usar en los grafos de Dataprep, consulta Referencia de operaciones de Dataprep.
-
Los filtros, también llamados bloques Seleccionar por, determinan qué recursos, actores y componentes deberían modificarse en el bloque de acción actual. Por defecto, cada paso de acción realiza sus operaciones en todos los recursos, actores y componentes contenidos en el mundo temporal construido a partir de tus archivos de entrada. Puedes usar estos bloques de filtro para definir un subconjunto de esos objetos y así controlar los objetos que modificará tu nodo de acción.
Para obtener más información sobre los distintos filtros de selección que puedes usar en los grafos de Dataprep, consulta Referencia de selección de Dataprep.
-
Las transformaciones alteran la selección actual de recursos, actores y componentes de formas potencialmente complejas. En este sentido, son como filtros. Sin embargo, un bloque de filtros solo puede reducir la lista de objetos que se le han pasado. Un bloque de transformaciones, por el contrario, puede añadir objetos a la selección actual.
Por ejemplo, puede que quieras seleccionar árboles de objetos específicos de la jerarquía de la escena. Para ello, podrías usar bloques de filtros para acotar el conjunto completo de elementos de la escena a un número reducido de elementos padre específicos y, a continuación, usar un bloque de transformaciones para volver a ampliar esa selección e incluir a los elementos hijo de los elementos seleccionados.
Para obtener más información sobre las distintas transformaciones que puedes usar para ampliar o modificar el conjunto seleccionado de objetos dentro de una acción, consulta Referencia de selección y transformación de Dataprep.
Ejemplo de acción
La acción que se muestra abajo establece un nuevo material en las piezas de un ensamblaje CAD. Este nodo realiza una secuencia de pasos de arriba abajo para procesar los datos a través de su pila de filtros y operaciones.
Haz clic en la imagen para verla a tamaño completo.
| Número de paso | Nombre | Tipo de bloque | Descripción |
|---|---|---|---|
| 1 | Pin de entrada | N/A | Cada acción recopila todos los datos del mundo temporal, incluidos todos los recursos y actores que se encuentran en los archivos importados, y pasa esos objetos al bloque de la parte superior de la pila. |
| 2 | Filtrar por etiqueta | Filtro | Este filtro solo conserva los actores con la etiqueta "Metal" y pasa esa lista de actores al siguiente bloque. |
| 3 | Filtrar por etiqueta de actor | Filtro | Este filtro solo conserva los actores cuyos nombres contengan la palabra "Mecánico" y los pasa al bloque siguiente. |
| 4 | Establecer colisión simple | Operador | Este operador configura una forma de colisión de caja en todos los recursos de malla estática a los que hace referencia el conjunto de actores transmitidos por los filtros anteriores. Luego pasa la misma lista de actores al siguiente bloque. |
| 5 | Establecer material | Operador | El último operador encuentra todos los materiales de todos los componentes de malla estática propiedad del conjunto de actores transmitidos por los filtros anteriores y reemplaza esos materiales con el sustituto especificado en el ajuste Material del bloque. |
Cuando se hayan completado todos los bloques de esta acción, empezará a ejecutarse la siguiente acción del grafo. Cuando se inicia la siguiente acción, vuelve a recopilar todos los datos del mundo temporal. Ningún filtro aplicado por bloques anteriores se tendrá en cuenta ya. Sin embargo, cualquier cambio realizado en la escena por acciones anteriores se mantiene para la siguiente acción, como el cambio de materiales, la eliminación de actores, etc.
Cómo trabajar con filtros
Todos los bloques de filtros ofrecen algunas opciones adicionales que permiten capturar la lista exacta de recursos, actores y componentes que quieras modificar con tus bloques de operaciones, así como verificar que tus filtros tienen el efecto que esperas.
Para acceder a estas opciones, haz clic derecho en cualquier bloque de filtros y busca la sección Filtro en el menú contextual.
Haz clic en la imagen para verla a tamaño completo.
Si quieres afectar a varios bloques de filtros, mantén pulsada la tecla Control y haz clic izquierdo en todos los bloques para crear tu selección. Cuando todos los bloques a los que quieras afectar estén resaltados, haz clic derecho en cualquier bloque resaltado. También puedes hacer clic y arrastrar para seleccionar varios bloques.
Cómo crear un filtro a partir de los recursos seleccionados
Con uno o más actores o componentes seleccionados en el visor, el esquematizador o el panel Recursos, haz clic derecho en cualquier parte del editor de grafos de Dataprep y, en el menú contextual, selecciona Crear filtro a partir de la selección.
Haz clic en la imagen para verla a tamaño completo.
El nuevo filtro muestra el número de actores y recursos que se seleccionarán, así como los primeros actores o recursos de la lista.
No puedes editar esta lista directamente, pero puedes crear un nuevo filtro que la incluya:
- Haz clic derecho en el filtro Filtrar por selección en las instrucciones de Dataprep.
- En el menú contextual, selecciona Previsualizar filtro(s). Esto resaltará los actores y recursos en el panel de vista previa del esquematizador del mundo que seleccione este filtro.
- Para añadir nuevos actores y recursos al filtro, mantén pulsada la tecla Ctrl y haz clic sobre ellos en el panel de vista previa del esquematizador del mundo.
- Haz clic derecho en cualquier parte del editor de grafos de Dataprep y, en el menú contextual, selecciona Crear filtro a partir de la selección.
Inversión de la lógica del filtro
Selecciona *Filtro > Invertir la selección del filtro para invertir la lógica de selección de cualquier bloque Seleccionar por y convertirlo en un bloque Excluir por. Al hacerlo, las operaciones de la misma acción solo se aplicarán al conjunto de elementos de la escena que no coincidan con los criterios establecidos.
Vista previa de los resultados del filtro
Selecciona Filtro > Previsualizar filtro(s) para que los paneles de vista previa del explorador de contenido y vista previa del esquematizador del mundo muestren una marca de verificación junto a todos los recursos y actores seleccionados por el filtro.
Haz clic en la imagen para verla a tamaño completo.
Solo puedes previsualizar un filtro o un conjunto de filtros seleccionado a la vez. Si empiezas a previsualizar un filtro o un conjunto de filtros distinto, los filtros anteriores dejarán de previsualizarse.