Error: Legacy Render Layers en Maya

¿Qué son las Legacy Render Layers y por qué ocurre este error?

Maya tiene dos sistemas de capas de render distintos, y no se combinan bien. El sistema legacy (heredado) —disponible en Maya 2016 y versiones anteriores— está ahora en desuso a favor de Render Setup, introducido en Maya 2017. Cuando abre un archivo de escena que contiene Legacy Render Layers (o un archivo referenciado que las contiene), Maya muestra este error: "Error: You are attempting to load a file that contains legacy render layers into a scene."

Este error aparece porque los dos sistemas tienen arquitecturas fundamentalmente diferentes. Las Legacy Render Layers almacenan la información de las capas directamente dentro del archivo de escena, a menudo mediante las antiguas utilidades del Render Layer Editor. Render Setup, en cambio, es un sistema basado en nodos que vive en la jerarquía de la configuración de render y utiliza un enfoque más modular. Cuando Maya intenta cargar una capa legacy en un entorno moderno de Render Setup, no puede reconciliar automáticamente las diferencias.

Nos hemos encontrado con este problema innumerables veces cuando los clientes migran proyectos antiguos a versiones más recientes de Maya. El problema se intensifica cuando se utilizan archivos referenciados: si un archivo referenciado se creó en Maya 2016 o anterior con las Legacy Render Layers activadas, esas capas se incorporan a su escena principal quiera usted o no.

Los dos sistemas de render: cómo se diferencian

Legacy Render Layers (Maya 2016 y anteriores):

• Almacenaban la información de las capas directamente en el archivo de escena
• Utilizaban la antigua interfaz del Render Layer Editor
• Cada capa contenía la separación de pasadas de render (difusa, reflexión, sombra, etc.)
• Sencillo pero limitado: no escalaba bien en flujos de trabajo complejos de múltiples pasadas
• En desuso desde Maya 2017 en adelante

Render Setup (Maya 2017 y posteriores):

• Arquitectura basada en nodos, almacenada en Render Settings
• Más potente y flexible para flujos de trabajo de composición complejos
• Separa las definiciones de las capas de render del contenido de la escena
• Totalmente compatible en todas las versiones de Maya desde 2017 en adelante
• Estándar en los pipelines de producción profesionales

La diferencia clave: las capas legacy están "incrustadas" en su escena; Render Setup es "externo" a ella. Esta separación hace que Render Setup sea más seguro para la colaboración y el control de versiones: su configuración de render puede cambiar sin alterar la geometría 3D ni la animación subyacentes.

Por qué este error importa en producción

Los errores de Legacy Render Layers son más que un simple inconveniente. Pueden causar varios problemas graves:

Fallos silenciosos en el renderizado por lotes: si envía trabajos a una granja de render en la nube como el servicio de renderizado en la nube para Maya de Super Renders Farm, los conflictos de capas legacy pueden hacer que los renders fallen de forma silenciosa o produzcan una salida incorrecta. El gestor de renders puede procesar el trabajo correctamente, pero generar las pasadas de render equivocadas u omitir capas enteras sin mensajes de error claros.

Resultados incoherentes entre versiones de software: si su equipo utiliza versiones mixtas de Maya (2016, 2018, 2022, etc.), las escenas con capas legacy se comportarán de forma distinta según la máquina. Es posible que la estación de trabajo de un artista funcione bien mientras que la de otro falle por completo.

Incompatibilidad con herramientas modernas: los scripts, plugins y herramientas de automatización de terceros rara vez tienen ya en cuenta las Legacy Render Layers. Herramientas como Deadline, qube y los scripts de gestión de render personalizados esperan Render Setup.

Solución inmediata: activar "DAG Objects Only" en el Outliner

La solución rápida es ocultar los nodos de capas de render de la vista:

1. Abra la ventana Outliner (Windows > Outliner)
2. Vaya a Display > DAG Objects Only
3. Desmarque "DAG Objects Only"

Esto revela los nodos de capas de render ocultos sin solucionar realmente el problema de fondo: verá aparecer la estructura de las capas legacy en su Outliner. El error desaparece temporalmente, pero las capas legacy siguen ahí.

Esta es solo una solución temporal. Es útil para abrir una escena rápidamente, pero no resuelve el problema de raíz. Para producción y renderizado en la nube, necesita una solución permanente.

