True Axis Physics SDK 1.2.0.1 Beta Documentation
www.trueaxis.com

---

DynamicObjectCar.h

Go to the documentation of this file.

//---------------------------------------------------------------------------------
// File Name: DynamicObjectCar.h
// Description:
//
// Copyright (C) 2004 - 2006 True Axis Pty Ltd, Australia. 
// All Rights Reserved.
//
// History:
//      Created File.
//---------------------------------------------------------------------------------

#ifndef TA_DYNAMICOBJECTCAR_H
#define TA_DYNAMICOBJECTCAR_H

#ifndef TA_DYNAMICOBJECT_H
#include "DynamicObject.h"
#endif // TA_DYNAMICOBJECT_H

TA_OBFUSCATION_SKIP_PASS_2

namespace TA
{

class CollisionObjectCombo;
class CarTemplate;
class SurfaceAttribute;

class TAPHYSICS_CLASS DynamicObjectCar : public DynamicObject
{
public:
    enum WheelFlag
    {
        WHEEL_FLAG_STEERING =               0x1,
        WHEEL_FLAG_DRIVING =                0x2,
        WHEEL_FLAG_HAND_BRAKE_AFFECTED =    0x4,
        WHEEL_FLAG_CAMBER_CHANGED =         0x8,
    };
    TA_OBFUSCATION_RESERVED_ON
    struct Wheel
    {
    public:
        typedef float (TAC_CALL *FnSlipRatioToNormalisedTraction)(float fSlipRatio, const SurfaceAttribute& surfaceAttribute);
        typedef float (TAC_CALL *FnSlipAngleToLateralForce)(float fSlipAngle, float fLongitudinalSlipRatio, const SurfaceAttribute& surfaceAttribute);

        const MFrame& GetLocalGraphicsFrame() const;
        
        void SetRadius(float fRadius);
        float GetRadius() const;

        void SetInvInertia(float fInvInertia);
        float GetInvInertia() const;

        void SetBrakeTorque(float fBrakeTorque);
        float GetBrakeTorque() const;

        void SetRollResistance(float fRollResistance);
        float GetRollResistance() const;

        void SetSuspensionSpringConstant(float fSuspensionSpringConstant);
        float GetSuspensionSpringConstant() const;

        void SetSuspensionDampingConstant(float fSuspensionDampingConstant);
        float GetSuspensionDampingConstant() const;
        
        void SetSlipRatioToNormalisedTractionCallBack(FnSlipRatioToNormalisedTraction pCallBack);
        FnSlipRatioToNormalisedTraction GetSlipRatioToNormalisedTractionCallBack() const;
    
        void SetSlipAngleToLateralForceCallBack(FnSlipAngleToLateralForce pCallBack);
        FnSlipAngleToLateralForce GetSlipAngleToLateralForceCallBack() const;

        void SetSteeringFlag(bool bSteering);
        bool GetSteeringFlag() const;

        void SetDrivingFlag(bool bDriving);
        bool GetDrivingFlag() const;

        void SetHandBrakeFlag(bool bHandBrake);
        bool GetHandBrakeFlag() const;

        void SetYaw(float fYaw);
        float GetYaw() const;

        void SetPitch(float fPitch);
        float GetPitch() const;

        void SetPitchVelocity(float fPitchVelocity);
        float GetPitchVelocity() const;

        void SetCamberAngle(float fCamberAngle);
        float GetCamberAngle() const;

        TA_OBFUSCATION_RESERVED_OFF

    private:
        friend class DynamicObjectCar;

        MFrame m_localGraphicsFrame;
        Mat33 m_m33DefaultRotation;
        Mat33 m_m33TotalRotation;       
        Vec3 m_v3AccumulatedImpulse;
        float m_fRadius;
        float m_fInvRadius;
        float m_fPitchVelocity;
        float m_fPitch;
        float m_fCamberAngle;
        float m_fYaw;
        float m_fRollResistance;
        float m_fBrakeTorque;
        float m_fInvInertia;
        float m_fSuspensionSpringConstant;
        float m_fSuspensionDampingConstant;
        float (TAC_CALL *m_pFnSlipRatioToNormalisedTraction)(float fSlipRatio, const SurfaceAttribute& surfaceAttribute);
        float (TAC_CALL *m_pFnSlipAngleToLateralForce)(float fSlipAngle, float fLongitudinalSlipRatio, const SurfaceAttribute& surfaceAttribute);
        u32 m_nFlags;
    };

    TA_OBFUSCATION_RESERVED_ON

    void Initialise(CarTemplate* pCarTemplate);
    void Initialise(const Char* szFileName);
    void Finalise();


    virtual void Update(float fDt);

    void ClearControls();
    void UpdateControls(
        float fSteeringAngle,
        float fAccelerator,
        float fBrake,
        float fHandBrake,
        float fSteeringHelp,
        float fTractionControl,
        int nGear = -1);



    float GetRPM() const;
    int GetGear() const;
    int GetNumGears() const;
    float GetCarSpeedFromWheels();
    
    void SetTorqueMultiplier(float fTorqueMultiplier);
    float GetTorqueMultiplier() const;

    void SetAntiRollFudge(float fAntiRollFudge);
    float GetAntiRollFudge() const;
    const Wheel& GetWheel(int nIndex) const;
    Wheel& GetWheel(int nIndex);
    int GetNumWheels() const;

    void SetOrientation(const Vec3& v3Forward, const Vec3& v3Up);
    const Vec3& GetForward() const;
    const Vec3& GetUp() const;

    static DynamicObjectCar* TAC_CALL CreateNew();

protected:
    DynamicObjectCar();
    ~DynamicObjectCar();

    TA_OBFUSCATION_RESERVED_OFF

private:
    struct Controls
    {
        float fSteeringAngle;
        float fAccelerator;
        float fBrake;
        float fHandBrake;
        float fSteeringHelp;
        float fTractionControl;
        int nGear;
    };

    Controls m_controls;
    Vec3 m_v3Forward;
    Vec3 m_v3Up;
    Array<Wheel, false> m_wheelArray;

    int m_nCurrentGear;

    float m_fEngineRadsPerSec;
    float m_fInvNumDrivingWheels;

    Array<float, false> m_gearRatioArray;
    float m_fDifferentialRatio;
    float m_fTransmissionEfficiency;
    float m_fTorqueMultiplier;
    float m_fAntiRollFudge;
    float (TAC_CALL *m_pFnTorqueCurve)(float fRadsPerSec);

    float m_fAirResistance;
    float m_fDownForce;

    void InitialiseCommon();
    void UpdateDefaultWheelRotation(Wheel& wheel);
};

}

#include "DynamicObjectCar.inl"

#endif // TA_DYNAMICOBJECTCAR_H

---

© Copyright 2004-2006 TRUE AXIS PTY LTD Australia. All rights reserved.