Alineación de cámaras 3DGS en RealityScan y exportación para D5 Render

¿Qué aprenderás en este tutorial?

Esta guía explica cómo alinear cámaras a partir de fotogramas de video o fotografías en RealityScan y preparar los resultados para el flujo de trabajo de 3D Gaussian Splatting (3DGS) de D5 Render. Al terminar, tendrás una carpeta con las imágenes de origen, un archivo JSON con las poses de cámara y un archivo PLY con la nube de puntos dispersa inicial. Estos tres recursos se importarán en la ventana de creación de 3DGS de D5 Render.

El objetivo no es obtener el mismo número de cámaras ni la misma calidad de resultado en todos los proyectos de RealityScan. La cobertura de las imágenes, la calidad de la captura y los componentes generados durante la alineación pueden variar de un proyecto a otro. Por eso es importante seleccionar el componente correcto y revisar los resultados antes de exportar los archivos.

Requisitos: software, cuenta y archivos de origen

Para este proceso se utilizarán la versión de escritorio de RealityScan y la ventana de creación de 3DGS de D5 Render. La guía de D5 Render explica cómo instalar e iniciar RealityScan desde Epic Games Launcher. Es necesario iniciar sesión en Launcher con una cuenta de Epic Games; también conviene revisar el plan de precios que aparece en la interfaz durante la instalación y el Acuerdo de licencia de usuario final. Como las fuentes no especifican un precio, deben tomarse como referencia las condiciones que se muestran en la pantalla de instalación.

En la pestaña RealityScan de Launcher se selecciona la versión que se instalará. Para quienes lo usan por primera vez, la guía recomienda la versión estable más reciente seleccionada de forma predeterminada, pero no exige una versión concreta. La documentación de RealityScan 2.1 de Epic Games también explica novedades como la importación de nubes de puntos de escáneres SLAM y el uso de clasificaciones LiDAR. Sin embargo, para el flujo de D5 Render que se describe a continuación, se siguen las funciones de escritorio indicadas en la guía de origen.

Como entrada se puede usar un video o una carpeta de fotografías preparada previamente. Si se van a extraer fotogramas del video, decide de antemano dónde guardar el archivo y la carpeta de fotogramas. Cambiar después las rutas de los fotogramas puede interrumpir los pasos de carga posteriores descritos en la guía. Las fuentes no indican requisitos específicos de hardware para este proceso.

Paso a paso: alineación y exportación de archivos

1. Abre un proyecto nuevo y limpio. Inicia RealityScan, ve a la página WORKFLOW y comprueba que no haya entradas ni componentes de proyectos anteriores. Guardar el proyecto antes de empezar es una medida de seguridad recomendada en la guía.

2. Importa el video o las imágenes. Puedes arrastrar el archivo de video a la interfaz o usar los botones Images / Folder. Al seleccionar un video, se abre la ventana de extracción de fotogramas. En el ejemplo de la guía de D5 Render, se crea una carpeta de fotogramas junto al video y se establece Jumps’ length(s) en 0,5 segundos. En el ejemplo, este intervalo se utiliza para extraer un fotograma cada 0,5 segundos; el intervalo adecuado puede variar según la grabación. Si vas a usar fotografías directamente, selecciona la carpeta correspondiente.

3. Conserva la ubicación de los fotogramas y de la carpeta de origen. No cierres la aplicación mientras se procesa el video. Al terminar, comprueba que la secuencia de fotogramas aparezca en el panel Inputs. No muevas el video de origen ni la carpeta de fotogramas durante el proceso; en el siguiente paso indicarás esa carpeta a D5 Render.

4. Revisa las imágenes. Abre algunos fotogramas en la vista 2D para comprobar la nitidez, la exposición y la cobertura de la escena dentro del encuadre. La guía recomienda evitar el desenfoque por movimiento, los reflejos, las superficies extensas sin textura y los cambios bruscos de exposición. También aconseja no usar el zoom con frecuencia durante la grabación de video.

5. Alinea las imágenes con Align Images. Ejecuta el comando Align Images en la barra de herramientas superior. El proceso detecta características en las imágenes, empareja los fotogramas y calcula las poses de cámara; además, genera puntos dispersos de la escena. Ten en cuenta que el tiempo de procesamiento puede aumentar con la cantidad y la resolución de las imágenes.

