Inserindo funções e expressões de material no Unreal Engine | Unreal Engine 5.7 Documentação

Expressões de Material e Funções de Material são os blocos de construção usados para criar materiais totalmente funcionais no Unreal Engine. Cada expressão ou função é um nó independente no gráfico de material. Esses nós executam pequenos trechos de código HLSL em suas entradas e geram os resultados.

Esta página demonstra as várias maneiras de inserir expressões e funções de material no seu gráfico de material.

Expressões de Material

Cada nó de Expressão de Material contém um pequeno conjunto de instruções HLSL para realizar uma tarefa muito específica no material. Materiais são construídos combinando expressões e funções para alcançar um resultado visual desejado.

Por exemplo, se você quiser alterar a escala de uma textura na sua malha, pode usar um nó Multiplicar. Ao multiplicar um valor de Constante pelas Coordenadas de Textura de um material, você pode manipular a escala da textura.

Quando o valor de multiplicação é alterado de 1 para 3, a textura é ladrilhada três vezes na superfície, em vez de uma única vez.

Esta é uma parte simples, mas versátil, da Lógica de materiais. Quando pequenas redes de nós como essa são combinadas, você pode criar efeitos de superfície muito sofisticados.

Diferenças entre expressões e funções

A principal diferença entre expressões e funções de material é que as expressões de material são criadas diretamente no código-fonte do engine, enquanto funções de material existem como recursos editáveis no Navegador de conteúdo.

Expressões de material

Expressões de material são partes estáticas de código que só podem fazer o que foram programadas para fazer. Um nó Multiplicar é programado para multiplicar dois valores juntos. A única maneira de alterar sua utilidade é alterá-la no código-fonte. O exemplo anterior apresentou quatro expressões de material:

Constante: contém um único valor numérico (float).
Multiplicar: multiplica a entrada A e a entrada B e gera o produto.
Coordenadas de Textura: gera as coordenadas de textura UV do material na forma de um valor vetorial de dois canais.
Amostra de Textura: faz referência a uma textura de imagem e gera os valores de cor da textura.

Funções de material

Funções de material são mais dinâmicas, pois você pode configurá-las para realizar qualquer tipo de cálculo que desejar. Você pode criar e editar funções de material sem precisar fazer alterações no código-fonte.

Se você clicar duas vezes em um nó de função de material, o Editor de Funções de Material será aberto. Dentro de uma função de material, você encontrará um gráfico de nó independente composto de expressões de material.

Uma função de material CameraDepthFade contém o gráfico de material mostrado à direita.

Funções de material são uma maneira de condensar a lógica complicada de materiais em um nó único e fácil de ler que pode ser usado em vários materiais. Funções são uma excelente maneira de compactar gráficos de materiais repetitivos para que eles possam ser compartilhados e reutilizados por outros membros da equipe.

Inserindo expressões de material

Existem quatro maneiras de inserir expressões de material no gráfico de material.

Arrastar e soltar da paleta

A paleta é um painel de barra lateral recolhível no lado direito da janela do Editor de Material. Clique na Paleta para expandir o painel, caso não esteja visível.

Para manter a paleta sempre visível, clique no ícone de alfinete.

Clique no alfinete novamente para desafixar a paleta. Quando desafixada, a Paleta é recolhida após cada ação.

Procurando na Paleta

A paleta contém uma lista de todas as expressões de materiais e funções de materiais disponíveis no UE5. Estes são classificados em categorias de acordo com sua finalidade geral.

Você pode pesquisar a paleta digitando uma consulta na barra de pesquisa. O filtro de pesquisa é atualizado progressivamente à medida que você digita e destaca automaticamente a correspondência mais próxima.

O menu Categoria permite filtrar quais tipos de nós são visíveis na paleta.

Selecione Expressões para mostrar apenas expressões de material na paleta.
Selecione Funções para mostrar apenas funções de material e ocultar expressões.
Todas as expressões e funções de materiais são visíveis por padrão.

Inserindo expressões e funções da paleta

Você pode arrastar qualquer expressão ou função de material da paleta diretamente para o gráfico de material.

Clique com o botão esquerdo no nome de uma expressão de material na paleta e arraste-a até o gráfico de material com o botão esquerdo do mouse pressionado.
Solte o botão esquerdo do mouse. A expressão de material é inserida na posição do ponteiro.

Menu de contexto com o botão direito

Você também pode adicionar nós de material ao seu gráfico a partir do menu acionado com o botão direito. Como a paleta, o menu do botão direito contém uma lista categorizada de todas as expressões e funções de material. O menu acionado com o botão direito tem uma barra de pesquisa, mas não tem como filtrar expressões ou funções.

