Astra.PhysicsAccess

Astra 0.2.3-preview.20261007Referência de assinaturasReferência revisada · 07 out. 2026

As consultas físicas vistas pelo projeto. Resolvidas contra o mundo de execução: um objeto destruído nunca aparece em um resultado, e a identidade devolvida já carrega geração.

Namespace: Astra · Assembly: Astra.Scripting · Tipo: Struct

Declaração

readonly struct Astra.PhysicsAccess

As consultas físicas vistas pelo projeto. Resolvidas contra o mundo de execução: um objeto destruído nunca aparece em um resultado, e a identidade devolvida já carrega geração.

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: 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.

Membros

Membro	Categoria
.ctor	Method
LayerByName	Method
LayerMask	Method
LayerName	Method
Overlap	Method
RayCast	Method
RayCastAll	Method
ShapeCast	Method

.ctor

public PhysicsAccess(Astra.ISceneAccess scene)

As consultas físicas vistas pelo projeto. Resolvidas contra o mundo de execução: um objeto destruído nunca aparece em um resultado, e a identidade devolvida já carrega geração.

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

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
`scene`	`Astra.ISceneAccess`

LayerByName

public int LayerByName(string name)

Índice da camada de gameplay com esse nome, ou -1.

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

Uso: Índice da camada de gameplay com esse nome, ou -1.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
`name`	`string`

LayerMask

public uint LayerMask(params string[] names)

Máscara com apenas as camadas nomeadas informadas.

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

Uso: Máscara com apenas as camadas nomeadas informadas.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
`names`	`string[]`

LayerName

public string LayerName(int layer)

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
`layer`	`int`

Overlap

public System.Collections.Generic.IReadOnlyList<Astra.RayHit> Overlap(Astra.ShapeQuery shape, System.Numerics.Vector3 origin, out bool truncated, Astra.QueryFilter? filter = null, int capacity = 32)

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

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
`shape`	`Astra.ShapeQuery`
`origin`	`System.Numerics.Vector3`
`truncated`	`bool`	· Out
`filter`	`Astra.QueryFilter?`	· Opcional: ``
`capacity`	`int`	· Opcional: `32`

RayCast

public Astra.RayHit? RayCast(System.Numerics.Vector3 origin, System.Numerics.Vector3 direction, Astra.QueryFilter? filter = null)

O acerto mais próximo ao longo de direction, cujo comprimento é o alcance. Nulo quando nada foi acertado.

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

Uso: O acerto mais próximo ao longo de direction, cujo comprimento é o alcance. Nulo quando nada foi acertado.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
`origin`	`System.Numerics.Vector3`
`direction`	`System.Numerics.Vector3`
`filter`	`Astra.QueryFilter?`	· Opcional: ``

RayCastAll

public System.Collections.Generic.IReadOnlyList<Astra.RayHit> RayCastAll(System.Numerics.Vector3 origin, System.Numerics.Vector3 direction, out bool truncated, Astra.QueryFilter? filter = null, int capacity = 32)

Todos os acertos, do mais próximo ao mais distante. Devolve a lista efetivamente copiada; truncated diz se havia mais acertos do que o buffer comportava.

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

Uso: Todos os acertos, do mais próximo ao mais distante. Devolve a lista efetivamente copiada; truncated diz se havia mais acertos do que o buffer comportava.

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
`origin`	`System.Numerics.Vector3`
`direction`	`System.Numerics.Vector3`
`truncated`	`bool`	· Out
`filter`	`Astra.QueryFilter?`	· Opcional: ``
`capacity`	`int`	· Opcional: `32`

ShapeCast

public Astra.RayHit? ShapeCast(Astra.ShapeQuery shape, System.Numerics.Vector3 origin, System.Numerics.Vector3 direction, Astra.QueryFilter? filter = null)

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

Roadmap deste membro: Física 3D e motores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
`shape`	`Astra.ShapeQuery`
`origin`	`System.Numerics.Vector3`
`direction`	`System.Numerics.Vector3`
`filter`	`Astra.QueryFilter?`	· Opcional: ``