---
title: "LOD Group"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/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.
:::
## Criar e configurar
Selecione o objeto na Hierarquia, abra **Adicionar componente** e procure **LOD Group**, na família **Renderização**. Confira os requisitos antes de confirmar a composição.
O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.LodGroup](/pt-br/snapshot-2026-10-06/api/astra-components-lodgroup/).
## 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**
`transition_0` | número · % | 60 | 0.1 … 100 |
| **Transição LOD 1**
`transition_1` | número · % | 30 | 0.1 … 100 |
| **Transição LOD 2**
`transition_2` | número · % | 10 | 0.1 … 100 |
| **Transição LOD 3**
`transition_3` | número · % | 5 | 0.1 … 100 |
| **Ativo**
`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| **Níveis**
`level_count` | enumeração | 3 | 1 \| 2 \| 3 \| 4 |
| **Objetos LOD 0**
`level_0` | referência | Nenhum | qualquer objeto · abaixo deste objeto |
| **Objetos LOD 1**
`level_1` | referência | Nenhum | qualquer objeto · abaixo deste objeto |
| **Objetos LOD 2**
`level_2` | referência | Nenhum | qualquer objeto · abaixo deste objeto |
| **Objetos LOD 3**
`level_3` | referência | Nenhum | qualquer objeto · abaixo deste objeto |
**`transition_0`:** Altura na tela abaixo da qual este nível deixa de ser usado Níveis são objetos do autor ou da convenção _LOD<n>; simplificação automática de malha ainda não existe
**`transition_1`:** Altura na tela abaixo da qual este nível deixa de ser usado A exibição depende do estado do componente. Níveis são objetos do autor ou da convenção _LOD<n>; simplificação automática de malha ainda não existe
**`transition_2`:** Altura na tela abaixo da qual este nível deixa de ser usado A exibição depende do estado do componente. Níveis são objetos do autor ou da convenção _LOD<n>; simplificação automática de malha ainda não existe
**`transition_3`:** Altura na tela abaixo da qual este nível deixa de ser usado A exibição depende do estado do componente. Níveis são objetos do autor ou da convenção _LOD<n>; simplificação automática de malha ainda não existe
**`enabled`:** Desligar libera os renderizadores do controle deste grupo Níveis são objetos do autor ou da convenção _LOD<n>; simplificação automática de malha ainda não existe
**`level_count`:** Níveis são objetos do autor ou da convenção _LOD<n>; simplificação automática de malha ainda não existe
**`level_0`:** Níveis são objetos do autor ou da convenção _LOD<n>; simplificação automática de malha ainda não existe
**`level_1`:** A exibição depende do estado do componente. Níveis são objetos do autor ou da convenção _LOD<n>; simplificação automática de malha ainda não existe
**`level_2`:** A exibição depende do estado do componente. Níveis são objetos do autor ou da convenção _LOD<n>; simplificação automática de malha ainda não existe
**`level_3`:** A exibição depende do estado do componente. Níveis são objetos do autor ou da convenção _LOD<n>; simplificação automática de malha ainda não existe
### Limites
| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|
| **Tamanho**
`size` | número | 1 | 0.001 … 1000000 |
**`size`:** Maior extensão do nível mais detalhado; Recalcular mede a malha Níveis são objetos do autor ou da convenção _LOD<n>; simplificação automática de malha ainda não existe
### Fade
| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|
| **Largura do fade LOD 0**
`fade_width_0` | número | 0.2 | 0 … 1 |
| **Largura do fade LOD 1**
`fade_width_1` | número | 0.2 | 0 … 1 |
| **Largura do fade LOD 2**
`fade_width_2` | número | 0.2 | 0 … 1 |
| **Largura do fade LOD 3**
`fade_width_3` | número | 0.2 | 0 … 1 |
| **Animate Cross-fading**
`animate_cross_fading` | booleano | falso | verdadeiro \| falso |
| **Fade Mode**
`fade_mode` | enumeração | Nenhum | Nenhum \| Cross Fade |
**`fade_width_0`:** Proporção do nível em que ele cruza com o próximo A exibição depende do estado do componente. Níveis são objetos do autor ou da convenção _LOD<n>; simplificação automática de malha ainda não existe
**`fade_width_1`:** Proporção do nível em que ele cruza com o próximo A exibição depende do estado do componente. Níveis são objetos do autor ou da convenção _LOD<n>; simplificação automática de malha ainda não existe
**`fade_width_2`:** Proporção do nível em que ele cruza com o próximo A exibição depende do estado do componente. Níveis são objetos do autor ou da convenção _LOD<n>; simplificação automática de malha ainda não existe
**`fade_width_3`:** Proporção do nível em que ele cruza com o próximo A exibição depende do estado do componente. Níveis são objetos do autor ou da convenção _LOD<n>; simplificação automática de malha ainda não existe
**`animate_cross_fading`:** Troca por tempo em vez da faixa de largura A exibição depende do estado do componente. Níveis são objetos do autor ou da convenção _LOD<n>; simplificação automática de malha ainda não existe
**`fade_mode`:** Níveis são objetos do autor ou da convenção _LOD<n>; simplificação automática de malha ainda não existe
### Execução
| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|
| **Forçar nível**
`force_level` | enumeração | Automático | Automático \| LOD 0 \| LOD 1 \| LOD 2 \| LOD 3 |
**`force_level`:** Estado de execução: 0 automático, n força o LOD n-1 A exibição depende do estado do componente. Níveis são objetos do autor ou da convenção _LOD<n>; simplificação automática de malha ainda não existe
## 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.