6. Comprueba los componentes. Cuando termine el proceso, revisa en la vista 3D la trayectoria que forman las cámaras y los puntos dispersos. Que la mayoría de las imágenes aparezca como Registered, que la distribución de las cámaras sea continua y que los puntos dispersos representen la escena objetivo son los criterios de comprobación indicados en la guía. Si se generan varios componentes, no des por sentado que el que tiene más cámaras registradas es automáticamente el correcto: comprueba también su coherencia geométrica.

7. Selecciona el componente válido para la exportación. El JSON de cámaras y el archivo PLY deben proceder del mismo componente. Si se exportan desde componentes distintos, podrían no coincidir los sistemas de coordenadas, la cantidad de cámaras y la ubicación de la nube de puntos. En el ejemplo de la guía, Component 1 es el componente más grande, con 107/121 cámaras; estas cifras solo corresponden al proyecto de ejemplo y no son valores esperados para todas las escenas.

8. Guarda el JSON de transformación de cámara. En la sección Camera Alignment de la ventana Export, marca la opción Radiance Fields Transformation File y asigna al archivo el nombre transforms.json.

9. Exporta la nube de puntos dispersa en formato PLY. Vuelve a abrir la ventana Export y, en la sección Sparse Scene Structure, exporta la opción Sparse point cloud con el formato Polygon File Format (*.ply). La guía propone el nombre sparse_points.ply; si la herramienta siguiente requiere otro nombre, puedes utilizarlo.

10. Carga las tres entradas en D5 Render. Abre la ventana Create 3DGS from images/video, introduce un nombre de proyecto y selecciona Photos en Source Type. En Photos, elige la carpeta de fotografías de origen o la carpeta con los fotogramas extraídos. En Advanced Training Files, añade transforms.json para Camera poses y sparse_points.ply para Initial sparse point cloud. Comprueba que los tres archivos procedan del mismo componente de alineación y envía el trabajo con el botón Start reconstruction.

Errores frecuentes y su impacto en el flujo de trabajo

El error más importante es exportar el JSON y el PLY desde componentes diferentes. Antes de exportar, confirma qué componente está seleccionado y genera ambos archivos a partir de la misma selección. Otro problema es mover o cambiar el nombre de la carpeta de fotogramas del video; la carpeta que se cargará en D5 Render debe seguir siendo accesible durante todo el proyecto.

Si la alineación es deficiente, revisa primero la nitidez de las imágenes de origen, la cobertura de la escena y el solapamiento entre fotogramas consecutivos. Evita grandes saltos entre puntos de vista. Si se generan varios componentes, no decidas únicamente en función de la cantidad de cámaras: también deben ser coherentes con la escena la distribución 3D de las cámaras y los puntos dispersos.

Para los equipos de arquitectura, diseño de interiores y visualización arquitectónica, este método ofrece una forma documentada de llevar un espacio existente desde un video o unas fotografías a un flujo de trabajo 3DGS. Puede resultar útil, en particular, para quienes quieran documentar un espacio con imágenes y enviar esos datos a D5 Render para reconstruirlo. No obstante, las fuentes no ofrecen información comparativa sobre el rendimiento del hardware, el costo de la licencia ni la compatibilidad entre versiones concretas, aparte de los tiempos de procesamiento. Antes de trabajar en un proyecto real, verifica estos aspectos con la pantalla de instalación y la versión que vayas a utilizar.

Próximos pasos

Antes de enviar el trabajo, vuelve a comprobar que la carpeta, el JSON y el PLY estén guardados juntos y que los archivos correspondan al mismo componente de alineación. Para quienes quieran automatizar el flujo, la documentación de la línea de comandos de RealityScan explica cómo importar fotogramas de video a un proyecto con el comando importVideo y cómo ejecutar secuencias de comandos. Si vas a usar la línea de comandos, verifica los parámetros en la documentación del comando correspondiente; no des por hecho que sustituye al proceso de exportación y carga mediante la GUI descrito en esta guía.

Fuentes y licencia

Este tutorial se ha reescrito y adaptado a partir de la documentación de Epic Games sobre RealityScan 2.1, los comandos de proyecto e imágenes y todos los comandos, así como de la guía de D5 Render sobre alineación de cámaras con RealityScan. Aunque las fuentes indican que el contenido puede utilizarse libremente, los textos proporcionados no especifican el nombre de una licencia abierta concreta; por ello, no se menciona ninguna.