Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

PhysicsShapeQueryParameters2D

繼承： RefCounted < Object

Provides parameters for PhysicsDirectSpaceState2D's methods.

說明

By changing various properties of this object, such as the shape, you can configure the parameters for PhysicsDirectSpaceState2D's methods.

屬性

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

---

屬性說明

bool collide_with_areas = false 🔗

• void set_collide_with_areas(value: bool)

• bool is_collide_with_areas_enabled()

如果為 true，查詢將考慮 Area2D。

---

bool collide_with_bodies = true 🔗

• void set_collide_with_bodies(value: bool)

• bool is_collide_with_bodies_enabled()

如果為 true，查詢將考慮 PhysicsBody2D。

---

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()

The list of object RIDs that will be excluded from collisions. Use CollisionObject2D.get_rid() to get the RID associated with a CollisionObject2D-derived node.

Note: The returned array is copied and any changes to it will not update the original property value. To update the value you need to modify the returned array, and then assign it to the property again.

---

float margin = 0.0 🔗

• void set_margin(value: float)

• float get_margin()

形狀的碰撞邊距。

---

Vector2 motion = Vector2(0, 0) 🔗

• void set_motion(value: Vector2)

• Vector2 get_motion()

正在查詢的形狀的運動。

---

Resource shape 🔗

• void set_shape(value: Resource)

• Resource get_shape()

將用於碰撞/相交查詢的 Shape2D。儲存的是實際的引用，可以避免該形狀在進行查詢時被釋放，因此請優先使用這個屬性，而不是 shape_rid。

---

RID shape_rid = RID() 🔗

• void set_shape_rid(value: RID)

• RID get_shape_rid()

將用於碰撞/相交查詢的形狀的 RID。如果你想要使用伺服器 API 優化性能，請使用這個屬性而不是 shape：

GDScriptC#

var shape_rid = PhysicsServer2D.circle_shape_create()
var radius = 64
PhysicsServer2D.shape_set_data(shape_rid, radius)

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

# 在此處執行物理查詢...

# 完成物理查詢後釋放形狀。
PhysicsServer2D.free_rid(shape_rid)

---

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

• void set_transform(value: Transform2D)

• Transform2D get_transform()

被查詢形狀的變換矩陣。