diguyVehicleController.h

Go to the documentation of this file.

/*********************************************************************
 ** Copyright (c) 1992-2015 VT MAK
 ** All rights reserved. 
 *********************************************************************/

/*********************************************************************
 **
 *t  diguyVehicleController
 **
 */

#ifndef __diguyVehicleController_H
#define __diguyVehicleController_H

#ifdef SWIG
%module diguyVehicleController
#else
#define CPLUSPLUS_ONLY
#endif

#ifdef CPLUSPLUS_ONLY

#include <declspec_diguy.h>
#include <diguy_constants.h>

class diguyCharacter;
class bdiScenarioVehicleController;

#endif

/****************************************************************************/
class BDI_DECLSPEC_diguy diguyVehicleController
{

public:

/*****************************************************************************
 **
 *2  Character Functions
 **
 */
        diguyCharacter* get_vehicle_character();


/*****************************************************************************
 **
 *2  Speed Functions
 **
 **    These functions should only be used in free action mode.
 **
 */

        /*l
         *b  Description:
         **
         **    This function sets the vehicle's speed.  The speed becomes
         **    effective immediately; no acceleration or deceleration is applied.
         **
         *b  Arguments:
         **
         *a    speed - new speed of vehicle
         *a    units - units of speed
         **
         *b  Callable From:
         **
         *-    - C++
         *-    - Script
         */
        void set_speed(float speed,
                diguySpeedUnits units = DIGUY_SPEED_UNITS_METERS_PER_SECOND);

        /*
         *  Documentation Pending
         */
        float get_speed(diguySpeedUnits units = DIGUY_SPEED_UNITS_METERS_PER_SECOND);

        /*l
         **  Vehicle's speed will increase or decrease over time to match the desired speed.
         **  If necessary, the acceleration value will be applied as deceleration instead.
         */
        void set_desired_speed_with_acceleration(float desired_speed,
                float acceleration,
                diguySpeedUnits units = DIGUY_SPEED_UNITS_METERS_PER_SECOND);

        /*l
         **  An acceleration value is calculated from the time interval and the difference
         **  between current speed and desired speed.
         */
        void set_desired_speed_with_acceleration_time(float desired_speed,
                float acceleration_time,   // seconds
                diguySpeedUnits units = DIGUY_SPEED_UNITS_METERS_PER_SECOND);

        /*l
         **  Returns the desired speed, as currently set.
         */
        float get_desired_speed(diguySpeedUnits units = DIGUY_SPEED_UNITS_METERS_PER_SECOND);

        /*l
         **  Sets the default acceleration value that will be used whenever the vehicle needs to raise
         **  its speed.
         */
        void  set_default_acceleration(float acceleration,
                diguySpeedUnits units = DIGUY_SPEED_UNITS_METERS_PER_SECOND);
        float get_default_acceleration(diguySpeedUnits units = DIGUY_SPEED_UNITS_METERS_PER_SECOND);

        /*l
         **  Sets the default deceleration value that will be used whenever the vehicle needs to lower
         **  its speed.
         */
        void  set_default_deceleration(float deceleration,
                diguySpeedUnits units = DIGUY_SPEED_UNITS_METERS_PER_SECOND);
        float get_default_deceleration(diguySpeedUnits units = DIGUY_SPEED_UNITS_METERS_PER_SECOND);


/*****************************************************************************
 **
 *2  Steering Functions
 **
 **    These functions should only be used in free action mode.
 **
 */

        /*
         *  Documentation Pending
         */
        void set_vehicle_simulation_mode(diguyVehicleSimulationMode vsim_mode);

        /*
         *  Documentation Pending
         */
        diguyVehicleSimulationMode get_vehicle_simulation_mode();

        /*
         *  Documentation Pending
         */
        void set_front_wheels_steer_angle(float angle);

        /*
         *  Documentation Pending
         */
        float get_front_wheels_steer_angle();

        /*
         *  Documentation Pending
         */
        void set_desired_front_wheels_steer_angle(float desired_angle,
                float angle_change_rate = DIGUY_DEFAULT_FLOAT);

        /*
         *  Documentation Pending
         */
        float get_desired_front_wheels_steer_angle();


#ifdef CPLUSPLUS_ONLY

        bdiScenarioVehicleController* get_scripted_object() {return m_scripted_object;}

private:

        /*l
         **  A private constructor.
         */
        diguyVehicleController(bdiScenarioVehicleController* vehicle_controller);

        /*l
         **  A pointer to internal data.
         */
        bdiScenarioVehicleController* m_scripted_object;

        friend class bdiScenarioVehicleController;

#endif

};

#endif /* __diguyVehicleController_H */