Malha

Astra atual · C# · 06 out. 2026Conferido em fonte

Geometria e material

Família: Renderização · Grupo: Geometria · Identificador: astra.render.mesh · Payload: 9

Criar e configurar

Selecione o objeto na Hierarquia, abra Adicionar componente e procure Malha, 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.MeshRenderer.

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	9

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.

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.

Geral

| Propriedade | Tipo / unidade | Padrão | Domínio | |—|—|—| | Cor R
base_color.r | número | 1 | 0 … 1 | | Cor G
base_color.g | número | 1 | 0 … 1 | | Cor B
base_color.b | número | 1 | 0 … 1 | | Rugosidade
roughness | número | 0.5 | 0 … 1 | | Metálico
metallic | número | 0 | 0 … 1 | | Intensidade da normal
normal_scale | número | 1 | 0 … 16 | | Especular
specular | número | 1 | 0 … 1 | | Emissão R
emission.r | número | 0 | 0 … 1 | | Emissão G
emission.g | número | 0 | 0 … 1 | | Emissão B
emission.b | número | 0 | 0 … 1 | | Potência de emissão
emission_strength | número | 1 | 0 … 10000 | | Renderizar
enabled | booleano | verdadeiro | verdadeiro | falso |

Lightmap

| Propriedade | Tipo / unidade | Padrão | Domínio | |—|—|—| | Escala U
lightmap.scale_u | número
Por slot | 1 | 0.00001 … 1 | | Escala V
lightmap.scale_v | número
Por slot | 1 | 0.00001 … 1 | | Deslocamento U
lightmap.offset_u | número
Por slot | 0 | 0 … 1 | | Deslocamento V
lightmap.offset_v | número
Por slot | 0 | 0 … 1 | | Intensidade
lightmap.intensity | número
Por slot | 1 | 0 … 10000 | | Receber lightmap indireto
lightmap.enabled | enumeração
Por slot | Desativado | Desativado | Lightmap indireto externo |

lightmap.scale_u: Lightmap externo de irradiância RGB linear em UV1; exige bindless. Sem bake interno. RGB linear de irradiância; UV1 autoral; exige bindless. Sem bake, unwrap ou probes

lightmap.scale_v: Lightmap externo de irradiância RGB linear em UV1; exige bindless. Sem bake interno. RGB linear de irradiância; UV1 autoral; exige bindless. Sem bake, unwrap ou probes

lightmap.offset_u: Lightmap externo de irradiância RGB linear em UV1; exige bindless. Sem bake interno. RGB linear de irradiância; UV1 autoral; exige bindless. Sem bake, unwrap ou probes

lightmap.offset_v: Lightmap externo de irradiância RGB linear em UV1; exige bindless. Sem bake interno. RGB linear de irradiância; UV1 autoral; exige bindless. Sem bake, unwrap ou probes

lightmap.intensity: Lightmap externo de irradiância RGB linear em UV1; exige bindless. Sem bake interno. RGB linear de irradiância; UV1 autoral; exige bindless. Sem bake, unwrap ou probes

lightmap.enabled: Lightmap externo de irradiância RGB linear em UV1; exige bindless. Sem bake interno. RGB linear de irradiância; UV1 autoral; exige bindless. Sem bake, unwrap ou probes

Superfície

Canais

Amostragem

Cor

Emissão

| Propriedade | Tipo / unidade | Padrão | Domínio | |—|—|—| | Emissão R
material.emission.r | número
Por slot | 0 | 0 … 1 | | Emissão G
material.emission.g | número
Por slot | 0 | 0 … 1 | | Emissão B
material.emission.b | número
Por slot | 0 | 0 … 1 | | Potência de emissão
material.emission_strength | número
Por slot | 1 | 0 … 10000 |

Conferir na sua cena

Crie Malha pelo fluxo indicado e resolva as dependências.
Altere uma propriedade por vez e observe o efeito esperado na cena.
Salve, reabra e confira os valores autorais.
Entre em Play e verifique o comportamento com os recursos reais do projeto.
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. Essa referência não representa paridade funcional.