openrw/rwengine/include/ai/CharacterController.hpp

#pragma once
#ifndef _CHARACTERCONTROLLER_HPP_
#define _CHARACTERCONTROLLER_HPP_
#include <glm/glm.hpp>
#include <glm/gtc/quaternion.hpp>
#include <string>

class CharacterObject;
class VehicleObject;

/**
 * @class CharacterController
 * Character Controller Interface, translates high-level behaviours into low level actions.
 */
class CharacterController
{
public:

	/**
	 * @brief The Activity struct interface
	 */
	struct Activity {

		virtual ~Activity() {}

		virtual std::string name() const = 0;

		virtual bool update(CharacterObject* character, CharacterController* controller) = 0;
	};
	
	/**
	 * Available AI goals.
	 */
	enum Goal
	{
		/**
		 * No goal, will idle or execute external Activities.
		 */
		None,
		/**
		 * Keep close to leader character
		 */
		FollowLeader
	};

protected:
	
	/**
	 * The character being controlled.
	 */
	CharacterObject* character;

	Activity* _currentActivity;
	Activity* _nextActivity;

	bool updateActivity();
	void setActivity(Activity* activity);

	glm::vec3 rawMovement;

	bool running;
	
	float vehicleIdle;
	
	// Goal related variables
	Goal currentGoal;
	CharacterObject* leader;

public:
	
	CharacterController(CharacterObject* character);

	virtual ~CharacterController() { }

	Activity* getCurrentActivity() { return _currentActivity; }

	Activity* getNextActivity() { return _nextActivity; }

	/**
	 * @brief skipActivity Cancel the current activity, immediatley.
	 */
	void skipActivity();

	/**
	 * @brief setNextActivity Sets the next Activity with a parameter.
	 * @param activity
	 * @param position
	 */
	void setNextActivity( Activity* activity );
	
	/**
	 * @brief update Updates the controller.
	 * @param dt
	 */
	virtual void update(float dt);

	virtual glm::vec3 getTargetPosition() = 0;

	/**
	 * Uses the character's active item.
	 * @param primary use the primary action.
	 */
	void useItem(bool active, bool primary = true);

	/**
	 * @brief
	 * @return Returns the Character Object
	 */
	CharacterObject* getCharacter() const;

	void setRawMovement(const glm::vec3& movement);

	void setRunning(bool run);
	
	void setGoal(Goal goal) { currentGoal = goal; }
	Goal getGoal() const { return currentGoal; }
	
	void setTargetCharacter(CharacterObject* c) { leader = c; }
	CharacterObject* getTargetCharacter() const { return leader; }
};

#define DECL_ACTIVITY( activity_name ) \
	std::string name() const { return #activity_name; }

// TODO: Refactor this with an ugly macro to reduce code dup.
class WeaponItem;

/**
 * @brief Activities for CharacterController behaviour
 *
 * @todo Move into ControllerActivities.hpp or equivelant
 */
namespace Activities {
	struct GoTo : public CharacterController::Activity {
		DECL_ACTIVITY( GoTo )

		glm::vec3 target;

		GoTo( const glm::vec3& target )
			: target( target ) {}

		bool update(CharacterObject* character, CharacterController* controller);
	};
	
	struct Jump : public CharacterController::Activity
	{
		DECL_ACTIVITY( Jump )
		
		bool jumped;
		
		Jump() : jumped(false) {}
		
		bool update(CharacterObject* character, CharacterController* controller);
	};

	struct EnterVehicle : public CharacterController::Activity {
		DECL_ACTIVITY( EnterVehicle )

		VehicleObject* vehicle;
		int seat;
		
		enum {
			ANY_SEAT = -1 // Magic number for any seat but the driver's.
		};

		bool entering;

		EnterVehicle( VehicleObject* vehicle, int seat = 0 )
			: vehicle( vehicle ), seat( seat ), entering(false) {}

		bool update(CharacterObject *character, CharacterController *controller);
	};

	struct ExitVehicle : public CharacterController::Activity {
		DECL_ACTIVITY( ExitVehicle )

		ExitVehicle( )
			{}

		bool update(CharacterObject *character, CharacterController *controller);
	};

	struct ShootWeapon : public CharacterController::Activity {
		DECL_ACTIVITY( ShootWeapon )

		WeaponItem* _item;
		bool _fired;

		ShootWeapon( WeaponItem* item )
			: _item(item), _fired(false) {}

		bool update(CharacterObject *character, CharacterController *controller);
	};
}

#endif