Pular para o conteúdo
AstraDOCS

Astra.PhysicsFieldRuntime

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

Queries share the exact evaluator used by the native solver. Removed components and expired worlds are rejected; disabled fields can be inspected but return zero influence. Counts include dynamic bodies eligible now, respecting layer and WakeBodies. Queries require a running physics session.

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

readonly struct Astra.PhysicsFieldRuntime

Queries share the exact evaluator used by the native solver. Removed components and expired worlds are rejected; disabled fields can be inspected but return zero influence. Counts include dynamic bodies eligible now, respecting layer and WakeBodies. Queries require a running physics session.

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

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.

Membro Categoria
Contains Method
Sample Method
TrySample Method
AffectedBodyCount Property
AffectedMass Property

Contains

public bool Contains(System.Numerics.Vector3 worldPoint)

Geometric containment, independent of Enabled and layer filters.

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

Uso: Geometric containment, independent of Enabled and layer filters.

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

Parâmetro Tipo Contrato
worldPoint System.Numerics.Vector3

Sample

public Astra.PhysicsFieldSample Sample(System.Numerics.Vector3 worldPoint, uint layer = 0)

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
worldPoint System.Numerics.Vector3
layer uint · Opcional: 0

TrySample

public bool TrySample(System.Numerics.Vector3 worldPoint, uint layer, out Astra.PhysicsFieldSample sample)

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
worldPoint System.Numerics.Vector3
layer uint
sample Astra.PhysicsFieldSample · Out

AffectedBodyCount

public uint AffectedBodyCount { get; }

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

Uso: Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

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

AffectedMass

public float AffectedMass { get; }

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

Uso: Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

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