Solución 1: convertir las Legacy Render Layers a Render Setup

Esta es la solución preferida a largo plazo. Convertir las capas legacy a Render Setup es sencillo:

1. Abra la escena en Maya 2017 o posterior
2. Vaya a Render > Render Setup (Window > Render Editors > Render Setup)
3. En la ventana de Render Setup debería ver un mensaje sobre las capas legacy o un botón de conversión
4. Siga el asistente de conversión para migrar sus capas legacy existentes al nuevo sistema
5. Una vez completada la conversión, guarde la escena

La herramienta de conversión de Maya gestiona automáticamente la mayor parte del trabajo. Sin embargo, las configuraciones complejas de múltiples pasadas con atributos de render específicos pueden requerir ajustes manuales tras la conversión. Pruebe su configuración convertida con un render pequeño antes de subirla a una granja de render en la nube.

Solución 2: eliminar por completo las Legacy Render Layers

Si su escena tiene varias capas de render pero solo necesita un único render maestro, puede simplemente eliminar el sistema de capas legacy:

1. Seleccione todos los nodos de Legacy Render Layers en el Outliner
2. Elimínelos (Edit > Delete)
3. Guarde el archivo
4. Vuelva a abrir el archivo para confirmar que la estructura está limpia

Tras la eliminación, Maya generará una nueva configuración de Render Setup predeterminada la próxima vez que se abra. Este enfoque funciona cuando no necesita un renderizado complejo de múltiples pasadas.

Solución 3: limpieza mediante script MEL

Para una limpieza por lotes en varios archivos, use este script MEL en el Script Editor:

// Remove all legacy render layers
string $layers[] = `ls -type renderLayer`;
for ($layer in $layers) {
    if ($layer != "defaultRenderLayer") {
        delete $layer;
    }
}

Ejecute este script en cada archivo que necesite limpieza. También puede integrarlo en un flujo de procesamiento por lotes para limpiar docenas de archivos a la vez.

Solución 4: script Python para migración automatizada

Si gestiona muchas escenas legacy, use este script Python para una migración más sofisticada:

import maya.cmds as cmds

# Get all render layers except default
layers = cmds.ls(type='renderLayer')
layers = [l for l in layers if l != 'defaultRenderLayer']

# Delete legacy layers
for layer in layers:
    try:
        cmds.delete(layer)
        print(f"Deleted: {layer}")
    except Exception as e:
        print(f"Error deleting {layer}: {e}")

# Save file
cmds.file(save=True)
print("Scene cleaned and saved.")

Este script elimina todas las capas legacy y guarda el archivo automáticamente. Puede ejecutarlo en el modo por lotes de Maya o integrarlo en una herramienta de pipeline.

Render Settings y la opción "Preferred Render Setup Mode"

En las versiones actuales de Maya, la ventana Render Settings (Render > Render Settings o Render > Render Setup) contiene una opción fundamental: Preferred Render Setup Mode. Este menú desplegable controla cómo gestiona Maya la información de las capas:

• Render Setup (predeterminado): utiliza exclusivamente el nuevo sistema basado en nodos
• Legacy: permite las capas de render al estilo antiguo (no recomendado para proyectos nuevos)

Si está actualizando un proyecto legacy, asegúrese de que esta opción esté configurada en "Render Setup". Si sigue configurada en "Legacy", cámbiela y vuelva a guardar el archivo. Esto garantiza que el trabajo nuevo realizado en la escena utilice el sistema moderno.

Pruebe su solución antes del renderizado en la nube

Después de convertir o limpiar sus Legacy Render Layers, pruebe localmente antes de subir el archivo a una granja de render:

1. Renderice unos pocos fotogramas para verificar que todas las pasadas se renderizan correctamente
2. Revise la ventana Render Setup para asegurarse de que sus capas aparecen como se espera
3. Verifique las rutas de texturas y referencias (a veces se rompen durante la conversión)
4. Pruebe el renderizado por lotes si su granja utiliza envíos por lotes
5. Guarde y verifique que el archivo se abre correctamente sin errores en otra máquina, si es posible

Al subir archivos a Super Renders Farm o a cualquier servicio gestionado en la nube, los archivos limpios se renderizan más rápido y producen resultados predecibles. Los errores de capas legacy añaden un tiempo de depuración que no le conviene pagar.

Problemas relacionados y solución de incidencias

