PhysicsRayQueryParameters3D
继承: RefCounted
< Object
Provides parameters for PhysicsDirectSpaceState3D.intersect_ray
.
描述
By changing various properties of this object, such as the ray position, you can configure the parameters for PhysicsDirectSpaceState3D.intersect_ray
.
属性
bool | collide_with_areas |
bool | collide_with_bodies |
int | collision_mask |
Array RID | exclude |
Vector3 | from |
bool | hit_back_faces |
bool | hit_from_inside |
Vector3 | to |
方法
PhysicsRayQueryParameters3D | create ( from: Vector3 , to: Vector3 , collision_mask: int = 4294967295, exclude: Array RID = [] ) static1 |
属性说明
bool
collide_with_areas = false
If true
, the query will take Area3D
s into account.
bool
collide_with_bodies = true
If true
, the query will take PhysicsBody3D
s into account.
int
collision_mask = 4294967295
The physics layers the query will detect (as a bitmask). By default, all collision layers are detected. See Collision layers and masks in the documentation for more information.
The list of object RID
s that will be excluded from collisions. Use CollisionObject3D.get_rid
to get the RID
associated with a CollisionObject3D
-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.
Vector3
from = Vector3(0, 0, 0)
The starting point of the ray being queried for, in global coordinates.
bool
hit_back_faces = true
If true
, the query will hit back faces with concave polygon shapes with back face enabled or heightmap shapes.
bool
hit_from_inside = false
If true
, the query will detect a hit when starting inside shapes. In this case the collision normal will be Vector3(0, 0, 0)
. Does not affect concave polygon shapes or heightmap shapes.
Vector3
to = Vector3(0, 0, 0)
The ending point of the ray being queried for, in global coordinates.
方法说明
PhysicsRayQueryParameters3D
create ( from: Vector3
, to: Vector3
, collision_mask: int
= 4294967295, exclude: Array RID
= [] ) static1
Returns a new, pre-configured PhysicsRayQueryParameters3D object. Use it to quickly create query parameters using the most common options.
var query = PhysicsRayQueryParameters3D.create(position, position + Vector3(0, -10, 0))
var collision = get_world_3d().direct_space_state.intersect_ray(query)
本方法通常需要用户覆盖才能生效。
本方法无副作用,不会修改该实例的任何成员变量。
本方法除了能接受在此处描述的参数外,还能够继续接受任意数量的参数。
本方法用于构造某个类型。
调用本方法无需实例,可直接使用类名进行调用。
本方法描述的是使用本类型作为左操作数的有效运算符。
这个值是由下列位标志构成位掩码的整数。
无返回值。