asgardius/virtualx-engine
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
virtualx-engine/doc/classes/KinematicCollision3D.xml

110 lines
4.8 KiB
XML
Raw Normal View History

Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them.
2017-09-12 22:42:36 +02:00
<?xml version="1.0" encoding="UTF-8" ?>
Add an XML schema for documentation This makes it easier to spot syntax errors when editing the class reference. The schema is referenced locally so validation can still work offline. Each class XML's schema conformance is also checked on GitHub Actions.
2022-02-14 14:18:53 +01:00
<class name="KinematicCollision3D" inherits="RefCounted" version="4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them.
2017-09-12 22:42:36 +02:00
<brief_description>
KinematicBody split between new CharacterBody and PhysicsBody PhysicsBody now has methods move_and_collide/test_move and needed properties for these methods: safe margin, locked axes (3D only). Moved collision_exceptions from StaticBody to PhysicsBody for 3D (same as 2D, and conforms to documentation). RigidBody doesn't have test_motion method anymore, it's now redundant with PhysicsBody.test_move.
2021-05-20 03:14:33 +02:00
Collision data for [method PhysicsBody3D.move_and_collide] collisions.
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them.
2017-09-12 22:42:36 +02:00
</brief_description>
<description>
KinematicBody split between new CharacterBody and PhysicsBody PhysicsBody now has methods move_and_collide/test_move and needed properties for these methods: safe margin, locked axes (3D only). Moved collision_exceptions from StaticBody to PhysicsBody for 3D (same as 2D, and conforms to documentation). RigidBody doesn't have test_motion method anymore, it's now redundant with PhysicsBody.test_move.
2021-05-20 03:14:33 +02: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.
[DOCS] Add KinematicCollision descriptions
2017-09-17 06:56:03 +02: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.
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them.
2017-09-12 22:42:36 +02:00
</description>
<tutorials>
</tutorials>
<methods>
API improvement on physics, mainly CharacterBody Changes: - Rename few methods/property and group them in the editor when it's possible - Make MotionResult API consistency with KinematicCollision - Return a boolean in move_and_slide if there was a collision - New methods: - get_floor_angle on CharacterBody to get the floor angle. - get_angle on KinematicCollision to get the collision angle. - get_last_slide_collision to quickly get the latest collision of move_and_slide.
2021-08-13 00:41:40 +02:00
<method name="get_angle" qualifiers="const">
<return type="float" />
Rename the argument tag to param in XML documentation
2022-08-06 20:11:48 +02:00
<param index="0" name="collision_index" type="int" default="0" />
<param index="1" name="up_direction" type="Vector3" default="Vector3(0, 1, 0)" />
API improvement on physics, mainly CharacterBody Changes: - Rename few methods/property and group them in the editor when it's possible - Make MotionResult API consistency with KinematicCollision - Return a boolean in move_and_slide if there was a collision - New methods: - get_floor_angle on CharacterBody to get the floor angle. - get_angle on KinematicCollision to get the collision angle. - get_last_slide_collision to quickly get the latest collision of move_and_slide.
2021-08-13 00:41:40 +02:00
<description>
[doc] Use "param" instead of "code" to refer to parameters (5)
2022-08-12 15:36:48 +02:00
Returns the collision angle according to [param up_direction], which is [constant Vector3.UP] by default. This value is always positive.
API improvement on physics, mainly CharacterBody Changes: - Rename few methods/property and group them in the editor when it's possible - Make MotionResult API consistency with KinematicCollision - Return a boolean in move_and_slide if there was a collision - New methods: - get_floor_angle on CharacterBody to get the floor angle. - get_angle on KinematicCollision to get the collision angle. - get_last_slide_collision to quickly get the latest collision of move_and_slide.
2021-08-13 00:41:40 +02:00
</description>
</method>
Port 2D improvement to move and slide 3D Co-authored-by: Camille Mohr-Daurat <pouleyketchoup@gmail.com>
2021-08-30 20:49:09 +02:00
<method name="get_collider" qualifiers="const">
<return type="Object" />
Rename the argument tag to param in XML documentation
2022-08-06 20:11:48 +02:00
<param index="0" name="collision_index" type="int" default="0" />
Port 2D improvement to move and slide 3D Co-authored-by: Camille Mohr-Daurat <pouleyketchoup@gmail.com>
2021-08-30 20:49:09 +02:00
<description>
Script interface improvements for test body motion -Physics servers test body motion use a class to hold parameters instead of multiple arguments to make it more readable and flexible since there are many options -Improved documentation for test body motion and kinematic collision -Removed read-only properties for body motion results (not handled in scripts, so they should be get_ methods only instead)
2021-09-30 20:28:57 +02:00
Returns the colliding body's attached [Object] given a collision index (the deepest collision by default).
Port 2D improvement to move and slide 3D Co-authored-by: Camille Mohr-Daurat <pouleyketchoup@gmail.com>
2021-08-30 20:49:09 +02:00
</description>
</method>
<method name="get_collider_id" qualifiers="const">
<return type="int" />
Rename the argument tag to param in XML documentation
2022-08-06 20:11:48 +02:00
<param index="0" name="collision_index" type="int" default="0" />
Port 2D improvement to move and slide 3D Co-authored-by: Camille Mohr-Daurat <pouleyketchoup@gmail.com>
2021-08-30 20:49:09 +02:00
<description>
Script interface improvements for test body motion -Physics servers test body motion use a class to hold parameters instead of multiple arguments to make it more readable and flexible since there are many options -Improved documentation for test body motion and kinematic collision -Removed read-only properties for body motion results (not handled in scripts, so they should be get_ methods only instead)
2021-09-30 20:28:57 +02: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].
Port 2D improvement to move and slide 3D Co-authored-by: Camille Mohr-Daurat <pouleyketchoup@gmail.com>
2021-08-30 20:49:09 +02:00
</description>
</method>
<method name="get_collider_rid" qualifiers="const">
<return type="RID" />
Rename the argument tag to param in XML documentation
2022-08-06 20:11:48 +02:00
<param index="0" name="collision_index" type="int" default="0" />
Port 2D improvement to move and slide 3D Co-authored-by: Camille Mohr-Daurat <pouleyketchoup@gmail.com>
2021-08-30 20:49:09 +02:00
<description>
Script interface improvements for test body motion -Physics servers test body motion use a class to hold parameters instead of multiple arguments to make it more readable and flexible since there are many options -Improved documentation for test body motion and kinematic collision -Removed read-only properties for body motion results (not handled in scripts, so they should be get_ methods only instead)
2021-09-30 20:28:57 +02:00
Returns the colliding body's [RID] used by the [PhysicsServer3D] given a collision index (the deepest collision by default).
Port 2D improvement to move and slide 3D Co-authored-by: Camille Mohr-Daurat <pouleyketchoup@gmail.com>
2021-08-30 20:49:09 +02:00
</description>
</method>
<method name="get_collider_shape" qualifiers="const">
<return type="Object" />
Rename the argument tag to param in XML documentation
2022-08-06 20:11:48 +02:00
<param index="0" name="collision_index" type="int" default="0" />
Port 2D improvement to move and slide 3D Co-authored-by: Camille Mohr-Daurat <pouleyketchoup@gmail.com>
2021-08-30 20:49:09 +02:00
<description>
Script interface improvements for test body motion -Physics servers test body motion use a class to hold parameters instead of multiple arguments to make it more readable and flexible since there are many options -Improved documentation for test body motion and kinematic collision -Removed read-only properties for body motion results (not handled in scripts, so they should be get_ methods only instead)
2021-09-30 20:28:57 +02:00
Returns the colliding body's shape given a collision index (the deepest collision by default).
Port 2D improvement to move and slide 3D Co-authored-by: Camille Mohr-Daurat <pouleyketchoup@gmail.com>
2021-08-30 20:49:09 +02:00
</description>
</method>
<method name="get_collider_shape_index" qualifiers="const">
<return type="int" />
Rename the argument tag to param in XML documentation
2022-08-06 20:11:48 +02:00
<param index="0" name="collision_index" type="int" default="0" />
Port 2D improvement to move and slide 3D Co-authored-by: Camille Mohr-Daurat <pouleyketchoup@gmail.com>
2021-08-30 20:49:09 +02:00
<description>
Script interface improvements for test body motion -Physics servers test body motion use a class to hold parameters instead of multiple arguments to make it more readable and flexible since there are many options -Improved documentation for test body motion and kinematic collision -Removed read-only properties for body motion results (not handled in scripts, so they should be get_ methods only instead)
2021-09-30 20:28:57 +02:00
Returns the colliding body's shape index given a collision index (the deepest collision by default). See [CollisionObject3D].
Port 2D improvement to move and slide 3D Co-authored-by: Camille Mohr-Daurat <pouleyketchoup@gmail.com>
2021-08-30 20:49:09 +02:00
</description>
</method>
<method name="get_collider_velocity" qualifiers="const">
<return type="Vector3" />
Rename the argument tag to param in XML documentation
2022-08-06 20:11:48 +02:00
<param index="0" name="collision_index" type="int" default="0" />
Port 2D improvement to move and slide 3D Co-authored-by: Camille Mohr-Daurat <pouleyketchoup@gmail.com>
2021-08-30 20:49:09 +02:00
<description>
Script interface improvements for test body motion -Physics servers test body motion use a class to hold parameters instead of multiple arguments to make it more readable and flexible since there are many options -Improved documentation for test body motion and kinematic collision -Removed read-only properties for body motion results (not handled in scripts, so they should be get_ methods only instead)
2021-09-30 20:28:57 +02: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.
Port 2D improvement to move and slide 3D Co-authored-by: Camille Mohr-Daurat <pouleyketchoup@gmail.com>
2021-08-30 20:49:09 +02:00
</description>
</method>
add get_depth() to KinematicCollision3D as same of 2D
2022-08-10 03:14:36 +02: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>
Port 2D improvement to move and slide 3D Co-authored-by: Camille Mohr-Daurat <pouleyketchoup@gmail.com>
2021-08-30 20:49:09 +02:00
<method name="get_local_shape" qualifiers="const">
<return type="Object" />
Rename the argument tag to param in XML documentation
2022-08-06 20:11:48 +02:00
<param index="0" name="collision_index" type="int" default="0" />
Port 2D improvement to move and slide 3D Co-authored-by: Camille Mohr-Daurat <pouleyketchoup@gmail.com>
2021-08-30 20:49:09 +02:00
<description>
Script interface improvements for test body motion -Physics servers test body motion use a class to hold parameters instead of multiple arguments to make it more readable and flexible since there are many options -Improved documentation for test body motion and kinematic collision -Removed read-only properties for body motion results (not handled in scripts, so they should be get_ methods only instead)
2021-09-30 20:28:57 +02:00
Returns the moving object's colliding shape given a collision index (the deepest collision by default).
Port 2D improvement to move and slide 3D Co-authored-by: Camille Mohr-Daurat <pouleyketchoup@gmail.com>
2021-08-30 20:49:09 +02:00
</description>
</method>
<method name="get_normal" qualifiers="const">
<return type="Vector3" />
Rename the argument tag to param in XML documentation
2022-08-06 20:11:48 +02:00
<param index="0" name="collision_index" type="int" default="0" />
Port 2D improvement to move and slide 3D Co-authored-by: Camille Mohr-Daurat <pouleyketchoup@gmail.com>
2021-08-30 20:49:09 +02:00
<description>
Script interface improvements for test body motion -Physics servers test body motion use a class to hold parameters instead of multiple arguments to make it more readable and flexible since there are many options -Improved documentation for test body motion and kinematic collision -Removed read-only properties for body motion results (not handled in scripts, so they should be get_ methods only instead)
2021-09-30 20:28:57 +02:00
Returns the colliding body's shape's normal at the point of collision given a collision index (the deepest collision by default).
Port 2D improvement to move and slide 3D Co-authored-by: Camille Mohr-Daurat <pouleyketchoup@gmail.com>
2021-08-30 20:49:09 +02:00
</description>
</method>
<method name="get_position" qualifiers="const">
<return type="Vector3" />
Rename the argument tag to param in XML documentation
2022-08-06 20:11:48 +02:00
<param index="0" name="collision_index" type="int" default="0" />
Port 2D improvement to move and slide 3D Co-authored-by: Camille Mohr-Daurat <pouleyketchoup@gmail.com>
2021-08-30 20:49:09 +02:00
<description>
Script interface improvements for test body motion -Physics servers test body motion use a class to hold parameters instead of multiple arguments to make it more readable and flexible since there are many options -Improved documentation for test body motion and kinematic collision -Removed read-only properties for body motion results (not handled in scripts, so they should be get_ methods only instead)
2021-09-30 20:28:57 +02: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.
Port 2D improvement to move and slide 3D Co-authored-by: Camille Mohr-Daurat <pouleyketchoup@gmail.com>
2021-08-30 20:49:09 +02:00
</description>
</method>
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them.
2017-09-12 22:42:36 +02:00
</methods>
</class>
Reference in a new issue Copy permalink