O Modo folhagem é um conjunto de ferramentas que permite pintar ou apagar rapidamente conjuntos de Malhas estáticas ou Folhagem de ator em atores e geometria habilitados para filtro. Usando esse modo, é possível preencher um ambiente externo grande com folhagem em um curto espaço de tempo.

A folhagem pode adicionar detalhes rapidamente a qualquer ambiente externo.
Para obter exemplos da ferramenta Folhagem em ação, consulte a seção Folhagem do projeto Exemplos de conteúdo de paisagens.
Modo de edição de folhagem
Para usar a ferramenta Folhagem, clique na opção Folhagem (Shift+3) no menu suspenso Modos.
Isso abrirá o painel Folhagem.
Painel do Modo folhagem
| Números | Descrição |
|---|---|
| 1 | Paleta de ferramentas |
| 2 | Opções de pincel |
| 3 | Opções de filtro |
| 4 | Paleta de folhagem |
| 5 | Detalhes da folhagem |
Tipos de folhagem
Abra o menu suspenso Adicionar tipo de folhagem para adicionar o seguinte:
| Tipo de folhagem | Descrição |
|---|---|
| Folhagem de ator | Tipo de folhagem que coloca instâncias de blueprint ou ator nativo na cena. Altas densidades de folhagem podem causar problemas de desempenho. |
| Folhagem de malha estática | Tipo de folhagem que usa instanciamento de malha. Esse tipo é melhor para folhagem não destrutiva. |
Malhas estáticas colocadas com o Modo de edição de folhagem são agrupadas automaticamente em lotes que são renderizados usando instanciação de hardware, em que muitas instâncias podem ser renderizadas com apenas uma única chamada de desenho, enquanto a Folhagem de ator tem o mesmo custo de renderização que colocar atores normais em uma cena.
Usando o Modo folhagem
O Modo folhagem é uma coleção de ferramentas que são usadas para pintar a folhagem diretamente em uma paisagem ou outro ator habilitado para filtros.
Ferramentas de folhagem
| Ferramenta | Descrição |
|---|---|
| Selecionar | Seleciona instâncias de folhagem individuais. Você pode selecionar várias malhas de folhagem pressionando o botão Ctrl. |
| Tudo | Seleciona todas as instâncias de folhagem. |
| Desmarcar | Limpa a seleção atual. |
| Inválido | Seleciona qualquer instância de folhagem inválida. |
| Laço | Seleciona quaisquer instâncias de folhagem do tipo de folhagem selecionado quando pintadas com o pincel. |
| Pintura | Pinta instâncias do tipo de folhagem selecionado. Apague instâncias do tipo de folhagem selecionado mantendo a tecla Shift pressionada ao pintar. |
| Reaplicar | Altera seletivamente os parâmetros para instâncias de folhagem já colocadas no mundo. Use da seguinte forma:
|
| Único | Pinta uma única instância do tipo de folhagem selecionado. |
| Preencher | Preenche o alvo selecionado com instâncias de folhagem. |
| Apagar | Apaga o tipo de folhagem selecionado quando pintado com o pincel. |
| Remover | Remove as instâncias de folhagem selecionadas. |
| Mover | Move as instâncias de folhagem selecionadas para o nível atual. |
Opções de pincel
A seção Opções de pincel é sensível ao contexto e contém um ou mais dos seguintes itens:
| Opção | Descrição |
|---|---|
| Tamanho do pincel | Ajusta o tamanho do pincel de folhagem. |
| Densidade do ponto | Ajusta a densidade da folhagem afetada pela ferramenta selecionada. Este é um multiplicador da propriedade de Densidade localizada nos detalhes do tipo de folhagem selecionado. |
| Apagar densidade | Ajusta a densidade da folhagem que fica para trás ao apagar com a tecla Shift pressionada. |
| Modo de instância única | Quando habilitado, pinta uma única instância de folhagem na localização do cursor. Pode ser usado em dois modos:
|
| Lugar no nível atual | Quando habilitado, coloca instâncias dos tipos de folhagem selecionados no nível atual. Caso contrário, coloca as instâncias dos tipos de folhagem selecionados no nível que contém a malha ou o ator que está sendo pintado. |
Configurações de filtro
Usando a seção Filtros, você pode controlar quais superfícies a ferramenta selecionada afeta e quais tipos de folhagem estão ativos no momento. Esta também é a seção do menu onde novos tipos de folhagem são adicionados.
| Opção | Descrição |
|---|---|
| Paisagem | Coloca os tipos de folhagem selecionados em Paisagens. |
| Malha estática | Coloca os tipos de folhagem selecionados em malhas estáticas. |
| BSP | Coloca os tipos de folhagem selecionados na geometria BSP. |
| folhagem | Coloca os tipos de folhagem selecionados em outra geometria de folhagem de bloqueio. |
| Translúcido | Posiciona os tipos de folhagem selecionados na geometria translúcida. |
| Lista de malha | Área na qual são colocadas Malhas estáticas e Folhagem do ator usadas como folhagem. Colocar o ponteiro do mouse sobre um tipo de folhagem exibe uma caixa de seleção que ativa ou desativa esse tipo de folhagem ao usar uma ferramenta. Clicar em um ou mais tipos de folhagem exibe seus detalhes nos Detalhes da folhagem localizados abaixo da área Lista de malha. |
| Detalhes da folhagem | Área que exibe os detalhes dos tipos de folhagem selecionados. Contém uma variedade de propriedades para personalizar o comportamento da Malha Estática ou Folhagem do ator. |
Para obter mais informações sobre como adicionar tipos de folhagem à lista de malha, consulte Adicionando folhagem a um ator de paisagem
Configurações de seleção
Instâncias de folhagem são renderizadas como clusters em uma única chamada de desenho, e cada cluster é renderizado ou não com base na oclusão. Definir um valor no parâmetro Distância final de coleta nos detalhes da folhagem faz com que os cachos sejam selecionados além dessa distância. No entanto, isso fará com que grupos de malhas desapareçam abruptamente à medida que todo o cluster sai do alcance.
Isso pode ser reduzido adicionando um parâmetro Start Cull Distance e, em seguida, configurando o Material apropriadamente. No shader de vértice, é calculado um fator de desvanecimento por instância, que vai de 1,0 na distância inicial a 0,0 na distância final. Isso pode ser acessado no Material usando um nó PerInstanceFadeAmount. Ao conectá-lo a um valor de opacidade ou máscara, você pode usá-lo para esmaecer instâncias em uma distância antes que elas atinjam o Fim da distância de retirada e sejam removidas da renderização. Diminuir o valor do parâmetro FadeMultiplier aumentará a velocidade do fade. Um valor de zero tornará sua folhagem invisível a qualquer distância.
O material de exemplo abaixo multiplica a máscara de material pelo fator de esmaecimento para afinar as folhas da malha de folhagem até que desapareçam completamente.
Malhas habilitadas para o Nanite não são afetadas pela distância de seleção e esmaecimento de instância.
Configurações de LOD
LOD de malha estática é compatível com folhagem. Existem algumas ressalvas:
- Você deve garantir que sua malha estática tenha apenas uma entrada na matriz de elementos (visível em LOD0).
- Os mapas de luz e sombra são compartilhados entre todos os níveis de LOD, então todos os LODs precisam usar o mesmo desdobramento.
- Atualmente, todo o cluster de instâncias altera os LODs simultaneamente. Podemos adicionar suporte para desvanecimento baseado em distância por instância no futuro.
Iluminação
Os mapas de sombra e luz são gerados individualmente pelo Lightmass conforme necessário para cada instância e são colocados lado a lado para cada lote pré-computado. Existem várias configurações na malha estática que devem ser verificadas para que a iluminação pré-computada funcione bem com a folhagem instanciada. O Lightmass é menos tolerante ao gerar mapas de sombra para malhas instanciadas, e configurações incorretas podem gerar malhas pretas após a reconstrução da iluminação.
- Índice de coordenadas do mapa de luz: Deve ser definido como um canal UV válido que tenha um desdobramento UV exclusivo. O recurso Gerar UVs exclusivos do Editor de Malha Estática, acessível no menu Janela, pode gerar rapidamente um desdobramento exclusivo.
- Resolução do mapa de iluminação: Deve ser um número pequeno o suficiente para que todos os mapas de sombra de instâncias em um único grupo (por padrão 100) possam ser colocados lado a lado sem exceder a resolução máxima de textura (4094x4096).
Escalabilidade da folhagem
Malhas estáticas de folhagem podem usar o sistema de escalabilidade para aumentar ou diminuir a quantidade de instâncias de folhagem que estão sendo renderizadas na tela.
Para usar essa funcionalidade no seu projeto:
-
Navegue até a Lista de malhas de folhagem e selecione um tipo de folhagem.
-
Em Detalhes da folhagem, localize a seção Escalabilidade.
-
Marque a caixa de seleção para Habilitar redimensionamento de densidade.
Agora, você pode controlar a densidade da folhagem renderizada durante o tempo de execução com o comando foliage.DensityScale.
Abaixo, é possível ver a densidade das alterações de folhagem, pois a configuração de foliage.DensityScale está definida como 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1.0.

