1//
2// Redistribution and use in source and binary forms, with or without
3// modification, are permitted provided that the following conditions
4// are met:
5// * Redistributions of source code must retain the above copyright
6// notice, this list of conditions and the following disclaimer.
7// * Redistributions in binary form must reproduce the above copyright
8// notice, this list of conditions and the following disclaimer in the
9// documentation and/or other materials provided with the distribution.
10// * Neither the name of NVIDIA CORPORATION nor the names of its
11// contributors may be used to endorse or promote products derived
12// from this software without specific prior written permission.
13//
14// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ''AS IS'' AND ANY
15// EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
17// PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
18// CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
19// EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
20// PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
21// PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
22// OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
24// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25//
26// Copyright (c) 2008-2021 NVIDIA Corporation. All rights reserved.
27// Copyright (c) 2004-2008 AGEIA Technologies, Inc. All rights reserved.
28// Copyright (c) 2001-2004 NovodeX AG. All rights reserved.
29
30#ifndef PX_VEHICLE_SHADERS_H
31#define PX_VEHICLE_SHADERS_H
32/** \addtogroup vehicle
33 @{
34*/
35
36#include "foundation/PxSimpleTypes.h"
37
38#if !PX_DOXYGEN
39namespace physx
40{
41#endif
42
43/**
44\brief Prototype of shader function that is used to compute wheel torque and tire forces.
45\param[in] shaderData is the shader data for the tire being processed. The shader data describes the tire data in the format required by the tire model that is implemented by the shader function.
46\param[in] tireFriction is the value of friction for the contact between the tire and the ground.
47\param[in] longSlip is the value of longitudinal slip experienced by the tire.
48\param[in] latSlip is the value of lateral slip experienced by the tire.
49\param[in] camber is the camber angle of the tire in radians.
50\param[in] wheelOmega is the rotational speed of the wheel.
51\param[in] wheelRadius is the distance from the tire surface to the center of the wheel.
52\param[in] recipWheelRadius is the reciprocal of wheelRadius.
53\param[in] restTireLoad is the load force experienced by the tire when the vehicle is at rest.
54\param[in] normalisedTireLoad is a pre-computed value equal to the load force on the tire divided by restTireLoad.
55\param[in] tireLoad is the load force currently experienced by the tire (= restTireLoad*normalisedTireLoad)
56\param[in] gravity is the magnitude of gravitational acceleration.
57\param[in] recipGravity is the reciprocal of the magnitude of gravitational acceleration.
58\param[out] wheelTorque is the torque that is to be applied to the wheel around the wheel's axle.
59\param[out] tireLongForceMag is the magnitude of the longitudinal tire force to be applied to the vehicle's rigid body.
60\param[out] tireLatForceMag is the magnitude of the lateral tire force to be applied to the vehicle's rigid body.
61\param[out] tireAlignMoment is the aligning moment of the tire that is to be applied to the vehicle's rigid body (not currently used).
62@see PxVehicleWheelsDynData::setTireForceShaderFunction, PxVehicleWheelsDynData::setTireForceShaderData
63*/
64typedef void (*PxVehicleComputeTireForce)
65(const void* shaderData,
66 const PxF32 tireFriction,
67 const PxF32 longSlip, const PxF32 latSlip, const PxF32 camber,
68 const PxF32 wheelOmega, const PxF32 wheelRadius, const PxF32 recipWheelRadius,
69 const PxF32 restTireLoad, const PxF32 normalisedTireLoad, const PxF32 tireLoad,
70 const PxF32 gravity, const PxF32 recipGravity,
71 PxF32& wheelTorque, PxF32& tireLongForceMag, PxF32& tireLatForceMag, PxF32& tireAlignMoment);
72
73
74#if !PX_DOXYGEN
75} // namespace physx
76#endif
77
78/** @} */
79#endif //PX_VEHICLE_SHADERS_H
80

source code of qtquick3dphysics/src/3rdparty/PhysX/include/vehicle/PxVehicleShaders.h