2017-09-13 04:42:36 +08:00
<?xml version="1.0" encoding="UTF-8" ?>
2021-06-05 00:03:15 +08:00
<class name= "KinematicCollision3D" inherits= "RefCounted" version= "4.0" >
2017-09-13 04:42:36 +08:00
<brief_description >
2021-05-20 09:14:33 +08:00
Collision data for [method PhysicsBody3D.move_and_collide] collisions.
2017-09-13 04:42:36 +08:00
</brief_description>
<description >
2021-05-20 09:14:33 +08: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 12:56:03 +08: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-13 04:42:36 +08:00
</description>
<tutorials >
</tutorials>
<methods >
2021-08-13 06:41:40 +08:00
<method name= "get_angle" qualifiers= "const" >
<return type= "float" />
2021-08-31 02:49:09 +08: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-13 06:41:40 +08:00
<description >
2021-10-01 02:28:57 +08:00
Returns the collision angle according to [code]up_direction[/code], which is [code]Vector3.UP[/code] by default. This value is always positive.
2021-08-13 06:41:40 +08:00
</description>
</method>
2021-08-31 02:49:09 +08:00
<method name= "get_collider" qualifiers= "const" >
<return type= "Object" />
<argument index= "0" name= "collision_index" type= "int" default= "0" />
<description >
2021-10-01 02:28:57 +08:00
Returns the colliding body's attached [Object] given a collision index (the deepest collision by default).
2021-08-31 02:49:09 +08:00
</description>
</method>
<method name= "get_collider_id" qualifiers= "const" >
<return type= "int" />
<argument index= "0" name= "collision_index" type= "int" default= "0" />
<description >
2021-10-01 02:28:57 +08:00
Returns the unique instance ID of the colliding body's attached [Object] given a collision index (the deepest collision by default). See [method Object.get_instance_id].
2021-08-31 02:49:09 +08:00
</description>
</method>
<method name= "get_collider_rid" qualifiers= "const" >
<return type= "RID" />
<argument index= "0" name= "collision_index" type= "int" default= "0" />
<description >
2021-10-01 02:28:57 +08:00
Returns the colliding body's [RID] used by the [PhysicsServer3D] given a collision index (the deepest collision by default).
2021-08-31 02:49:09 +08:00
</description>
</method>
<method name= "get_collider_shape" qualifiers= "const" >
<return type= "Object" />
<argument index= "0" name= "collision_index" type= "int" default= "0" />
<description >
2021-10-01 02:28:57 +08:00
Returns the colliding body's shape given a collision index (the deepest collision by default).
2021-08-31 02:49:09 +08:00
</description>
</method>
<method name= "get_collider_shape_index" qualifiers= "const" >
<return type= "int" />
<argument index= "0" name= "collision_index" type= "int" default= "0" />
<description >
2021-10-01 02:28:57 +08:00
Returns the colliding body's shape index given a collision index (the deepest collision by default). See [CollisionObject3D].
2021-08-31 02:49:09 +08:00
</description>
</method>
<method name= "get_collider_velocity" qualifiers= "const" >
<return type= "Vector3" />
<argument index= "0" name= "collision_index" type= "int" default= "0" />
<description >
2021-10-01 02:28:57 +08:00
Returns the colliding body's velocity given a collision index (the deepest collision by default).
</description>
</method>
<method name= "get_collision_count" qualifiers= "const" >
<return type= "int" />
<description >
Returns the number of detected collisions.
2021-08-31 02:49:09 +08:00
</description>
</method>
<method name= "get_local_shape" qualifiers= "const" >
<return type= "Object" />
<argument index= "0" name= "collision_index" type= "int" default= "0" />
<description >
2021-10-01 02:28:57 +08:00
Returns the moving object's colliding shape given a collision index (the deepest collision by default).
2021-08-31 02:49:09 +08:00
</description>
</method>
<method name= "get_normal" qualifiers= "const" >
<return type= "Vector3" />
<argument index= "0" name= "collision_index" type= "int" default= "0" />
<description >
2021-10-01 02:28:57 +08:00
Returns the colliding body's shape's normal at the point of collision given a collision index (the deepest collision by default).
2021-08-31 02:49:09 +08:00
</description>
</method>
<method name= "get_position" qualifiers= "const" >
<return type= "Vector3" />
<argument index= "0" name= "collision_index" type= "int" default= "0" />
<description >
2021-10-01 02:28:57 +08:00
Returns the point of collision in global coordinates given a collision index (the deepest collision by default).
</description>
</method>
<method name= "get_remainder" qualifiers= "const" >
<return type= "Vector3" />
<description >
Returns the moving object's remaining movement vector.
</description>
</method>
<method name= "get_travel" qualifiers= "const" >
<return type= "Vector3" />
<description >
Returns the moving object's travel before collision.
2021-08-31 02:49:09 +08:00
</description>
</method>
2017-09-13 04:42:36 +08:00
</methods>
</class>