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...

PhysicsTestMotionParameters2D

Inherits: RefCounted < Object

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

RID[]

exclude_bodies

[]

int[]

exclude_objects

[]

Transform2D

from

Transform2D(1, 0, 0, 1, 0, 0)

float

margin

0.08

Vector2

motion

Vector2(0, 0)

bool

recovery_as_collision

false

Property Descriptions

bool collide_separation_ray = false

  • void set_collide_separation_ray_enabled ( bool value )

  • bool is_collide_separation_ray_enabled ( )

If 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 = []

  • void set_exclude_bodies ( RID[] value )

  • RID[] get_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 = []

  • void set_exclude_objects ( int[] value )

  • int[] get_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)

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

  • void set_margin ( float value )

  • float get_margin ( )

Increases the size of the shapes involved in the collision detection.

Vector2 motion = Vector2(0, 0)