--- title: "Astra.Components.ShapeCast" 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-shapecast/ --- # Astra.Components.ShapeCast Varredura de forma: Varre uma forma até o alvo e guarda o primeiro acerto. Família Física 3D · Consultas. **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.ShapeCast ``` Varredura de forma: Varre uma forma até o alvo e guarda o primeiro acerto. Família Física 3D · Consultas. Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_shapecast3d.html **Interfaces:** `Astra.Components.IComponentFacade`. ## Onde acessar este tipo Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Física 3D** / **Consultas** → **Varredura de forma**. 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 ShapeCast(component)` envolve um componente existente; não adiciona um componente à cena. ## 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/). Consulte também [Varredura de forma](/pt-br/snapshot-2026-10-07/componentes/astra-physics-shapecast/) para propriedades, valores iniciais, requisitos e edição em Play. ## Membros | Membro | Categoria | |---|---| | [.ctor](#member-3231fc1a588935b8) | Method | | [Collider](#member-55b2dd3ced43d9e2) | Method | | [Colliding](#member-e4a9c232c30e9bda) | Method | | [Distance](#member-3bbc7d98ae676d40) | Method | | [Normal](#member-ac7c5b76784a9cb1) | Method | | [Point](#member-4e511f84ab0b85bb) | Method | | [Remove](#member-4ceffc77c10bf45a) | Method | | [Update](#member-5b8556f3177651aa) | Method | | [Wrap](#member-b6f23c0392c2c614) | Method | | [Component](#member-a0b52291187dc762) | Property | | [Enabled](#member-b12f508f835a326f) | Property | | [ExcludeSelf](#member-79e4dc95d0de91fb) | Property | | [HalfExtents](#member-71a81ec2b67113d0) | Property | | [HalfHeight](#member-6051b1e8f2ddb11c) | Property | | [IncludeDynamic](#member-21592eaba7bed240) | Property | | [IncludeSensors](#member-323e0a998183f001) | Property | | [IncludeStatic](#member-ebb88bac7d84660d) | Property | | [InstanceId](#member-05c5c93ac1280127) | Property | | [IsAlive](#member-4823b30a69c648e2) | Property | | [Layer](#member-1710bb8dc0984ef9) | Property | | [Object](#member-4571e8a05d4c8037) | Property | | [Radius](#member-ac3666a529fb4717) | Property | | [Shape](#member-a7b491906b40c424) | Property | | [Target](#member-456fb52166b996b9) | Property | | [TypeId](#member-783d8dc3be92fa00) | Property |

.ctor

```csharp public ShapeCast(Astra.Component component) ``` **Caminho:** Inspector → Varredura de forma; 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 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 | |---|---|---| | `component` | `Astra.Component` | |

Collider

```csharp public Astra.ObjectReference Collider() ``` Objeto atingido. Dono do corpo atingido; vazio sem acerto Executado no mundo de Play; fora dele lança WorldException NotRunning. **Caminho:** Inspector → Varredura de forma; ou fachada C# em um Behavior. **Uso:** Objeto atingido. Dono do corpo atingido; vazio sem acerto **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.

Colliding

```csharp public bool Colliding() ``` Acertando. Verdadeiro quando a última consulta encontrou algo Executado no mundo de Play; fora dele lança WorldException NotRunning. **Caminho:** Inspector → Varredura de forma; ou fachada C# em um Behavior. **Uso:** Acertando. Verdadeiro quando a última consulta encontrou algo **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.

Distance

```csharp public double Distance() ``` Distância. Distância do acerto ao início, em metros Executado no mundo de Play; fora dele lança WorldException NotRunning. **Caminho:** Inspector → Varredura de forma; ou fachada C# em um Behavior. **Uso:** Distância. Distância do acerto ao início, em metros **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.

Normal

```csharp public System.Numerics.Vector3 Normal() ``` Normal. Normal da superfície atingida Executado no mundo de Play; fora dele lança WorldException NotRunning. **Caminho:** Inspector → Varredura de forma; ou fachada C# em um Behavior. **Uso:** Normal. Normal da superfície atingida **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.

Point

```csharp public System.Numerics.Vector3 Point() ``` Ponto. Ponto do acerto no mundo Executado no mundo de Play; fora dele lança WorldException NotRunning. **Caminho:** Inspector → Varredura de forma; ou fachada C# em um Behavior. **Uso:** Ponto. Ponto do acerto no mundo **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.

Remove

```csharp public void Remove() ``` Remove a instância pelo ciclo nativo; dependências e ownership podem recusar. **Caminho:** Inspector → Varredura de forma; 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 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Update

```csharp public void Update() ``` Atualizar agora. Refaz a consulta neste instante (force_raycast_update do Godot) Executado no mundo de Play; fora dele lança WorldException NotRunning. **Caminho:** Inspector → Varredura de forma; ou fachada C# em um Behavior. **Uso:** Atualizar agora. Refaz a consulta neste instante (force_raycast_update do Godot) **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.

Wrap

```csharp public static Astra.Components.ShapeCast Wrap(Astra.Component component) ``` **Caminho:** Inspector → Varredura de forma; ou fachada C# em um Behavior. **Uso:** Envolve um Component existente após conferir TypeId; não cria componente. **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 | |---|---|---| | `component` | `Astra.Component` | |

Component

```csharp public Astra.Component Component { get; } ``` **Caminho:** Inspector → Varredura de forma; 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 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Enabled