Clique com o botão direito em qualquer lugar no plano de fundo do gráfico de materiais.
Navegue pelas categorias ou digite uma consulta na barra de pesquisa para encontrar uma expressão ou função.
Clique com o botão esquerdo no nome de uma expressão ou função de material para colocá-la em seu gráfico.

Você também pode pressionar a tecla Enter para inserir qualquer expressão de material atualmente destacada em azul. Use as setas para cima e para baixo para selecionar na lista ou refinar seus termos de pesquisa.

Arraste de um pino de entrada ou saída

Uma segunda maneira de acessar o menu de contexto é clicar com o botão esquerdo e arrastar um fio de qualquer pin de entrada ou saída em um nó existente em seu gráfico. Solte o botão esquerdo do mouse em qualquer lugar do gráfico para exibir o menu de contexto. Use a barra de pesquisa ou navegue pelas categorias para localizar e gerar um nó. Uma vantagem desse método é que a expressão ou função do material já está conectada corretamente ao ser gerada, economizando uma etapa.

Atalhos do teclado

Há uma série de atalhos de teclado que você pode usar para inserir rapidamente expressões de materiais comumente usadas. Para inserir uma expressão de material mantenha pressionado um atalho de teclado e clique com o botão esquerdo em qualquer lugar do gráfico de material.

Essa tabela mostra os atalhos de teclado padrão da expressão de material.

Tecla de Atalho de Teclado	Expressão de Material
A	Adicionar Expressão de Material
B	Expressão de Material de Deslocamento de Saliência
1	Expressão de Material Constante
2	Expressão de Material Constant2Vetorial
3	Expressão de Material Constant3Vetorial
4	Expressão de Material Constant4Vetorial
D	Dividir Expressão de Material
I	Se Expressão Material
L	Expressão de Material de Interpolação Linear
F	Função de Material Expressão de Material
M	Multiplicar Expressão
N	Normalizar Expressão
O	Expressão Um Menos
P	Expressão de Panner
E	Expressão de potência
R	Expressão de Material WS de Vetor de Reflexão
S	Expressão de Material Escalar
S	Expressão de amostra de textura
U	Expressão de coordenadas de textura
V	Expressão de Parâmetro Vetorial

Você pode alterar os atalhos de teclado de Expressão de Material acessando Editar > Preferências do Editor > Atalhos do Teclado > Nós de Geração do Editor de Material.

Inserindo funções de material

Na maioria dos casos, você usará os mesmos métodos acima para colocar funções de material em seu gráfico. A Paleta e o menu acionado com o botão direito funcionam da mesma forma para funções de material e para expressões.

Existe uma maneira adicional de colocar funções de material no seu gráfico.

Colocando funções de material a partir do Navegador de Conteúdo

Uma coisa exclusiva de funções de material é que você também pode arrastá-las e soltá-los do Navegador de Conteúdo até o seu material.

Encontre a função de material que você deseja usar no Navegador de Conteúdo e clique com o botão esquerdo e arraste o recurso até o gráfico de material. Você pode acessar o Navegador de Conteúdo na Gaveta de Conteúdo na parte inferior do Editor de Material ou na janela principal do Editor do UE5.

Para encontrar funções de material no Navegador de Conteúdo, você precisa procurar na pasta Engine, que não está visível por padrão.

Para exibir a pasta Engine, clique no ícone Configurações no lado direito do Navegador de Conteúdo e marque Mostrar Conteúdo da Engine.

As funções de material são encontradas no navegador de conteúdo no caminho Tudo > Engine > Conteúdo > Funções.

Conectando nós de material

Use as etapas a seguir para conectar quaisquer dois nós no seu gráfico de material.

Clique com o botão esquerdo e arraste um fio de um pin de entrada ou saída no primeiro nó.
Solte o botão esquerdo do mouse sobre um pin no segundo nó.

Para excluir uma conexão, segure a tecla Alt e clique no fio entre dois nós. Você também pode clicar com o botão esquerdo no fio e pressionar Delete.

Você pode mover um fio existente de um pin para outro. Ctrl+clique na conexão que deseja mover e arraste-a até uma entrada ou saída diferente.

Conclusão

Expressões e funções de materiais são os principais blocos de construção de materiais do UE5. O engine inclui centenas de nós de material, cada um projetado para armazenar um tipo específico de dados ou executar um conjunto de instruções HLSL. Você provavelmente acabará usando um pequeno número de nós com muita frequência. Por exemplo, as expressões de material com atalhos de teclado documentados acima são fundamentais para a criação de materiais no UE5.

Expressões e funções de materiais geralmente têm dicas de ferramentas para resumir sua finalidade, e a maioria está documentada nas páginas de referência de materiais.

Como as expressões de material geralmente são código HLSL puro, você também pode ler a documentação HLSL oficial da Microsoftn for technical background information.