---
title: "LOD Group"
version: snapshot-2026-10-07
engineGeneration: astra-current
language: C#
status: source-reviewed
reviewedAt: 2026-10-07
appRelease: "0.2.3-preview.20261007"
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-07/componentes/astra-render-lod-group/
---

# LOD Group

Nível de detalhe pela altura na tela

**Família:** Renderização · **Grupo:** Desempenho · **Identificador:** `astra.render.lod_group` · **Payload:** 3

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Nível de detalhe pela altura na tela

Atribua geometria e recursos compatíveis; altere material/slot, luz ou ambiente e observe o resultado pela câmera. Valores autorais e política gráfica efetiva têm estados distintos.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Renderização** / **Desempenho** → **LOD Group**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.LodGroup](/pt-br/snapshot-2026-10-07/api/astra-components-lodgroup/).





## Exemplo de uso

Uma malha, câmera e luz: compare rugosidade/metalness no mesmo enquadramento, ou alcance/intensidade da luz sobre a malha. Material emissivo sozinho não equivale a uma luz iluminando objetos vizinhos.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 3 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Níveis

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Transição LOD 0**](#field-transition-0)<br/>`transition_0` | número · % | 60 | 0.1 … 100 |
| [**Transição LOD 1**](#field-transition-1)<br/>`transition_1` | número · % | 30 | 0.1 … 100 |
| [**Transição LOD 2**](#field-transition-2)<br/>`transition_2` | número · % | 10 | 0.1 … 100 |
| [**Transição LOD 3**](#field-transition-3)<br/>`transition_3` | número · % | 5 | 0.1 … 100 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Níveis**](#field-level-count)<br/>`level_count` | enumeração | 3 | 1 \| 2 \| 3 \| 4 |
| [**Objetos LOD 0**](#field-level-0)<br/>`level_0` | referência | Nenhum | qualquer objeto · abaixo deste objeto |
| [**Objetos LOD 1**](#field-level-1)<br/>`level_1` | referência | Nenhum | qualquer objeto · abaixo deste objeto |
| [**Objetos LOD 2**](#field-level-2)<br/>`level_2` | referência | Nenhum | qualquer objeto · abaixo deste objeto |
| [**Objetos LOD 3**](#field-level-3)<br/>`level_3` | referência | Nenhum | qualquer objeto · abaixo deste objeto |

<h4 id="field-transition-0">Transição LOD 0 · <code>transition_0</code></h4>

**Onde:** Inspector → **LOD Group** → **Níveis** → **Transição LOD 0**.

**Uso e efeito:** Altura na tela abaixo da qual este nível deixa de ser usado

**Valor:** 60 · **Tipo:** número · **Unidade:** % · **Domínio:** 0.1 … 100.

Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-transition-1">Transição LOD 1 · <code>transition_1</code></h4>

**Onde:** Inspector → **LOD Group** → **Níveis** → **Transição LOD 1**.

**Uso e efeito:** Altura na tela abaixo da qual este nível deixa de ser usado

**Valor:** 30 · **Tipo:** número · **Unidade:** % · **Domínio:** 0.1 … 100.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-transition-2">Transição LOD 2 · <code>transition_2</code></h4>

**Onde:** Inspector → **LOD Group** → **Níveis** → **Transição LOD 2**.

**Uso e efeito:** Altura na tela abaixo da qual este nível deixa de ser usado

**Valor:** 10 · **Tipo:** número · **Unidade:** % · **Domínio:** 0.1 … 100.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-transition-3">Transição LOD 3 · <code>transition_3</code></h4>

**Onde:** Inspector → **LOD Group** → **Níveis** → **Transição LOD 3**.

**Uso e efeito:** Altura na tela abaixo da qual este nível deixa de ser usado

**Valor:** 5 · **Tipo:** número · **Unidade:** % · **Domínio:** 0.1 … 100.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **LOD Group** → **Níveis** → **Ativo**.

**Uso e efeito:** Desligar libera os renderizadores do controle deste grupo

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-level-count">Níveis · <code>level_count</code></h4>

**Onde:** Inspector → **LOD Group** → **Níveis** → **Níveis**.

**Uso e efeito:** Quantidade de níveis ativos de LOD. Atribua malhas/objetos por nível.

**Valor:** 3 · **Tipo:** enumeração · **Domínio:** 1 \| 2 \| 3 \| 4.

Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-level-0">Objetos LOD 0 · <code>level_0</code></h4>

**Onde:** Inspector → **LOD Group** → **Níveis** → **Objetos LOD 0**.

**Uso e efeito:** Objeto/recurso de renderização atribuído a este nível de LOD; referência ausente não fabrica geometria.

**Valor:** Nenhum · **Tipo:** referência · **Domínio:** qualquer objeto · abaixo deste objeto.

Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-level-1">Objetos LOD 1 · <code>level_1</code></h4>

**Onde:** Inspector → **LOD Group** → **Níveis** → **Objetos LOD 1**.

**Uso e efeito:** Objeto/recurso de renderização atribuído a este nível de LOD; referência ausente não fabrica geometria.

**Valor:** Nenhum · **Tipo:** referência · **Domínio:** qualquer objeto · abaixo deste objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-level-2">Objetos LOD 2 · <code>level_2</code></h4>

**Onde:** Inspector → **LOD Group** → **Níveis** → **Objetos LOD 2**.

**Uso e efeito:** Objeto/recurso de renderização atribuído a este nível de LOD; referência ausente não fabrica geometria.

**Valor:** Nenhum · **Tipo:** referência · **Domínio:** qualquer objeto · abaixo deste objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-level-3">Objetos LOD 3 · <code>level_3</code></h4>

**Onde:** Inspector → **LOD Group** → **Níveis** → **Objetos LOD 3**.

**Uso e efeito:** Objeto/recurso de renderização atribuído a este nível de LOD; referência ausente não fabrica geometria.

**Valor:** Nenhum · **Tipo:** referência · **Domínio:** qualquer objeto · abaixo deste objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

### Limites

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Tamanho**](#field-size)<br/>`size` | número | 1 | 0.001 … 1000000 |

<h4 id="field-size">Tamanho · <code>size</code></h4>

**Onde:** Inspector → **LOD Group** → **Limites** → **Tamanho**.

**Uso e efeito:** Maior extensão do nível mais detalhado; Recalcular mede a malha

**Valor:** 1 · **Tipo:** número · **Domínio:** 0.001 … 1000000.

Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

### Fade

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Largura do fade LOD 0**](#field-fade-width-0)<br/>`fade_width_0` | número | 0.2 | 0 … 1 |
| [**Largura do fade LOD 1**](#field-fade-width-1)<br/>`fade_width_1` | número | 0.2 | 0 … 1 |
| [**Largura do fade LOD 2**](#field-fade-width-2)<br/>`fade_width_2` | número | 0.2 | 0 … 1 |
| [**Largura do fade LOD 3**](#field-fade-width-3)<br/>`fade_width_3` | número | 0.2 | 0 … 1 |
| [**Animate Cross-fading**](#field-animate-cross-fading)<br/>`animate_cross_fading` | booleano | falso | verdadeiro \| falso |
| [**Fade Mode**](#field-fade-mode)<br/>`fade_mode` | enumeração | Nenhum | Nenhum \| Cross Fade |

<h4 id="field-fade-width-0">Largura do fade LOD 0 · <code>fade_width_0</code></h4>

**Onde:** Inspector → **LOD Group** → **Fade** → **Largura do fade LOD 0**.

**Uso e efeito:** Proporção do nível em que ele cruza com o próximo

**Valor:** 0.2 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-fade-width-1">Largura do fade LOD 1 · <code>fade_width_1</code></h4>

**Onde:** Inspector → **LOD Group** → **Fade** → **Largura do fade LOD 1**.

**Uso e efeito:** Proporção do nível em que ele cruza com o próximo

**Valor:** 0.2 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-fade-width-2">Largura do fade LOD 2 · <code>fade_width_2</code></h4>

**Onde:** Inspector → **LOD Group** → **Fade** → **Largura do fade LOD 2**.

**Uso e efeito:** Proporção do nível em que ele cruza com o próximo

**Valor:** 0.2 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-fade-width-3">Largura do fade LOD 3 · <code>fade_width_3</code></h4>

**Onde:** Inspector → **LOD Group** → **Fade** → **Largura do fade LOD 3**.

**Uso e efeito:** Proporção do nível em que ele cruza com o próximo

**Valor:** 0.2 · **Tipo:** número · **Domínio:** 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-animate-cross-fading">Animate Cross-fading · <code>animate_cross_fading</code></h4>

**Onde:** Inspector → **LOD Group** → **Fade** → **Animate Cross-fading**.

**Uso e efeito:** Troca por tempo em vez da faixa de largura

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

<h4 id="field-fade-mode">Fade Mode · <code>fade_mode</code></h4>

**Onde:** Inspector → **LOD Group** → **Fade** → **Fade Mode**.

**Uso e efeito:** Seleciona a política de transição de LOD, no domínio indicado.

**Valor:** Nenhum · **Tipo:** enumeração · **Domínio:** Nenhum \| Cross Fade.

Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

### Execução

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Forçar nível**](#field-force-level)<br/>`force_level` | enumeração | Automático | Automático \| LOD 0 \| LOD 1 \| LOD 2 \| LOD 3 |

<h4 id="field-force-level">Forçar nível · <code>force_level</code></h4>

**Onde:** Inspector → **LOD Group** → **Execução** → **Forçar nível**.

**Uso e efeito:** Estado de execução: 0 automático, n força o LOD n-1

**Valor:** Automático · **Tipo:** enumeração · **Domínio:** Automático \| LOD 0 \| LOD 1 \| LOD 2 \| LOD 3.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Níveis são objetos do autor ou da convenção _LOD&lt;n>; simplificação automática de malha ainda não existe Capacidade necessária: `render.lod.group`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

## Roadmap deste componente

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Cookies e luz de área, GI/lightmap bake, unwrap/atlas e sondas continuam no registro de capacidades conforme o item. Recursos importados não comprovam consumo. Performance e compatibilidade Vulkan precisam de aceite por aparelho.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **LOD Group** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.unity3d.com/6000.0/Documentation/Manual/class-LODGroup.html). Essa referência não representa paridade funcional.