```csharp public bool Enabled { get; set; } ``` Ativo. Desligado não consulta e mantém o último resultado como vazio **Caminho:** Inspector → Varredura de forma → Consulta; ou fachada C# em um Behavior. **Uso:** **Ativo:** Desligado não consulta e mantém o último resultado como vazio **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.

ExcludeSelf

```csharp public bool ExcludeSelf { get; set; } ``` Ignorar o próprio corpo. Ignora o corpo deste objeto ou do ancestral mais próximo com Corpo físico **Caminho:** Inspector → Varredura de forma → Filtro; ou fachada C# em um Behavior. **Uso:** **Ignorar o próprio corpo:** Exclui o primeiro Corpo físico encontrado neste objeto ou subindo por seus ancestrais. Use para não atingir o jogador que sustenta a consulta; sem esse corpo ancestral, não há exclusão automática de todos os colliders do ramo. **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.

HalfExtents

```csharp public System.Numerics.Vector3 HalfExtents { get; set; } ``` Meia extensão **Caminho:** Inspector → Varredura de forma → Forma; 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. **Meia extensão Z:** Meia extensão da caixa neste eixo, em metros. Uma extensão .5 representa tamanho total 1 nesse eixo. **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.

HalfHeight

```csharp public float HalfHeight { get; set; } ``` Meia altura (m) Faixa válida: 0.001 a 1000. **Caminho:** Inspector → Varredura de forma → Forma; ou fachada C# em um Behavior. **Uso:** **Meia altura:** Meia altura do volume em metros, para cápsula/cilindro conforme Forma. Não é a altura inteira de um modelo. **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.

IncludeDynamic

```csharp public bool IncludeDynamic { get; set; } ``` Incluir dinâmicos **Caminho:** Inspector → Varredura de forma → Filtro; ou fachada C# em um Behavior. **Uso:** **Incluir dinâmicos:** Inclui corpos dinâmicos no resultado; não aplica força nem impede movimento por conta própria. **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.

IncludeSensors

```csharp public bool IncludeSensors { get; set; } ``` Incluir sensores. Sensores ficam de fora por padrão (collide_with_areas do Godot) **Caminho:** Inspector → Varredura de forma → Filtro; ou fachada C# em um Behavior. **Uso:** **Incluir sensores:** Inclui formas sensoras no resultado. Desligado evita tratar volumes de trigger como paredes. **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.

IncludeStatic

```csharp public bool IncludeStatic { get; set; } ``` Incluir estáticos **Caminho:** Inspector → Varredura de forma → Filtro; ou fachada C# em um Behavior. **Uso:** **Incluir estáticos:** Inclui corpos estáticos, como chão e paredes. Desligar pode explicar ausência de acerto. **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.

InstanceId

```csharp public ulong InstanceId { get; } ``` **Caminho:** Inspector → Varredura de forma; ou fachada C# em um Behavior. **Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos. **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.

IsAlive

```csharp public bool IsAlive { get; } ``` **Caminho:** Inspector → Varredura de forma; 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 3D e motores](/pt-br/snapshot-2026-10-06/roadmap/fisica-3d/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Layer

```csharp public Astra.Components.ShapeCast.LayerOption Layer { get; set; } ``` Camada. Todas ou só uma camada física do projeto **Caminho:** Inspector → Varredura de forma → Filtro; ou fachada C# em um Behavior. **Uso:** **Camada:** Todas aceita camadas do projeto; escolher uma limita a consulta. A camada da malha visual não cria forma física. **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.

Object

```csharp public Astra.GameObject Object { get; } ``` **Caminho:** Inspector → Varredura de forma; ou fachada C# em um Behavior. **Uso:** Objeto dono deste componente; use para resolver composiçã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.

Radius

```csharp public float Radius { get; set; } ``` Raio (m) Faixa válida: 0.001 a 1000. **Caminho:** Inspector → Varredura de forma → Forma; ou fachada C# em um Behavior. **Uso:** **Raio:** Raio em metros da esfera/cápsula, visível conforme Forma. Não é comprimento do segmento. **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.

Shape

```csharp public Astra.Components.ShapeCast.ShapeOption Shape { get; set; } ``` Forma **Caminho:** Inspector → Varredura de forma → Forma; ou fachada C# em um Behavior. **Uso:** **Forma:** Escolhe Esfera, Caixa, Cápsula ou Cilindro para a varredura. Configure somente as dimensões relevantes da forma; isso não cria um collider persistente. **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.

Target

```csharp public System.Numerics.Vector3 Target { get; set; } ``` Alvo local **Caminho:** Inspector → Varredura de forma → Consulta; ou fachada C# em um Behavior. **Uso:** **Alvo X:** Componente do vetor local do segmento em metros. Seu módulo define alcance; girar o objeto gira a direção em mundo. Não é uma posição absoluta do alvo. **Alvo Y:** Componente do vetor local do segmento em metros. Seu módulo define alcance; girar o objeto gira a direção em mundo. Não é uma posição absoluta do alvo. **Alvo Z:** Componente do vetor local do segmento em metros. Seu módulo define alcance; girar o objeto gira a direção em mundo. Não é uma posição absoluta do alvo. **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.

TypeId

```csharp public static string TypeId { get; } ``` **Caminho:** Inspector → Varredura de forma; ou fachada C# em um Behavior. **Uso:** Identificador nativo usado em AddComponent/GetComponent. **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.