---
title: "Astra.ShapeQuery"
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-shapequery/
---

# Astra.ShapeQuery

A forma varrida ou sobreposta por uma consulta.

**Namespace:** `Astra` · **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
struct Astra.ShapeQuery
```

A forma varrida ou sobreposta por uma consulta.

## Onde acessar este tipo

No Behavior, use **Physics**, Object.PhysicsBody(), Object.DynamicMotor() ou callbacks Collision/Trigger. Crie corpo/colisor antes; resultados de consulta não adicionam um corpo.

## Roadmap e uso

[Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/): 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/).

## Membros

| Membro | Categoria |
|---|---|
| [HalfExtent](#member-795ed8f6a0ddc616) | Field |
| [HalfHeight](#member-5b224e33243fc6af) | Field |
| [Kind](#member-40a96eb5d6728dcc) | Field |
| [Radius](#member-cbaa48df9f903378) | Field |
| [Rotation](#member-18a4493721ec62c4) | Field |
| [Box](#member-4298f25e35b3d988) | Method |
| [Capsule](#member-9ffe2eb827ae51e8) | Method |
| [Cylinder](#member-1e732eebb5f1afba) | Method |
| [Sphere](#member-b5d9f594f6cfa0b2) | Method |

<h3 id="member-795ed8f6a0ddc616" class="astra-member">HalfExtent</h3>

```csharp
public System.Numerics.Vector3 HalfExtent
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5b224e33243fc6af" class="astra-member">HalfHeight</h3>

```csharp
public float HalfHeight
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-40a96eb5d6728dcc" class="astra-member">Kind</h3>

```csharp
public Astra.QueryShapeKind Kind
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cbaa48df9f903378" class="astra-member">Radius</h3>

```csharp
public float Radius
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-18a4493721ec62c4" class="astra-member">Rotation</h3>

```csharp
public System.Numerics.Quaternion Rotation
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4298f25e35b3d988" class="astra-member">Box</h3>

```csharp
public static Astra.ShapeQuery Box(System.Numerics.Vector3 halfExtent, System.Numerics.Quaternion? rotation = null)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `halfExtent` | `System.Numerics.Vector3` |  |
| `rotation` | `System.Numerics.Quaternion?` |  · Opcional: `` |

<h3 id="member-9ffe2eb827ae51e8" class="astra-member">Capsule</h3>

```csharp
public static Astra.ShapeQuery Capsule(float radius, float halfHeight, System.Numerics.Quaternion? rotation = null)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `radius` | `float` |  |
| `halfHeight` | `float` |  |
| `rotation` | `System.Numerics.Quaternion?` |  · Opcional: `` |

<h3 id="member-1e732eebb5f1afba" class="astra-member">Cylinder</h3>

```csharp
public static Astra.ShapeQuery Cylinder(float radius, float halfHeight, System.Numerics.Quaternion? rotation = null)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `radius` | `float` |  |
| `halfHeight` | `float` |  |
| `rotation` | `System.Numerics.Quaternion?` |  · Opcional: `` |

<h3 id="member-b5d9f594f6cfa0b2" class="astra-member">Sphere</h3>

```csharp
public static Astra.ShapeQuery Sphere(float radius)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Física 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `radius` | `float` |  |