Guía de línea de comandos de RealityScan: de fotos a modelos 3D

Qué aprenderás en esta guía

La interfaz de línea de comandos de RealityScan permite encadenar algunas operaciones de la aplicación mediante comandos y ejecutar tareas repetitivas con un archivo por lotes. En esta guía añadirás al proyecto fotos de un espacio arquitectónico, las alinearás, guardarás el proyecto, ejecutarás los pasos de procesamiento configurados en la aplicación y simplificarás y exportarás un modelo. Los comandos usan nombres de carpetas de ejemplo; tendrás que adaptarlos a las carpetas de trabajo reales.

Este método no garantiza la automatización de todas las operaciones. Por ejemplo, el comando -start ejecuta los procesos configurados previamente para el botón Start de RealityScan. Por tanto, es importante tener en cuenta tanto los ajustes de la aplicación como los pasos de la línea de comandos.

Requisitos

La documentación oficial presenta los ejemplos de línea de comandos mediante RealityScan.exe. Los pasos siguientes están pensados para el Símbolo del sistema de Windows y archivos .bat. La documentación no especifica una versión concreta, un nivel de hardware, un tipo de cuenta ni información sobre precios; por eso, antes de empezar un proyecto, conviene comprobar por separado la instalación y las condiciones de licencia que se usarán.

El ejemplo usa las rutas C:\RS\Images y C:\RS\Interior.rsproj para la carpeta de fotos y el archivo del proyecto. Crea esas carpetas en tu equipo y coloca las imágenes en la ubicación adecuada. Si usas rutas de archivos con espacios en los comandos, comprueba cómo se analizan los parámetros en tu instalación; los ejemplos prefieren rutas sin espacios.

Añadir la carpeta de RealityScan a la variable PATH del sistema reduce la necesidad de escribir una y otra vez la ruta completa de la aplicación en los comandos. La documentación oficial indica que la línea PATH siguiente solo es válida durante la sesión de línea de comandos abierta.

Pasos de la aplicación

1. Alinea las fotos en modo borrador

Primero, añade las imágenes y ejecuta una alineación rápida en modo borrador. En este ejemplo, se añade la carpeta de la aplicación a PATH, se importan las fotos desde una carpeta y se guarda el proyecto:

set PATH=%PATH%;C:\Program Files\Epic Games\RealityScan\
RealityScan.exe -addFolder C:\RS\Images -save C:\RS\Interior.rsproj -draft -quit

-draft ejecuta la alineación en modo borrador. Esta comprobación inicial sirve para ver si el conjunto de fotos se ha registrado correctamente; es más seguro abrir el proyecto en la aplicación y revisar el resultado antes de pasar a la alineación completa.

2. Incluye las subcarpetas si es necesario

Si las imágenes están distribuidas en subdirectorios de la carpeta principal, activa el ajuste que permite buscarlas antes de añadirlas:

RealityScan.exe -set "appIncSubdirs=true" -addFolder C:\RS\Images -save C:\RS\Interior.rsproj -draft -quit

Este ajuste hace que el comando -addFolder también incluya las subcarpetas. Si las imágenes ya están en una sola carpeta, no hace falta añadirlo. En lugar de ejecutar ambos ejemplos consecutivamente sobre el mismo proyecto, elige un único flujo que se ajuste a la estructura de las fotos.

3. Ejecuta la alineación completa

Tras revisar el resultado del modo borrador, vuelve a cargar el proyecto guardado y ejecuta la alineación completa:

RealityScan.exe -load C:\RS\Interior.rsproj -align -save C:\RS\Interior.rsproj -quit

Los comandos se ejecutan en orden: se abre el proyecto, se realiza la alineación y se guarda el resultado en el mismo archivo del proyecto. Los parámetros de línea de comandos funcionan de forma similar a las operaciones de la aplicación; esta puede abrirse con normalidad y permitir la interacción del usuario durante el proceso. La documentación también incluye la opción -headless para ocultar la interfaz, aunque en las primeras pruebas puede resultar más claro revisar el resultado de forma visible.

4. Ejecuta el flujo de procesamiento configurado en la aplicación

Tras la alineación, configura en el botón Start de RealityScan las operaciones necesarias para generar el modelo. Según la documentación oficial, -start ejecuta los procesos definidos para ese botón; no des por hecho qué pasos de modelado se llevarán a cabo añadiendo únicamente el comando.

