Campo de arrasto 2D

Família: Física 2D · Grupo: Campos · Identificador: astra.physics2d.field.drag · Payload: 1

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

Amortecimento linear XY e angular de Body2D

Monte Body2D + Colisor 2D no plano XY. Juntas, forças e campos 2D operam nessa simulação; não compartilham automaticamente contatos com corpos 3D.

Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → Física 2D / Campos → Campo de arrasto 2D.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é Astra.Components.DragField2D.

Exemplo de uso

Coloque uma caixa 2D dinâmica sobre um chão 2D estático. Compare escala de gravidade e rotação travada. Conexão física 2D pode ativar um receptor ao entrar no sensor.

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	1

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.

Volume

Propriedade	Tipo / unidade	Padrão	Domínio
Meia extensão X half_x	número · m	3	0.001 … 10000
Meia extensão Y half_y	número · m	3	0.001 … 10000
Raio radius	número · m	3	0.001 … 10000
Centro X offset_x	número · m	0	-10000 … 10000
Centro Y offset_y	número · m	0	-10000 … 10000
Forma shape	enumeração	Retângulo	Retângulo | Círculo

Meia extensão X · half_x

Onde: Inspector → Campo de arrasto 2D → Volume → Meia extensão X.

Uso e efeito: Meia extensão da caixa neste eixo, em metros. Uma extensão .5 representa tamanho total 1 nesse eixo.

Valor: 3 · Tipo: número · Unidade: m · Domínio: 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Meia extensão Y · half_y

Onde: Inspector → Campo de arrasto 2D → Volume → Meia extensão Y.

Uso e efeito: Meia extensão da caixa neste eixo, em metros. Uma extensão .5 representa tamanho total 1 nesse eixo.

Valor: 3 · Tipo: número · Unidade: m · Domínio: 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Raio · radius

Onde: Inspector → Campo de arrasto 2D → Volume → Raio.

Uso e efeito: Raio da forma/volume selecionado; confira o tipo e os campos condicionais.

Valor: 3 · Tipo: número · Unidade: m · Domínio: 0.001 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Centro X · offset_x

Onde: Inspector → Campo de arrasto 2D → Volume → Centro X.

Uso e efeito: Deslocamento do resultado/volume em relação à origem configurada, eixo X.

Valor: 0 · Tipo: número · Unidade: m · Domínio: -10000 … 10000.

Centro Y · offset_y

Onde: Inspector → Campo de arrasto 2D → Volume → Centro Y.

Uso e efeito: Deslocamento do resultado/volume em relação à origem configurada, eixo Y.

Valor: 0 · Tipo: número · Unidade: m · Domínio: -10000 … 10000.

Forma · shape

Onde: Inspector → Campo de arrasto 2D → Volume → Forma.

Uso e efeito: Escala e orientação são as do objeto e de seus pais

Valor: Retângulo · Tipo: enumeração · Domínio: Retângulo | Círculo.

Efeito

Propriedade	Tipo / unidade	Padrão	Domínio
Arrasto linear linear_drag	número · 1/s	1	0 … 1000
Arrasto angular angular_drag	número · 1/s	1	0 … 1000
Ativo enabled	booleano	verdadeiro	verdadeiro | falso

Arrasto linear · linear_drag

Onde: Inspector → Campo de arrasto 2D → Efeito → Arrasto linear.

Uso e efeito: Arrasto linear aplicado pelo campo.

Valor: 1 · Tipo: número · Unidade: 1/s · Domínio: 0 … 1000.

Arrasto angular · angular_drag

Onde: Inspector → Campo de arrasto 2D → Efeito → Arrasto angular.

Uso e efeito: Arrasto angular aplicado pelo campo.

Valor: 1 · Tipo: número · Unidade: 1/s · Domínio: 0 … 1000.

Ativo · enabled

Onde: Inspector → Campo de arrasto 2D → Efeito → Ativo.

Uso e efeito: Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

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

Alcance

Propriedade	Tipo / unidade	Padrão	Domínio
Acordar corpos wake_bodies	booleano	verdadeiro	verdadeiro | falso
Queda de influência falloff	enumeração	Uniforme	Uniforme | Linear | Suave
Camada afetada affected_layer	enumeração	Todas	Todas | Camada 0 | Camada 1 | Camada 2 | Camada 3 | Camada 4 | Camada 5 | Camada 6 | Camada 7 | Camada 8 | Camada 9 | Camada 10 | Camada 11 | Camada 12 | Camada 13 | Camada 14 | Camada 15 | Camada 16 | Camada 17 | Camada 18 | Camada 19 | Camada 20 | Camada 21 | Camada 22 | Camada 23 | Camada 24 | Camada 25 | Camada 26 | Camada 27 | Camada 28 | Camada 29 | Camada 30 | Camada 31

Acordar corpos · wake_bodies

Onde: Inspector → Campo de arrasto 2D → Alcance → Acordar corpos.

Uso e efeito: Desligado: corpos em repouso permanecem dormindo

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

Queda de influência · falloff

Onde: Inspector → Campo de arrasto 2D → Alcance → Queda de influência.

Uso e efeito: Centro vale 1; Linear e Suave chegam a zero na borda

Valor: Uniforme · Tipo: enumeração · Domínio: Uniforme | Linear | Suave.

Camada afetada · affected_layer

Onde: Inspector → Campo de arrasto 2D → Alcance → Camada afetada.

Uso e efeito: Todas ou uma camada física do projeto; não altera a matriz de colisão

Valor: Todas · Tipo: enumeração · Domínio: Todas | Camada 0 | Camada 1 | Camada 2 | Camada 3 | Camada 4 | Camada 5 | Camada 6 | Camada 7 | Camada 8 | Camada 9 | Camada 10 | Camada 11 | Camada 12 | Camada 13 | Camada 14 | Camada 15 | Camada 16 | Camada 17 | Camada 18 | Camada 19 | Camada 20 | Camada 21 | Camada 22 | Camada 23 | Camada 24 | Camada 25 | Camada 26 | Camada 27 | Camada 28 | Camada 29 | Camada 30 | Camada 31.

Roadmap deste componente

Física 2D. Fechar autoria e cenários de solver/eventos/queries no Android; ampliar formas e juntas somente com consumidores. Física 2D presente não representa renderização Sprite/Tilemap completa.

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 Campo de arrasto 2D 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. Essa referência não representa paridade funcional.