Pular para o conteúdo
AstraDOCS

Astra.RayHit

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

Um acerto já resolvido: objeto vivo, instância do colisor que respondeu e contato. P:Astra.RayHit.Normal é nulo quando o backend não tem uma normal para oferecer — uma sobreposição parada não tem direção ao longo de quê, e um vetor zero no lugar pareceria um contato de frente.

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

readonly record struct Astra.RayHit

Um acerto já resolvido: objeto vivo, instância do colisor que respondeu e contato. P:Astra.RayHit.Normal é nulo quando o backend não tem uma normal para oferecer — uma sobreposição parada não tem direção ao longo de quê, e um vetor zero no lugar pareceria um contato de frente.

Interfaces: System.IEquatable<Astra.RayHit>.

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
.ctor Method
BodyObject Property
Collider Property
ColliderInstance Property
ColliderObject Property
Distance Property
Fraction Property
IsSensor Property
Normal Property
Object Property
Point Property

.ctor

public RayHit(Astra.GameObject Object, ulong ColliderInstance, System.Numerics.Vector3 Point, System.Numerics.Vector3? Normal, float Distance, float Fraction, bool IsSensor)

Um acerto já resolvido: objeto vivo, instância do colisor que respondeu e contato. P:Astra.RayHit.Normal é nulo quando o backend não tem uma normal para oferecer — uma sobreposição parada não tem direção ao longo de quê, e um vetor zero no lugar pareceria um contato de frente.

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
Object Astra.GameObject
ColliderInstance ulong
Point System.Numerics.Vector3
Normal System.Numerics.Vector3?
Distance float
Fraction float
IsSensor bool

BodyObject

public Astra.GameObject BodyObject { get; }

The Body owner, retained by Object for source compatibility.

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

Uso: The Body owner, retained by Object for source compatibility.

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

Collider

public Astra.Components.Collider? Collider { get; }

Resolve this exact 3D Collider, never another local instance on the Body. Null after removal, object destruction or world expiration.

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

Uso: Resolve this exact 3D Collider, never another local instance on the Body. Null after removal, object destruction or world expiration.

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

ColliderInstance

public ulong ColliderInstance { get; init; }

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.

ColliderObject

public Astra.GameObject? ColliderObject { get; init; }

The authored Collider owner; null when the backend has no shape identity.

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

Uso: The authored Collider owner; null when the backend has no shape identity.

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

Distance

public float Distance { get; init; }

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.

Fraction

public float Fraction { get; init; }

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.

IsSensor

public bool IsSensor { get; init; }

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.

Normal

public System.Numerics.Vector3? Normal { get; init; }

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.

Object

public Astra.GameObject Object { get; init; }

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.

Point

public System.Numerics.Vector3 Point { get; init; }

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.