2017-09-13 04:42:36 +08:00
<?xml version="1.0" encoding="UTF-8" ?>
2023-07-06 16:08:05 +08:00
<class name= "KinematicCollision3D" inherits= "RefCounted" xmlns:xsi= "http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation= "../class.xsd" >
2017-09-13 04:42:36 +08:00
<brief_description >
2023-04-29 04:59:03 +08:00
Holds collision data from the movement of a [PhysicsBody3D].
2017-09-13 04:42:36 +08:00
</brief_description>
<description >
2023-04-29 04:59:03 +08:00
Holds collision data from the movement of a [PhysicsBody3D], usually from [method PhysicsBody3D.move_and_collide]. When a [PhysicsBody3D] is moved, it stops if it detects a collision with another body. If a collision is detected, a [KinematicCollision3D] object is returned.
The collision data includes the colliding object, the remaining motion, and the collision position. This data can be used to determine a custom response to the collision.
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" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "collision_index" type= "int" default= "0" />
<param index= "1" name= "up_direction" type= "Vector3" default= "Vector3(0, 1, 0)" />
2021-08-13 06:41:40 +08:00
<description >
2022-08-12 21:36:48 +08:00
Returns the collision angle according to [param up_direction], which is [constant Vector3.UP] 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" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "collision_index" type= "int" default= "0" />
2021-08-31 02:49:09 +08:00
<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" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "collision_index" type= "int" default= "0" />
2021-08-31 02:49:09 +08:00
<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" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "collision_index" type= "int" default= "0" />
2021-08-31 02:49:09 +08:00
<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" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "collision_index" type= "int" default= "0" />
2021-08-31 02:49:09 +08:00
<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" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "collision_index" type= "int" default= "0" />
2021-08-31 02:49:09 +08:00
<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" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "collision_index" type= "int" default= "0" />
2021-08-31 02:49:09 +08:00
<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>
2022-08-10 09:14:36 +08:00
<method name= "get_depth" qualifiers= "const" >
<return type= "float" />
<description >
Returns the colliding body's length of overlap along the collision normal.
</description>
</method>
2021-08-31 02:49:09 +08:00
<method name= "get_local_shape" qualifiers= "const" >
<return type= "Object" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "collision_index" type= "int" default= "0" />
2021-08-31 02:49:09 +08:00
<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" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "collision_index" type= "int" default= "0" />
2021-08-31 02:49:09 +08:00
<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" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "collision_index" type= "int" default= "0" />
2021-08-31 02:49:09 +08:00
<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>