Automatización del render con V-Ray App SDK: 6 pasos, de la escena al resultado

V-Ray App SDK ofrece una API para iniciar y gestionar renders con el motor V-Ray desde una aplicación o en un proceso independiente. Según la documentación oficial de Chaos, la escena puede crearse en memoria con plugins de V-Ray o cargarse desde un archivo .vrscene. Esta guía explica el ciclo básico de render con App SDK y en qué etapas de la escena resulta útil cada modo de render. Como la documentación no especifica una versión de software vigente para App SDK, la explicación se basa en el flujo de trabajo general que allí se describe.

1. Prepare el entorno

1. Determine dónde están los archivos de App SDK. La documentación indica que debe definirse la variable de entorno VRAY_SDK para poder usar el SDK. Si se utiliza el binding de Python, hay que añadir la carpeta python a las rutas de búsqueda de módulos de Python; la documentación lo ejemplifica mediante PYTHONPATH. Este paso permite que la aplicación encuentre los componentes del SDK.

2. Ejecute el script de entorno incluido o evalúe la alternativa. La documentación muestra el uso de setenv.bat en Windows y de source setenv.sh en Linux y macOS. Estos scripts configuran las variables de entorno correspondientes. Si los binarios del SDK no están en la estructura de carpetas /bin del producto, la documentación señala que puede usarse la variable VRAY_APPSDK_BIN. También ofrece una opción para establecer la ruta de búsqueda desde la API cuando no se pueden utilizar variables de entorno.

En esta etapa conviene comprobar que la estructura de carpetas del equipo coincide con la ubicación donde la aplicación busca la biblioteca del SDK. La documentación no enumera requisitos específicos de sistema operativo ni de hardware; por ello, para los detalles de instalación debe consultarse la documentación de la API del binding utilizado.

2. Cree o cargue la escena

1. Inicie el controlador de render. La clase VRayRenderer de App SDK inicia y gestiona el proceso de render. La escena puede construirse en memoria creando objetos plugin de V-Ray y configurando sus parámetros; la otra opción es cargar un archivo .vrscene, el formato de escena de V-Ray. La documentación también indica que ambos métodos pueden combinarse.

La forma de crear la escena depende del flujo de producción existente. Por ejemplo, una aplicación puede convertir sus propios datos de escena en plugins de V-Ray o abrir un archivo .vrscene exportado previamente. El objetivo de App SDK no es imponer un software de modelado concreto, sino permitir este tipo de integración con el motor de render V-Ray.

1. Elija el modo de render una vez preparada la escena. La documentación describe dos opciones principales:

Ambos modos admiten opciones de CPU y GPU. La documentación indica que CUDA y OptiX solo están disponibles para NVIDIA, y Metal y MetalRT, solo para Apple. El tipo de render se elige mediante la propiedad renderMode del objeto VRayRenderer. La documentación describe Interactive (CPU) como el modo predeterminado de la clase; por tanto, debe especificarse el modo adecuado según el objetivo de la aplicación y la compatibilidad del sistema.

3. Inicie el render y obtenga el resultado

1. Inicie el proceso de render. El método start() ejecuta el proceso de render en un hilo independiente y retorna sin esperar. Así, la aplicación puede realizar otras tareas mientras se renderiza o quedar lista para obtener una imagen de progreso. El ejemplo de Python de la documentación carga la escena, inicia el render, espera a que termine y guarda la imagen resultante como PNG:

import vray

with vray.VRayRenderer() as renderer:
    renderer.load('./intro.vrscene')
    renderer.start()
    renderer.waitForRenderEnd(6000)
    image = renderer.getImage()
    image.save('intro.png')

El valor 6000 del ejemplo de código es un argumento de muestra que se pasa a waitForRenderEnd en la documentación; no se presenta como un tiempo recomendado u obligatorio para todas las escenas. En el código de producción, el comportamiento de espera debe tratarse de acuerdo con la documentación del binding de API utilizado.

1. Evalúe la imagen mientras se renderiza y libere los recursos. App SDK indica que se pueden obtener los datos de imagen disponibles antes de que termine el render. Esto puede ser útil, sobre todo en modo Interactive, para mostrar una vista previa en la interfaz de la aplicación o supervisar el proceso. La documentación señala que la imagen final está lista cuando el renderer alcanza el estado IDLE_DONE. Al terminar el trabajo, debe cerrarse el renderer; en el ejemplo de Python, el bloque with gestiona este ciclo de vida.

La documentación también explica que se pueden escuchar eventos cuando cambia el estado del render, V-Ray genera un mensaje o se notifican datos de tareas y progreso. Estas notificaciones ayudan a una integración a coordinar el comportamiento de la aplicación durante las etapas de carga, render y finalización. Sin embargo, las funciones de callback se ejecutan en un hilo independiente; si el código del usuario es lento, puede retrasar la ejecución de otros callbacks.

¿Qué cambia en los flujos de arquitectura y archviz?

App SDK resulta útil para los equipos que quieren integrar los pasos de render repetitivos en una aplicación o gestionar una escena de V-Ray desde otro proceso. Los estudios de arquitectura y los equipos de archviz pueden usar el modo Interactive para probar escenas y contenido, y Production para generar la imagen final. Así, es posible alternar entre el flujo de previsualización y el de salida final en el mismo renderer.

No obstante, las fuentes no ofrecen una matriz de compatibilidad con programas 3D específicos, requisitos de hardware, condiciones de licencia ni información de precios. Al elegir entre CPU y GPU, solo pueden tenerse en cuenta las opciones de procesamiento indicadas en la documentación y las limitaciones de plataforma de las tecnologías de GPU correspondientes; no es posible inferir resultados de rendimiento. Antes de integrar la aplicación, deben revisarse la documentación de la API del binding utilizado y la estructura de carpetas donde se ubicarán las bibliotecas del SDK.

Errores frecuentes

• Iniciar el binding del SDK sin configurar VRAY_SDK o una ruta alternativa adecuada puede impedir que se encuentren las bibliotecas.

• No debe interpretarse la llamada a start() como señal de que el render ha terminado; la documentación la define como una llamada asíncrona que retorna sin esperar.

• Si se intenta modificar la escena o el renderer mientras el render está en estado PREPARING, la acción puede rechazarse. La documentación advierte de ello cuando se utiliza start() en lugar de startSync().

• Los callbacks lentos que se suscriben a eventos de V-Ray pueden retrasar la ejecución de otros callbacks; conviene revisar qué tareas realizan los manejadores de eventos.

• Usar el argumento de espera del código de ejemplo como un ajuste fijo para todos los proyectos va más allá de lo que indica la documentación.

Esta documentación explica los fundamentos de la carga de escenas y la gestión del render mediante App SDK, no cómo elegir ajustes de render específicos en la interfaz de usuario. Para conocer los ajustes detallados dentro de una aplicación, debe consultarse la referencia de la API del binding correspondiente.