Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

PhysicsRayQueryParameters2D¶

为 PhysicsDirectSpaceState2D.intersect_ray 提供参数。

描述¶

通过修改这个对象的射线位置等属性，你可以为 PhysicsDirectSpaceState2D.intersect_ray 配置参数。

属性¶

bool	collide_with_areas	`false`
bool	collide_with_bodies	`true`
int	collision_mask	`4294967295`
RID[]	exclude	`[]`
Vector2	from	`Vector2(0, 0)`
bool	hit_from_inside	`false`
Vector2	to	`Vector2(0, 0)`

方法¶

PhysicsRayQueryParameters2D

create ( Vector2 from, Vector2 to, int collision_mask=4294967295, RID[] exclude=[] ) static

属性说明¶

bool collide_with_areas = false

void set_collide_with_areas ( bool value )
bool is_collide_with_areas_enabled ( )

如果为 true，查询将考虑 Area2D。

bool collide_with_bodies = true

void set_collide_with_bodies ( bool value )
bool is_collide_with_bodies_enabled ( )

如果为 true，查询将考虑 PhysicsBody2D。

int collision_mask = 4294967295

void set_collision_mask ( int value )
int get_collision_mask ( )

查询将检测的物理层（作为位掩码）。默认情况下，会检测所有碰撞层。有关详细信息，请参阅文档中的《碰撞层和掩码》。

RID[] exclude = []

void set_exclude ( RID[] value )
RID[] get_exclude ( )

将被排除在碰撞之外的对象的 RID 列表。请使用 CollisionObject2D.get_rid 来获取与派生自 CollisionObject2D 的节点关联的 RID。

Vector2 from = Vector2(0, 0)

void set_from ( Vector2 value )
Vector2 get_from ( )

要查询的射线起点，使用全局坐标。

bool hit_from_inside = false

void set_hit_from_inside ( bool value )
bool is_hit_from_inside_enabled ( )

如果为 true，查询会在从形状内部开始时检测到命中。在此情况下，碰撞法线将为 Vector2(0, 0)。不会影响凹多边形形状。

Vector2 to = Vector2(0, 0)

void set_to ( Vector2 value )
Vector2 get_to ( )

要查询的射线终点，使用全局坐标。

方法说明¶

PhysicsRayQueryParameters2D create ( Vector2 from, Vector2 to, int collision_mask=4294967295, RID[] exclude=[] ) static

返回一个新的、预配置的 PhysicsRayQueryParameters2D 对象。使用它可以使用最常见的选项来快速创建查询参数。

var query = PhysicsRayQueryParameters2D.create(global_position, global_position + Vector2(0, 100))
var collision = get_world_2d().direct_space_state.intersect_ray(query)