Expose contact point and contact normal on VehicleWheel3D

Appease doctool by switching the order of the documentation page entries.

Update doc/classes/VehicleWheel3D.xml

Co-authored-by: Hugo Locurcio <hugo.locurcio@hugo.pro>

Update doc/classes/VehicleWheel3D.xml

Co-authored-by: Hugo Locurcio <hugo.locurcio@hugo.pro>

Update doc/classes/VehicleWheel3D.xml

Thanks, didn't see the typo in the suggested change. Brain auto corrected it.

Co-authored-by: A Thousand Ships <96648715+AThousandShips@users.noreply.github.com>
This commit is contained in:
TestSubject06 2024-07-03 08:53:29 -07:00
parent 6a13fdcae3
commit b56a0370c4
3 changed files with 26 additions and 0 deletions

View file

@ -18,6 +18,18 @@
Returns [code]null[/code] if the wheel is not in contact with a surface, or the contact body is not a [PhysicsBody3D].
</description>
</method>
<method name="get_contact_normal" qualifiers="const">
<return type="Vector3" />
<description>
Returns the normal of the suspension's collision in world space if the wheel is in contact. If the wheel isn't in contact with anything, returns a vector pointing directly along the suspension axis toward the vehicle in world space.
</description>
</method>
<method name="get_contact_point" qualifiers="const">
<return type="Vector3" />
<description>
Returns the point of the suspension's collision in world space if the wheel is in contact. If the wheel isn't in contact with anything, returns the maximum point of the wheel's ray cast in world space, which is defined by [code]wheel_rest_length + wheel_radius[/code].
</description>
</method>
<method name="get_rpm" qualifiers="const">
<return type="float" />
<description>

View file

@ -219,6 +219,14 @@ bool VehicleWheel3D::is_in_contact() const {
return m_raycastInfo.m_isInContact;
}
Vector3 VehicleWheel3D::get_contact_point() const {
return m_raycastInfo.m_contactPointWS;
}
Vector3 VehicleWheel3D::get_contact_normal() const {
return m_raycastInfo.m_contactNormalWS;
}
Node3D *VehicleWheel3D::get_contact_body() const {
return m_raycastInfo.m_groundObject;
}
@ -256,6 +264,8 @@ void VehicleWheel3D::_bind_methods() {
ClassDB::bind_method(D_METHOD("is_in_contact"), &VehicleWheel3D::is_in_contact);
ClassDB::bind_method(D_METHOD("get_contact_body"), &VehicleWheel3D::get_contact_body);
ClassDB::bind_method(D_METHOD("get_contact_point"), &VehicleWheel3D::get_contact_point);
ClassDB::bind_method(D_METHOD("get_contact_normal"), &VehicleWheel3D::get_contact_normal);
ClassDB::bind_method(D_METHOD("set_roll_influence", "roll_influence"), &VehicleWheel3D::set_roll_influence);
ClassDB::bind_method(D_METHOD("get_roll_influence"), &VehicleWheel3D::get_roll_influence);

View file

@ -130,6 +130,10 @@ public:
bool is_in_contact() const;
Vector3 get_contact_point() const;
Vector3 get_contact_normal() const;
Node3D *get_contact_body() const;
void set_roll_influence(real_t p_value);