Car.c

См. документацию.

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  
};
 

enum CarWheelWaterState
{
    ON_LAND,     
    IN_WATER,       
    UNDER_WATER      
};
 
 

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;
    }
    
    protected bool DetectFlippedUsingWheels(VehicleFlippedContext ctx, bool disallowSide)
    {
        if (disallowSide && (vector.Dot(GetDirectionUp(), vector.Up) < 0.7))
        {
            // return as "flipped", vehicle isn't pointing enough up to be reasonably certain
            return true;
        }
        
        int wheelCount = WheelCount();
        
        for (int wheelIdx = 0; wheelIdx < wheelCount; wheelIdx++)
        {
            if (!WheelHasContact(wheelIdx))
            {
                // wheel not in contact, then we could be flipped, we assume there exist other predicates
                return true;
            }
        }
        
        // all wheels in contact (or zero registered wheels), then we are in contact
        return false;
    }
    
//-----------------------------------------------------------------------------
// 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 float WheelGetAngularVelocity( int wheelIdx );
    proto native bool WheelHasContact( int wheelIdx );
    proto native vector WheelGetContactPosition( int wheelIdx );
    proto native vector WheelGetContactNormal( int wheelIdx );
    proto native vector WheelGetDirection( int wheelIdx );
    proto native SurfaceInfo WheelGetSurface( int wheelIdx );
    proto native CarWheelWaterState WheelGetWaterState( int wheelIdx );
    proto native EntityAI WheelGetEntity( int wheelIdx );
    proto native bool WheelIsLocked( int wheelIdx );
    
    proto native int WheelCount();
    
    proto native int WheelCountPresent();
 
//-----------------------------------------------------------------------------
 
 
//-----------------------------------------------------------------------------
// 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();
};