Pasos de render graph en Unity URP: declara las dependencias antes de dibujar

Empieza por el contrato de recursos

Un efecto de pantalla personalizado es más que la invocación de un shader. Lee datos concretos, produce un resultado y depende del momento en que esos datos están disponibles. Escribe ese contrato antes de trasladar código de renderizado entre versiones de Unity. Este artículo sigue la documentación de URP de Unity 6.0; es un enfoque de migración, no una afirmación de que una misma firma de API sirva para todas las versiones de URP.

Registro y ejecución por separado

RecordRenderGraph registra los pasos y sus dependencias. La función de renderizado que se proporciona mediante SetRenderFunc registra los comandos de dibujo cuando se ejecuta el paso. Conserva en la estructura de datos del paso los datos que necesita esa ejecución. [1] Evita que la corrección de un efecto dependa de campos mutables ajenos que casualmente conserven valores de una cámara anterior.

Declara el acceso real a las texturas

En un paso raster, UseTexture declara una entrada muestreada y SetRenderAttachment declara un destino de renderizado. El camino documentado prohíbe usar ambos sobre la misma textura en un mismo paso raster; si hace falta, usa texturas y pasos distintos. [2] Considera los nombres de los recursos una ayuda de auditoría: quien revise el código debería poder rastrear cada entrada hasta su productor y cada salida hasta su consumidor.

Ejemplo: un tinte para una cámara de seguridad

Imagina una cámara de seguridad que muestra un tinte verde de advertencia mientras hay una alarma activa. Su primer paso personalizado lee el color de la cámara elegida y escribe una textura teñida aparte. Un paso posterior consume esa textura para producir la salida de cámara prevista. Describe qué tipos de cámara son aptos, si el efecto se ejecuta antes o después del resto del posprocesado y qué ocurre cuando la alarma está inactiva. Para la migración, empieza con un tinte constante simple, verifica la cadena de dependencias y solo entonces restituye el patrón animado de la alarma. Compara una escena con una sola cámara con otra que tenga tanto una cámara de juego como una de vista previa. El ejemplo define una secuencia de diseño e inspección, no código listo para producción.

Límites de la migración y comprobaciones

El modo de compatibilidad (Compatibility Mode) desactiva el render graph, y la documentación de Unity a la que se hace referencia indica que el esfuerzo de desarrollo se dirige a la ruta del graph. [3] Anota las versiones del Editor y del paquete URP, y sigue los ejemplos que les corresponden. Comprueba las dimensiones, el formato, el número de muestras de las texturas y la elegibilidad de las cámaras antes de copiar código de asignación antiguo. Inspecciona el graph para confirmar que las salidas se consumen y que los pasos esperados sobreviven al culling. Prueba el cambio de tamaño, los efectos desactivados y la API gráfica de destino. Que el código compile no demuestra que el resultado visual sea correcto ni que el rendimiento mejore; compara capturas y tiempos con el efecto original.

Fuentes

1. Write a render pass using the render graph system — Unity Technologies.
2. Use a texture in a render pass — Unity Technologies.
3. Compatibility Mode in URP — Unity Technologies.