RealityScan.exe -load C:\RS\Interior.rsproj -start -save C:\RS\Interior.rsproj -quit

Comprueba en la aplicación las opciones usadas durante el proceso según el proyecto y su objetivo. La línea de comandos facilita la repetición de este flujo preconfigurado, pero no garantiza por sí sola que los ajustes sean adecuados.

5. Simplifica y exporta el modelo

Si conoces el nombre del modelo dentro del proyecto, puedes seleccionarlo con -selectModel, definir el número objetivo de triángulos con -simplify y exportarlo con -exportSelectedModel. En el ejemplo siguiente se usan el nombre Model1 y un objetivo de 1.000.000 de triángulos; este valor no es una recomendación de calidad, sino una muestra del uso del comando.

RealityScan.exe -load C:\RS\Interior.rsproj -selectModel Model1 -simplify 1000000 -exportSelectedModel C:\RS\Interior.obj -save C:\RS\Interior.rsproj -quit

Sustituye el nombre del modelo por el nombre real del proyecto. Si necesitas gestionar con más detalle los ajustes de simplificación y exportación, puedes pasar a los comandos, como parámetro opcional, el archivo params.xml exportado desde las herramientas correspondientes de la aplicación. Los ajustes disponibles dependen de cómo se haya preparado el archivo en la aplicación.

Errores frecuentes

• Si ejecutas RealityScan.exe sin hacerlo desde la carpeta donde está instalada la aplicación, es posible que no se encuentre el ejecutable. Usa la ruta completa de la aplicación o añade la línea PATH a la sesión de comandos activa.

• No des por hecho que las imágenes de las subcarpetas se añaden automáticamente. Si necesitas ese comportamiento, usa el ajuste appIncSubdirs.

• No consideres la alineación de borrador como un resultado definitivo. -draft y -align son comandos de alineación distintos; revisa el proyecto después de la fase de borrador.

• No supongas qué operaciones iniciará el comando -start. Configura previamente en la aplicación los ajustes del botón Start.

• Seleccionar el modelo con un nombre incorrecto o escribir mal la ruta del proyecto puede impedir que el flujo de comandos funcione con el archivo esperado. Comprueba que los nombres del proyecto y del modelo coincidan con los de la aplicación.

Impacto en flujos de arquitectura, interiores y archviz

Los equipos que procesan modelos creados a partir de fotos de espacios o edificios pueden aprovechar la línea de comandos en proyectos donde se repiten los mismos pasos de importación y alineación. Como la documentación también incluye herramientas de simplificación y exportación, es posible establecer un flujo para preparar en distintas fases los modelos obtenidos a partir de fotos. No es un método que sustituya las decisiones arquitectónicas, sino una herramienta para organizar datos basados en fotografías dentro de un proyecto y repetir determinadas operaciones.

En proyectos en los que trabajan varias personas de una oficina, es importante mantener la coherencia en la estructura de carpetas, los nombres de los proyectos y los ajustes de procesamiento de la aplicación. La documentación de RealityScan no ofrece información sobre compatibilidad con un software de archviz concreto, requisitos de hardware ni costes de licencia. Por tanto, conviene probar por separado con datos de un proyecto real cómo se utilizará el archivo exportado en la aplicación de destino, cómo afecta el hardware a los tiempos de procesamiento y cuáles son las condiciones de licencia.

Próximos pasos

Cuando el flujo básico funcione, puedes explorar otros comandos de proyecto de la línea de comandos, como añadir imágenes mediante una lista, cargar proyectos y guardarlos. Para la alineación, hay opciones para exportar y volver a utilizar metadatos de cámara XMP. Entre las herramientas de modelos documentadas también se incluyen la limpieza, el cierre de agujeros, el cálculo de texturas y otras operaciones de exportación. Probar cada comando nuevo primero en una copia de un proyecto pequeño ayuda a reducir el riesgo de sobrescribir el trabajo existente.

Fuentes y licencia

Esta guía se basa en las secciones de comandos de proyecto e imágenes, comandos de alineación y herramientas de modelos de la documentación de línea de comandos que Epic Games publicó para RealityScan. Las fuentes aparecen marcadas como de licencia libre; el contenido se ha adaptado al turco y los ejemplos se han ajustado para esta guía.