--- title: "Astra.Components.RadialField2D" version: snapshot-2026-10-07 engineGeneration: astra-current language: C# status: semantic-reference reviewedAt: 2026-10-07 appRelease: "0.2.3-preview.20261007" runtimeVerified: false platformEvidence: [] url: https://astraengine.com.br/pt-br/snapshot-2026-10-07/api/astra-components-radialfield2d/ --- # Astra.Components.RadialField2D Campo radial 2D: Atração, repulsão e vórtice no plano XY. Família Física 2D · Campos. **Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct :::note[Sobre esta referência] Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial. ::: ## Declaração ```csharp readonly struct Astra.Components.RadialField2D ``` Campo radial 2D: Atração, repulsão e vórtice no plano XY. Família Física 2D · Campos. Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_area2d.html **Interfaces:** `Astra.Components.IComponentFacade`. ## Onde acessar este tipo Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 2D** / **Campos** → **Campo radial 2D**. No Behavior em Play, obtenha a fachada com `Object.GetComponent()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new RadialField2D(component)` envolve um componente existente; não adiciona um componente à cena. ## Roadmap e uso [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente. Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/). Consulte também [Campo radial 2D](/pt-br/snapshot-2026-10-07/componentes/astra-physics2d-field-radial/) para propriedades, valores iniciais, requisitos e edição em Play. ## Membros | Membro | Categoria | |---|---| | [.ctor](#member-30e3e891d18c2134) | Method | | [Remove](#member-e4751a191fed5159) | Method | | [Wrap](#member-5b3e1d1d62285ef9) | Method | | [Acceleration](#member-cb4b802f09c21126) | Property | | [AffectedLayer](#member-cb5a919996aa6faf) | Property | | [Component](#member-0bd964436df09576) | Property | | [Enabled](#member-da65042fd69fc13e) | Property | | [Falloff](#member-cdbc3cd8f0d9df86) | Property | | [HalfExtents](#member-ea7d540374c8a399) | Property | | [InstanceId](#member-8c7634d3b3802a3b) | Property | | [IsAlive](#member-0e0979caeaadd370) | Property | | [Object](#member-48fcf3ef1cf89cdd) | Property | | [Offset](#member-8c0b27c587c7a2e2) | Property | | [Radius](#member-5bbdce42a3a987cc) | Property | | [Shape](#member-776e0853fc377939) | Property | | [TangentialAcceleration](#member-50e67b177ed8c2da) | Property | | [TypeId](#member-3ce530872e4a4d58) | Property | | [WakeBodies](#member-87aaef0e775b1119) | Property |

.ctor

```csharp public RadialField2D(Astra.Component component) ``` **Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior. **Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência. | Parâmetro | Tipo | Contrato | |---|---|---| | `component` | `Astra.Component` | |

Remove

```csharp public void Remove() ``` Remove a instância pelo ciclo nativo; dependências e ownership podem recusar. **Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior. **Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Wrap

```csharp public static Astra.Components.RadialField2D Wrap(Astra.Component component) ``` **Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior. **Uso:** Envolve um Component existente após conferir TypeId; não cria componente. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência. | Parâmetro | Tipo | Contrato | |---|---|---| | `component` | `Astra.Component` | |

Acceleration

```csharp public float Acceleration { get; set; } ``` Aceleração radial (m/s²) Faixa válida: -10000 a 10000. **Caminho:** Inspector → Campo radial 2D → Efeito; ou fachada C# em um Behavior. **Uso:** **Aceleração radial:** Aceleração radial em relação à origem do campo. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

AffectedLayer

```csharp public Astra.Components.RadialField2D.AffectedLayerOption AffectedLayer { get; set; } ``` Camada afetada. Todas ou uma camada física do projeto; não altera a matriz de colisão **Caminho:** Inspector → Campo radial 2D → Alcance; ou fachada C# em um Behavior. **Uso:** **Camada afetada:** Todas ou uma camada física do projeto; não altera a matriz de colisão **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Component

```csharp public Astra.Component Component { get; } ``` **Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior. **Uso:** Handle genérico da instância, usado para operações de reflexão e recursos. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Enabled

```csharp public bool Enabled { get; set; } ``` Ativo **Caminho:** Inspector → Campo radial 2D → Efeito; ou fachada C# em um Behavior. **Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Falloff

```csharp public Astra.Components.RadialField2D.FalloffOption Falloff { get; set; } ``` Queda de influência. Centro vale 1; Linear e Suave chegam a zero na borda **Caminho:** Inspector → Campo radial 2D → Alcance; ou fachada C# em um Behavior. **Uso:** **Queda de influência:** Centro vale 1; Linear e Suave chegam a zero na borda **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

HalfExtents

```csharp public System.Numerics.Vector2 HalfExtents { get; set; } ``` Meias XY **Caminho:** Inspector → Campo radial 2D → Volume; ou fachada C# em um Behavior. **Uso:** **Meia extensão X:** Meia extensão da caixa neste eixo, em metros. Uma extensão .5 representa tamanho total 1 nesse eixo. **Meia extensão Y:** Meia extensão da caixa neste eixo, em metros. Uma extensão .5 representa tamanho total 1 nesse eixo. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

InstanceId

```csharp public ulong InstanceId { get; } ``` **Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior. **Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

IsAlive

```csharp public bool IsAlive { get; } ``` **Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior. **Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Object

```csharp public Astra.GameObject Object { get; } ``` **Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior. **Uso:** Objeto dono deste componente; use para resolver composição. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Offset

```csharp public System.Numerics.Vector2 Offset { get; set; } ``` Centro local **Caminho:** Inspector → Campo radial 2D → Volume; ou fachada C# em um Behavior. **Uso:** **Centro X:** Deslocamento do resultado/volume em relação à origem configurada, eixo X. **Centro Y:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Radius

```csharp public float Radius { get; set; } ``` Raio (m) Faixa válida: 0.001 a 10000. **Caminho:** Inspector → Campo radial 2D → Volume; ou fachada C# em um Behavior. **Uso:** **Raio:** Raio da forma/volume selecionado; confira o tipo e os campos condicionais. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Shape

```csharp public Astra.Components.RadialField2D.ShapeOption Shape { get; set; } ``` Forma. Escala e orientação são as do objeto e de seus pais **Caminho:** Inspector → Campo radial 2D → Volume; ou fachada C# em um Behavior. **Uso:** **Forma:** Escala e orientação são as do objeto e de seus pais **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

TangentialAcceleration

```csharp public float TangentialAcceleration { get; set; } ``` Aceleração tangencial (m/s²) Faixa válida: -10000 a 10000. **Caminho:** Inspector → Campo radial 2D → Efeito; ou fachada C# em um Behavior. **Uso:** **Aceleração tangencial:** Aceleração tangencial em torno da origem. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

TypeId

```csharp public static string TypeId { get; } ``` **Caminho:** Inspector → Campo radial 2D; ou fachada C# em um Behavior. **Uso:** Identificador nativo usado em AddComponent/GetComponent. **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

WakeBodies

```csharp public bool WakeBodies { get; set; } ``` Acordar corpos. Desligado: corpos em repouso permanecem dormindo **Caminho:** Inspector → Campo radial 2D → Alcance; ou fachada C# em um Behavior. **Uso:** **Acordar corpos:** Desligado: corpos em repouso permanecem dormindo **Roadmap deste membro:** [Física 2D](/pt-br/snapshot-2026-10-06/roadmap/fisica-2d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.