Arraste o controle deslizante para ajustar a configuração de foliage.DensityScale de 0,1 para 1,0.
Usando folhagem com o World Partition
Em um mapa World Partition, o tamanho da grade padrão para instâncias de folhagem é de 256 metros. Isso é separado do tamanho da grade da World Partition.
Para alterar o tamanho padrão da grade de folhagem instanciada para novos mapas:
- Abra as Configurações do projeto abrindo o menu Editar e selecionando a opção Configurações do projeto.
- Na caixa de pesquisa, procure por Folhagem.
- Altere o valor de Tamanho da grade de folhagem instanciada para o valor desejado em centímetros. No exemplo acima, 25600 centímetros é igual a 256 metros.
O tamanho da grade padrão pode ser alterado para mapas existentes usando o Commandlet World Partition Builder:
Para alterar o tamanho da grade padrão para instâncias de folhagem:
-
No Windows, abra uma janela do Prompt de Comando.
-
No prompt, comece navegando até o local do arquivo executável
UnrealEditor.exe. No exemplo acima:c:\Builds\Home_UE5_Engine\Engine\Binaries\Win64. - Em seguida, inicie o comando com o nome do arquivo .exe que executará o commandlet,
UnrealEditor.exe. -
Adicione o nome do projeto. Aqui como
QAGame. -
Adicione o nome do mapa de destino.
-
Termine o comando com o nome do commandlet e os seguintes argumentos:
-run=WorldPartitionBuilderCommandleté o nome do commandlet.-Builder=WorldPartitionFoliageBuilderé o nome do construtor dentro do commandlet.-NewGridSizeé o novo valor da grade de folhagem instanciada em centímetros. No exemplo, um valor 51200 é igual a 512 metros.
- Pressione Enter, e o commandlet mudará sua configuração de grade de instância de folhagem para o mapa designado.
Adicionando folhagem a uma paisagem
Pintar um ou mais tipos de folhagem diretamente em um ator de paisagem é uma excelente maneira de adicionar detalhes rapidamente a qualquer ambiente externo.
-
Comece criando um novo ator de paisagem se o seu nível ainda não tiver um. Esculpa algumas colinas para criar um pouco de contraste. Para obter mais informações sobre como criar e trabalhar com atores de paisagem, consulte o Guia de início rápido com paisagens.
- Abra o menu suspenso Modos e selecione o modo Folhagem. Como alternativa, você pode usar a tecla de atalho Shift + 3.
-
Na Gaveta de conteúdo, navegue até o local de uma malha estática que você gostaria de usar como um tipo de folhagem, como este Cubo de malha estática. Clique e arraste Malha estática na Gaveta de conteúdo para a Lista de malhas no painel Folhagem.
-
Selecione a ferramenta Pintar. Ajuste Tamanho do pincel em Opções do pincel para 128. Ajuste a Densidade da tinta para 0.3.
-
Selecione Malha estática na Lista de malhas. Na seção Pintura de Detalhes da folhagem, altere o valor de Raio para 100. Neste exemplo, isso garante que as instâncias do cubo que serão pintadas na paisagem não se sobreponham.
-
Em seguida, ajuste o valor Mín da Escala X para 0,4 e o valor Máx para 0,8. Isso criará uma variedade de tamanhos quando a folhagem for pintada.
-
Na janela de visualização, clique e segure o botão esquerdo do mouse para pintar a folhagem na Paisagem.
Reconectando instâncias de folhagem
Pode haver momentos em que as instâncias de folhagem podem se desconectar do seu componente base. Por exemplo, quando o posicionamento da folhagem está bom, mas a paisagem base precisa ser alterada.
Para recolocar a folhagem no componente subjacente, siga estas etapas:
- No Modo folhagem, selecione as instâncias de folhagem que deseja reanexar.
- Na janela de visualização, mova as instâncias selecionadas acima do componente de destino.
- Pressione a tecla Fim para encaixar a folhagem no chão. Isso fará com que as instâncias de folhagem sejam novamente relacionadas ao componente de destino. A folhagem também se alinhará ao componente com base na normal desse componente se eles tiverem sido originalmente posicionados usando a opção Alinhar à normal. Essa configuração está localizada na seção Posicionamento dos Detalhes do tipo de folhagem.