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.

属性

方法

PhysicsRayQueryParameters3Dcreate ( from: Vector3, to: Vector3, collision_mask: int = 4294967295, exclude: Array RID = [] ) static1

属性说明

bool collide_with_areas = false

  • void set_collide_with_areas ( value: bool )
  • bool is_collide_with_areas_enabled ( )

If true, the query will take Area3D s into account.


bool collide_with_bodies = true

  • void set_collide_with_bodies ( value: bool )
  • bool is_collide_with_bodies_enabled ( )

If true, the query will take PhysicsBody3D s into account.


int collision_mask = 4294967295

  • void set_collision_mask ( value: int )
  • int get_collision_mask ( )

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.


Array RID exclude = []

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

  • void set_hit_back_faces ( value: bool )
  • bool is_hit_back_faces_enabled ( )

If true, the query will hit back faces with concave polygon shapes with back face enabled or heightmap shapes.


bool hit_from_inside = false

  • void set_hit_from_inside ( value: bool )
  • bool is_hit_from_inside_enabled ( )

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

本方法通常需要用户覆盖才能生效。

3

本方法无副作用,不会修改该实例的任何成员变量。

4

本方法除了能接受在此处描述的参数外,还能够继续接受任意数量的参数。

5

本方法用于构造某个类型。

1

调用本方法无需实例,可直接使用类名进行调用。

6

本方法描述的是使用本类型作为左操作数的有效运算符。

7

这个值是由下列位标志构成位掩码的整数。

8

无返回值。