Car.c

Go to the documentation of this file.

 
enum CarSoundCtrl
{
    // simulation
    ENGINE, 
    RPM,    
    SPEED,  
 
    // miscellaneous
    DOORS, 
    PLAYER 
};
 
 
 
enum CarFluid
{
    FUEL,
    OIL,
    BRAKE,
    COOLANT,
 
    USER1, 
    USER2, 
    USER3, 
    USER4  
};
 
 
 
enum CarGearboxType
{
    MANUAL,   
    AUTOMATIC 
}
 
 
 
enum CarGear
{
    REVERSE,
    NEUTRAL,
    FIRST,
    SECOND,
    THIRD,
    FOURTH,
    FIFTH,
    SIXTH,
    SEVENTH,
    EIGTH,
    NINTH,
    TENTH,
    ELEVENTH,
    TWELFTH,
    THIRTEENTH,
    FOURTEENTH,
    FIFTEENTH,
    SIXTEENTH
};
 
 
 
enum CarAutomaticGearboxMode
{
    P, 
    R, 
    N, 
    D  
};
 
 
 
class Car extends Transport
{
    proto native CarController GetController();
    
    proto native float GetSpeedometer();
    
    float GetSpeedometerAbsolute()
    {
        return Math.AbsFloat(GetSpeedometer());
    }
 
    override bool IsAreaAtDoorFree( int currentSeat, float maxAllowedObjHeight = 0.5, float horizontalExtents = 0.5, float playerHeight = 1.7 )
    {
        vector transform[4];
        
        vector extents;
        
        extents[0] = horizontalExtents;
        extents[1] = playerHeight;
        extents[2] = horizontalExtents;
 
        float speed = GetSpeedometerAbsolute();
        if (speed > 8)
            extents[2] = extents[2] * 6;
        if (speed > 8)
            extents[0] = 2;
        
        return IsAreaAtDoorFree( currentSeat, maxAllowedObjHeight, extents, transform );
    }
    
    override Shape DebugFreeAreaAtDoor( int currentSeat, float maxAllowedObjHeight = 0.5, float horizontalExtents = 0.5, float playerHeight = 1.7 )
    {
        int color = ARGB(20, 0, 255, 0);
        
        vector transform[4];
        
        vector extents;
        
        extents[0] = horizontalExtents;
        extents[1] = playerHeight;
        extents[2] = horizontalExtents;
 
        float speed = GetSpeedometerAbsolute();
        if (speed > 8)
            extents[2] = extents[2] * 6;
        if (speed > 8)
            extents[0] = 2;
        
        if (!IsAreaAtDoorFree( currentSeat, maxAllowedObjHeight, extents, transform ))
        {
            color = ARGB(20, 255, 0, 0);
        }
        
        Shape shape = Debug.DrawBox(-extents * 0.5, extents * 0.5, color);
        shape.SetMatrix(transform);
        return shape;
    }
    
    override int GetHideIconMask()
    {
        return EInventoryIconVisibility.HIDE_VICINITY;
    }
 
//-----------------------------------------------------------------------------
// controls
 
    proto native float GetSteering();
    proto native void SetSteering( float in, bool analog = false );
 
    proto native float GetThrustTurbo();
    proto native float GetThrustGentle();
    proto native float GetThrust();
    proto native void SetThrust( float in, float gentle = 0, float turbo = 0 );
 
    proto native float GetBrake();
    proto native void SetBrake( float in, float panic = 0, bool gentle = false );
    
    proto native float GetHandbrake();
    proto native void SetHandbrake( float in );
    
    proto native void SetBrakesActivateWithoutDriver( bool activate = true );
    
    proto native float GetClutch();
    proto native void SetClutchState( bool in );
 
    proto native int GetGear();
 
    proto native void ShiftUp();
    proto native void ShiftTo( CarGear gear );
    proto native void ShiftDown();
 
//-----------------------------------------------------------------------------
 
//-----------------------------------------------------------------------------
// fluids
 
    proto native float GetFluidCapacity( CarFluid fluid );
 
    proto native float GetFluidFraction( CarFluid fluid );
 
    proto native void Leak( CarFluid fluid, float amount );
 
    proto native void LeakAll( CarFluid fluid );
 
    proto native void Fill( CarFluid fluid, float amount );
 
    void OnFluidChanged( CarFluid fluid, float newValue, float oldValue ) {}
//-----------------------------------------------------------------------------
 
 
//-----------------------------------------------------------------------------
// engine
 
    proto native float EngineGetRPMMin();
    
    proto native float EngineGetRPMIdle();
    
    proto native float EngineGetRPMMax();
 
    proto native float EngineGetRPMRedline();
 
    proto native float EngineGetRPM();
 
    proto native bool EngineIsOn();
 
    proto native void EngineStart();
 
    bool OnBeforeEngineStart()
    {
        // engine can start by default
        return true;
    }
 
    void OnEngineStart() {}
 
    proto native void EngineStop();
 
    void OnEngineStop() {}
 
    proto native vector GetEnginePos();
    proto native void SetEnginePos(vector pos);
 
//-----------------------------------------------------------------------------
 
 
//-----------------------------------------------------------------------------
// gearbox
 
    proto native int GetGearsCount();
 
    proto native CarGearboxType GearboxGetType();
 
    proto native CarAutomaticGearboxMode GearboxGetMode();
 
    void OnGearChanged( int newGear, int oldGear )
    {
    }
//-----------------------------------------------------------------------------
 
 
//-----------------------------------------------------------------------------
// wheels
 
    proto native bool WheelIsAnyLocked();
    proto native bool WheelIsLocked( int wheelIdx );
 
//-----------------------------------------------------------------------------
 
 
//-----------------------------------------------------------------------------
// events
 
    void OnContact( string zoneName, vector localPos, IEntity other, Contact data ) {}
 
    float OnSound( CarSoundCtrl ctrl, float oldValue )
    {
        // just use the computed value by the game code
        return oldValue;
    }
 
    void OnInput( float dt ) {}
 
    void OnUpdate( float dt ) {}
//-----------------------------------------------------------------------------
 
 
    // implemented only in internal configuration
    proto native void ForcePosition( vector pos );
    // implemented only in internal configuration
    proto native void ForceDirection( vector dir );
};
 
 
 
class CarController
{
    private void CarController() {}
    private void ~CarController() {}
    
    proto float GetSteering();
    proto void SetSteering( float in, bool analog = false );
 
    proto float GetThrustTurbo();
    proto float GetThrustGentle();
    proto float GetThrust();
    proto void SetThrust( float in, float gentle = 0, float turbo = 0 );
 
    proto float GetBrake();
    proto void SetBrake( float in, float panic = 0 );
 
    proto int GetGear();
 
    proto void ShiftUp();
    proto void ShiftTo( CarGear gear );
    proto void ShiftDown();
};