PhysicsShapeQueryParameters3D

继承： RefCounted < Object

为 PhysicsDirectSpaceState3D 的方法提供参数。

描述

可以通过修改这个对象的形状等属性来为 PhysicsDirectSpaceState3D 的方法配置参数。

属性

bool	collide_with_areas	false
bool	collide_with_bodies	true
int	collision_mask	4294967295
Array[RID]	exclude	[]
float	margin	0.0
Vector3	motion	Vector3(0, 0, 0)
Resource	shape
RID	shape_rid	RID()
Transform3D	transform	Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0)

---

属性说明

bool collide_with_areas = false 🔗

• void set_collide_with_areas(value: bool)

• bool is_collide_with_areas_enabled()

如果为 true，则查询将考虑 Area3D。

---

bool collide_with_bodies = true 🔗

• void set_collide_with_bodies(value: bool)

• bool is_collide_with_bodies_enabled()

如果为 true，则查询将考虑 PhysicsBody3D。

---

int collision_mask = 4294967295 🔗

• void set_collision_mask(value: int)

• int get_collision_mask()

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

---

Array[RID] exclude = [] 🔗

• void set_exclude(value: Array[RID])

• Array[RID] get_exclude()

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

注意：返回的数组为副本，对其进行的修改不会更新原有属性。更新时，请先修改返回的数组，然后将其重新赋值回该属性。

---

float margin = 0.0 🔗

• void set_margin(value: float)

• float get_margin()

形状的碰撞边距。

---

Vector3 motion = Vector3(0, 0, 0) 🔗

• void set_motion(value: Vector3)

• Vector3 get_motion()

正在查询的形状的运动。

---

Resource shape 🔗

• void set_shape(value: Resource)

• Resource get_shape()

将用于碰撞/相交查询的 Shape3D。存储的是实际的引用，可以避免该形状在进行查询时被释放，因此请优先使用这个属性，而不是 shape_rid。

---

RID shape_rid = RID() 🔗

• void set_shape_rid(value: RID)

• RID get_shape_rid()

将用于碰撞/相交查询的形状的 RID。如果你想要使用服务器 API 优化性能，请使用这个属性而不是 shape：

GDScriptC#

var shape_rid = PhysicsServer3D.sphere_shape_create()
var radius = 2.0
PhysicsServer3D.shape_set_data(shape_rid, radius)

var params = PhysicsShapeQueryParameters3D.new()
params.shape_rid = shape_rid

# 在此处执行物理查询...

# 完成物理查询后释放形状。
PhysicsServer3D.free_rid(shape_rid)

---

Transform3D transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0) 🔗

• void set_transform(value: Transform3D)

• Transform3D get_transform()

被查询形状的变换矩阵。