Archivos referenciados con Legacy Render Layers

Si importa un archivo referenciado que contiene capas legacy, verá el error incluso si su escena maestra está limpia. Soluciones:

• Pida al miembro del equipo responsable de ese archivo referenciado que lo limpie y lo vuelva a guardar
• Utilice File > Reference Editor para aislar la referencia problemática
• Descargue temporalmente la referencia, guarde la escena maestra y vuelva a cargarla

No encuentro la opción de conversión en Render Setup

Las versiones antiguas de Maya 2017 no incluían la herramienta de conversión. Actualice a Maya 2017 Update 3 o posterior (o a 2018+) para acceder al asistente de conversión.

La ventana Render Setup no muestra capas

Esto es en realidad una buena señal: significa que su escena está limpia. La ventana Render Setup estará prácticamente vacía en escenas nuevas. Esto es lo esperado.

Los trabajos de render por lotes fallan en la granja pero funcionan localmente

Este es un problema clásico de capas legacy. Las granjas de render en la nube suelen aplicar una validación más estricta que su máquina local. Vuelva a enviar el trabajo después de limpiar la escena.

FAQ

Q: ¿Convertir las Legacy Render Layers a Render Setup cambiará mi salida de render? A: La conversión está diseñada para no ser destructiva, pero las configuraciones complejas de múltiples pasadas pueden necesitar ajustes menores. Renderice siempre un fotograma de prueba localmente para verificarlo. Recomendamos hacerlo antes de enviar trabajos por lotes grandes a una granja.

Q: ¿Puedo tener a la vez Legacy y Render Setup en el mismo archivo? A: Técnicamente sí, pero no está soportado y provocará un comportamiento impredecible. Utilice un solo sistema por archivo. Convierta o limpie, no los mezcle.

Q: ¿Desaparece el error después de desmarcar "DAG Objects Only"? A: Sí, temporalmente. Pero las capas legacy siguen en el archivo. El error volverá a aparecer cuando abra el archivo en otra máquina o lo envíe a una granja de render. Desmarcar la opción es una solución rápida para trabajar de inmediato, no una corrección definitiva.

Q: Mi equipo usa Maya 2016. ¿Tenemos que actualizar? A: No de inmediato, pero las capas legacy se volverán cada vez más problemáticas. Maya 2016 tiene ya 10 años. Recomendamos planificar una actualización gradual a Maya 2022 o 2024 cuando el presupuesto lo permita. Mientras tanto, evite crear escenas nuevas con Legacy Render Layers: no migran bien hacia adelante.

Q: ¿Puedo enviar una escena con Legacy Render Layers a una granja de render en la nube? A: Depende de la granja. Algunas granjas (incluida Super Renders Farm) pueden procesar escenas legacy, pero lo hacen más lento y son más propensas a errores silenciosos. Limpie sus escenas primero para obtener resultados fiables y predecibles. Consulte nuestra guía sobre cómo resolver los bloqueos habituales de Maya al abrir archivos de escena para otros problemas de estabilidad que suelen acompañar a las escenas antiguas.

Q: ¿Funciona Render Setup con los motores de render V-Ray y Corona? A: Sí. Render Setup es independiente del motor de render. V-Ray, Corona, Arnold y Redshift funcionan todos con Render Setup en Maya 2017 y posteriores. Las Legacy Render Layers también funcionan con estos motores, pero, de nuevo, migre a Render Setup para obtener estabilidad y compatibilidad.

Referencias

• Documentación de Render Setup de Maya — la guía oficial de Autodesk sobre el sistema moderno de Render Setup

Resumen

Las Legacy Render Layers son una reliquia de versiones antiguas de Maya. Si ve el mensaje de error "Error: You are attempting to load a file that contains legacy render layers", dispone de varias opciones sencillas: convertir a Render Setup, eliminar las capas por completo o usar scripts para una limpieza por lotes. Para trabajo de producción y renderizado en la nube, recomendamos convertir al sistema moderno de Render Setup. Es más robusto, escala mejor en flujos de trabajo complejos de múltiples pasadas y evita fallos silenciosos durante el renderizado por lotes.

Pruebe sus escenas convertidas o limpiadas localmente antes de subirlas a una granja de render. Unos minutos de validación ahorran horas de depuración en trabajos fallidos.

Última actualización: 17 de marzo de 2026