2017-09-12 20:42:36 +00:00
<?xml version="1.0" encoding="UTF-8" ?>
2021-06-04 16:03:15 +00:00
<class name= "KinematicCollision3D" inherits= "RefCounted" version= "4.0" >
2017-09-12 20:42:36 +00:00
<brief_description >
2021-05-20 01:14:33 +00:00
Collision data for [method PhysicsBody3D.move_and_collide] collisions.
2017-09-12 20:42:36 +00:00
</brief_description>
<description >
2021-05-20 01:14:33 +00:00
Contains collision data for [method PhysicsBody3D.move_and_collide] collisions. When a [PhysicsBody3D] is moved using [method PhysicsBody3D.move_and_collide], it stops if it detects a collision with another body. If a collision is detected, a [KinematicCollision3D] object is returned.
2017-09-17 04:56:03 +00:00
This object contains information about the collision, including the colliding object, the remaining motion, and the collision position. This information can be used to calculate a collision response.
2017-09-12 20:42:36 +00:00
</description>
<tutorials >
</tutorials>
<methods >
2021-08-12 22:41:40 +00:00
<method name= "get_angle" qualifiers= "const" >
<return type= "float" />
2021-08-30 18:49:09 +00:00
<argument index= "0" name= "collision_index" type= "int" default= "0" />
<argument index= "1" name= "up_direction" type= "Vector3" default= "Vector3(0, 1, 0)" />
2021-08-12 22:41:40 +00:00
<description >
The collision angle according to [code]up_direction[/code], which is [code]Vector3.UP[/code] by default. This value is always positive.
</description>
</method>
2021-08-30 18:49:09 +00:00
<method name= "get_collider" qualifiers= "const" >
<return type= "Object" />
<argument index= "0" name= "collision_index" type= "int" default= "0" />
<description >
Returns the collider by index (the latest by default).
</description>
</method>
<method name= "get_collider_id" qualifiers= "const" >
<return type= "int" />
<argument index= "0" name= "collision_index" type= "int" default= "0" />
<description >
Returns the collider ID by index (the latest by default).
</description>
</method>
<method name= "get_collider_metadata" qualifiers= "const" >
<return type= "Variant" />
<argument index= "0" name= "collision_index" type= "int" default= "0" />
<description >
Returns the collider metadata by index (the latest by default).
</description>
</method>
<method name= "get_collider_rid" qualifiers= "const" >
<return type= "RID" />
<argument index= "0" name= "collision_index" type= "int" default= "0" />
<description >
Returns the collider RID by index (the latest by default).
</description>
</method>
<method name= "get_collider_shape" qualifiers= "const" >
<return type= "Object" />
<argument index= "0" name= "collision_index" type= "int" default= "0" />
<description >
Returns the collider shape by index (the latest by default).
</description>
</method>
<method name= "get_collider_shape_index" qualifiers= "const" >
<return type= "int" />
<argument index= "0" name= "collision_index" type= "int" default= "0" />
<description >
Returns the collider shape index by index (the latest by default).
</description>
</method>
<method name= "get_collider_velocity" qualifiers= "const" >
<return type= "Vector3" />
<argument index= "0" name= "collision_index" type= "int" default= "0" />
<description >
Returns the collider velocity by index (the latest by default).
</description>
</method>
<method name= "get_local_shape" qualifiers= "const" >
<return type= "Object" />
<argument index= "0" name= "collision_index" type= "int" default= "0" />
<description >
Returns the collider velocity by index (the latest by default).
</description>
</method>
<method name= "get_normal" qualifiers= "const" >
<return type= "Vector3" />
<argument index= "0" name= "collision_index" type= "int" default= "0" />
<description >
Returns the collider normal by index (the latest by default).
</description>
</method>
<method name= "get_position" qualifiers= "const" >
<return type= "Vector3" />
<argument index= "0" name= "collision_index" type= "int" default= "0" />
<description >
Returns the collider collision point by index (the latest by default).
</description>
</method>
2017-09-12 20:42:36 +00:00
</methods>
<members >
2021-08-30 18:49:09 +00:00
<member name= "collider" type= "Object" setter= "" getter= "get_best_collider" >
2017-09-17 04:56:03 +00:00
The colliding body.
2017-09-12 20:42:36 +00:00
</member>
2021-08-30 18:49:09 +00:00
<member name= "collider_id" type= "int" setter= "" getter= "get_best_collider_id" default= "0" >
2019-12-24 21:35:58 +00:00
The colliding body's unique instance ID. See [method Object.get_instance_id].
2017-09-12 20:42:36 +00:00
</member>
2021-08-30 18:49:09 +00:00
<member name= "collider_metadata" type= "Variant" setter= "" getter= "get_best_collider_metadata" >
2017-09-17 04:56:03 +00:00
The colliding body's metadata. See [Object].
2017-09-12 20:42:36 +00:00
</member>
2021-08-30 18:49:09 +00:00
<member name= "collider_rid" type= "RID" setter= "" getter= "get_best_collider_rid" >
2021-06-10 01:00:41 +00:00
The colliding body's [RID] used by the [PhysicsServer3D].
</member>
2021-08-30 18:49:09 +00:00
<member name= "collider_shape" type= "Object" setter= "" getter= "get_best_collider_shape" >
2017-09-17 04:56:03 +00:00
The colliding body's shape.
2017-09-12 20:42:36 +00:00
</member>
2021-08-30 18:49:09 +00:00
<member name= "collider_shape_index" type= "int" setter= "" getter= "get_best_collider_shape_index" default= "0" >
2020-03-30 16:22:57 +00:00
The colliding shape's index. See [CollisionObject3D].
2017-09-12 20:42:36 +00:00
</member>
2021-08-30 18:49:09 +00:00
<member name= "collider_velocity" type= "Vector3" setter= "" getter= "get_best_collider_velocity" default= "Vector3(0, 0, 0)" >
2017-09-17 04:56:03 +00:00
The colliding object's velocity.
2017-09-12 20:42:36 +00:00
</member>
2021-08-30 18:49:09 +00:00
<member name= "collision_count" type= "int" setter= "" getter= "get_collision_count" default= "0" >
</member>
<member name= "local_shape" type= "Object" setter= "" getter= "get_best_local_shape" >
2017-09-17 04:56:03 +00:00
The moving object's colliding shape.
2017-09-12 20:42:36 +00:00
</member>
2021-08-30 18:49:09 +00:00
<member name= "normal" type= "Vector3" setter= "" getter= "get_best_normal" default= "Vector3(0, 0, 0)" >
2017-09-17 04:56:03 +00:00
The colliding body's shape's normal at the point of collision.
2017-09-12 20:42:36 +00:00
</member>
2021-08-30 18:49:09 +00:00
<member name= "position" type= "Vector3" setter= "" getter= "get_best_position" default= "Vector3(0, 0, 0)" >
2020-01-19 19:22:31 +00:00
The point of collision, in global coordinates.
2017-09-12 20:42:36 +00:00
</member>
2019-09-24 17:45:03 +00:00
<member name= "remainder" type= "Vector3" setter= "" getter= "get_remainder" default= "Vector3(0, 0, 0)" >
2017-09-17 04:56:03 +00:00
The moving object's remaining movement vector.
2017-09-12 20:42:36 +00:00
</member>
2019-09-24 17:45:03 +00:00
<member name= "travel" type= "Vector3" setter= "" getter= "get_travel" default= "Vector3(0, 0, 0)" >
2017-09-17 04:56:03 +00:00
The distance the moving object traveled before collision.
2017-09-12 20:42:36 +00:00
</member>
</members>
</class>