Passes do render graph no Unity URP: declare as dependências antes de desenhar

Comece pelo contrato de recursos

Um efeito de tela personalizado é mais do que a chamada de um shader. Ele lê dados específicos, produz um resultado e depende do momento em que esses dados ficam disponíveis. Escreva esse contrato antes de mover código de renderização entre versões do Unity. Este artigo segue a documentação do URP no Unity 6.0; trata-se de uma abordagem de migração, não da afirmação de que uma única assinatura de API serve para todas as versões do URP.

Registre e execute separadamente

RecordRenderGraph registra os passes e suas dependências. A função de renderização passada por SetRenderFunc grava os comandos de desenho quando o pass é executado. Mantenha na estrutura de dados do pass os dados necessários para essa execução. [1] Evite que a correção de um efeito dependa de campos mutáveis alheios a ele que, por acaso, guardem valores de uma câmera anterior.

Declare o acesso real às texturas

Em um raster pass, UseTexture declara uma entrada amostrada e SetRenderAttachment declara um render target. O caminho documentado proíbe usar ambos na mesma textura dentro de um único raster pass; quando necessário, use texturas e passes separados. [2] Use os nomes dos recursos como apoio de auditoria: quem revisa deve conseguir rastrear cada entrada até o seu produtor e cada saída até o seu consumidor.

Exemplo: um tom de câmera de segurança

Imagine uma câmera de segurança que exibe um tom verde de alerta enquanto um alarme está ativo. O primeiro pass personalizado lê a cor da câmera escolhida e grava em uma textura separada, já com o tom aplicado. Um pass seguinte consome essa textura para produzir a saída pretendida da câmera. Descreva quais tipos de câmera são elegíveis, se o efeito roda antes ou depois de outros pós-processamentos e o que acontece quando o alarme está inativo. Na migração, comece com um tom constante simples, verifique a cadeia de dependências e só então restaure o padrão animado do alarme. Compare uma cena com uma câmera com outra que tenha uma câmera de jogo e uma câmera de preview. O exemplo define um desenho e uma sequência de inspeção, não código pronto para produção.

Limites e verificações da migração

O Compatibility Mode desativa o render graph, e a documentação do Unity citada afirma que o esforço de desenvolvimento é direcionado ao caminho do graph. [3] Registre as versões do Editor e do pacote URP e siga os exemplos correspondentes. Verifique dimensões, formato, contagem de amostras da textura e elegibilidade da câmera antes de copiar o código antigo de alocação. Inspecione o graph para confirmar que as saídas são consumidas e que os passes esperados não são removidos pelo culling. Teste redimensionamento, efeitos desativados e a API gráfica de destino. Uma compilação bem-sucedida não comprova correção visual nem ganho de desempenho; compare capturas e medições de tempo com o efeito original.

Fontes

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.