Astra.QueryFilter

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

Como a consulta escolhe o que pode acertar.

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

Declaração

struct Astra.QueryFilter

Como a consulta escolhe o que pode acertar.

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
Ignore	Field
IncludeDynamic	Field
IncludeSensors	Field
IncludeStatic	Field
LayerMask	Field
Ignoring	Method
OnlyLayers	Method
Default	Property

Ignore

public ulong Ignore

Objeto que não deve ser acertado — normalmente quem consulta.

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

Uso: Objeto que não deve ser acertado — normalmente quem consulta.

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

IncludeDynamic

public bool IncludeDynamic

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

Uso: Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

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

IncludeSensors

public bool IncludeSensors

Falso por padrão: um raio de visada que parasse na zona de detecção invisível do próprio jogo seria um erro difícil de enxergar.

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

Uso: Falso por padrão: um raio de visada que parasse na zona de detecção invisível do próprio jogo seria um erro difícil de enxergar.

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

IncludeStatic

public bool IncludeStatic

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

Uso: Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

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

LayerMask

public uint LayerMask

Bit por camada de gameplay (0..31).

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

Uso: Bit por camada de gameplay (0..31).

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

Ignoring

public Astra.QueryFilter Ignoring(Astra.GameObject self)

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
`self`	`Astra.GameObject`

OnlyLayers

public Astra.QueryFilter OnlyLayers(params int[] layers)

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
`layers`	`int[]`

Default

public static Astra.QueryFilter Default { 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.