Class reference
PhysicsTestMotionParameters2D
Inherits RefCounted
Provides parameters for PhysicsServer2D.body_test_motion().
Description
By changing various properties of this object, such as the motion, you can configure the parameters for PhysicsServer2D.body_test_motion().
Properties
bool collide_separation_ray = false
bool collide_separation_ray = falseIf set to true, shapes of type PhysicsServer2D.SHAPE_SEPARATION_RAY are used to detect collisions and can stop the motion. Can be useful when snapping to the ground. If set to false, shapes of type PhysicsServer2D.SHAPE_SEPARATION_RAY are only used for separation when overlapping with other bodies. That's the main use for separation ray shapes.
RID[] exclude_bodies = []
Optional array of body RID to exclude from collision. Use CollisionObject2D.get_rid() to get the RID associated with a CollisionObject2D-derived node.
int[] exclude_objects = []
Optional array of object unique instance ID to exclude from collision. See Object.get_instance_id().
Transform2D from = Transform2D(1, 0, 0, 1, 0, 0)
Transform2D from = Transform2D(1, 0, 0, 1, 0, 0)Transform in global space where the motion should start. Usually set to Node2D.global_transform for the current body's transform.
float margin = 0.08
float margin = 0.08Increases the size of the shapes involved in the collision detection.
Vector2 motion = Vector2(0, 0)
Vector2 motion = Vector2(0, 0)Motion vector to define the length and direction of the motion to test.
bool recovery_as_collision = false
bool recovery_as_collision = falseIf set to true, any depenetration from the recovery phase is reported as a collision; this is used e.g. by CharacterBody2D for improving floor detection during floor snapping. If set to false, only collisions resulting from the motion are reported, which is generally the desired behavior.