Astra.PhysicsAccess

Astra atual · C# · 06 out. 2026Referência de assinaturas

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.

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.

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

LayerByName

public int LayerByName(string name)

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

Parâmetro	Tipo	Contrato
`name`	`string`

LayerMask

public uint LayerMask(params string[] names)

Máscara com apenas as camadas nomeadas informadas.

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

LayerName

public string LayerName(int layer)

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)

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.

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.

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)

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