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