--- title: "Astra.Components.DragField2D" 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-dragfield2d/ --- # Astra.Components.DragField2D Campo de arrasto 2D: Amortecimento linear XY e angular de Body2D. 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.DragField2D ``` Campo de arrasto 2D: Amortecimento linear XY e angular de Body2D. 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 de arrasto 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 DragField2D(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 de arrasto 2D](/pt-br/snapshot-2026-10-07/componentes/astra-physics2d-field-drag/) para propriedades, valores iniciais, requisitos e edição em Play. ## Membros | Membro | Categoria | |---|---| | [.ctor](#member-ce91ea297c054854) | Method | | [Remove](#member-3e27043984145f30) | Method | | [Wrap](#member-4327d582c05e20bf) | Method | | [AffectedLayer](#member-4cf0af971e585905) | Property | | [AngularDrag](#member-f4918d1b0154314d) | Property | | [Component](#member-471012f7d886f372) | Property | | [Enabled](#member-f741a2d945636cf6) | Property | | [Falloff](#member-0ea7944c33c1897b) | Property | | [HalfExtents](#member-a4314a71c1af34f1) | Property | | [InstanceId](#member-b44586357d405bd2) | Property | | [IsAlive](#member-61537fe03656d878) | Property | | [LinearDrag](#member-a9605c2ee30308ec) | Property | | [Object](#member-f0ebe1f8286324f2) | Property | | [Offset](#member-343e2ea81ea736ed) | Property | | [Radius](#member-7143c00105ab217d) | Property | | [Shape](#member-0999fc596b4bea37) | Property | | [TypeId](#member-b85eb7e6ae91228d) | Property | | [WakeBodies](#member-1b8884686e5903c0) | Property |

.ctor

```csharp public DragField2D(Astra.Component component) ``` **Caminho:** Inspector → Campo de arrasto 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 de arrasto 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.DragField2D Wrap(Astra.Component component) ``` **Caminho:** Inspector → Campo de arrasto 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` | |

AffectedLayer

```csharp public Astra.Components.DragField2D.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 de arrasto 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.

AngularDrag

```csharp public float AngularDrag { get; set; } ``` Arrasto angular (1/s) Faixa válida: 0 a 1000. **Caminho:** Inspector → Campo de arrasto 2D → Efeito; ou fachada C# em um Behavior. **Uso:** **Arrasto angular:** Arrasto angular aplicado pelo 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.

Component

```csharp public Astra.Component Component { get; } ``` **Caminho:** Inspector → Campo de arrasto 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 de arrasto 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.DragField2D.FalloffOption Falloff { get; set; } ``` Queda de influência. Centro vale 1; Linear e Suave chegam a zero na borda **Caminho:** Inspector → Campo de arrasto 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 de arrasto 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 de arrasto 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 de arrasto 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.

LinearDrag

```csharp public float LinearDrag { get; set; } ``` Arrasto linear (1/s) Faixa válida: 0 a 1000. **Caminho:** Inspector → Campo de arrasto 2D → Efeito; ou fachada C# em um Behavior. **Uso:** **Arrasto linear:** Arrasto linear aplicado pelo 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.

Object

```csharp public Astra.GameObject Object { get; } ``` **Caminho:** Inspector → Campo de arrasto 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 de arrasto 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 de arrasto 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.DragField2D.ShapeOption Shape { get; set; } ``` Forma. Escala e orientação são as do objeto e de seus pais **Caminho:** Inspector → Campo de arrasto 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.

TypeId

```csharp public static string TypeId { get; } ``` **Caminho:** Inspector → Campo de arrasto 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 de arrasto 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.