File diff r10695:3124a970a753 → r10696:8dfe83e30d01
src/ai/api/ai_event_types.hpp
Show inline comments
 
new file 100644
 
/* $Id$ */
 

	
 
/** @file ai_event_types.hpp The detailed types of all events. */
 

	
 
#ifndef AI_EVENT_TYPES_HPP
 
#define AI_EVENT_TYPES_HPP
 

	
 
#include "ai_object.hpp"
 
#include "ai_event.hpp"
 
#include "ai_town.hpp"
 
#include "ai_industry.hpp"
 
#include "ai_engine.hpp"
 
#include "ai_subsidy.hpp"
 

	
 
/**
 
 * Event Test: a simple test event, to see if the event system is working.
 
 *  Triggered via AIEventController::Test();
 
 */
 
class AIEventTest : public AIEvent {
 
public:
 
	static const char *GetClassName() { return "AIEventTest"; }
 

	
 
	/**
 
	 * @param test A test value.
 
	 */
 
	AIEventTest(uint test) :
 
		AIEvent(AI_ET_TEST),
 
		test(test)
 
	{}
 

	
 
	/**
 
	 * Convert an AIEvent to the real instance.
 
	 * @param instance The instance to convert.
 
	 * @return The converted instance.
 
	 */
 
	static AIEventTest *Convert(AIEvent *instance) { return (AIEventTest *)instance; }
 

	
 
	/**
 
	 * Return the test value.
 
	 * @return The test value.
 
	 */
 
	uint GetTest() { return this->test; }
 

	
 
private:
 
	uint test;
 
};
 

	
 
/**
 
 * Event Vehicle Crash, indicating a vehicle of yours is crashed.
 
 *  It contains both the crash site as the vehicle crashed. It has a nice
 
 *  helper that creates a new vehicle in a depot with the same type
 
 *  and orders as the crashed one. In case the vehicle type isn't available
 
 *  anymore, it will find the next best.
 
 */
 
class AIEventVehicleCrashed : public AIEvent {
 
public:
 
	static const char *GetClassName() { return "AIEventVehicleCrashed"; }
 

	
 
	/**
 
	 * @param vehicle The vehicle that crashed.
 
	 * @param crash_site Where the vehicle crashed.
 
	 */
 
	AIEventVehicleCrashed(VehicleID vehicle, TileIndex crash_site) :
 
		AIEvent(AI_ET_VEHICLE_CRASHED),
 
		crash_site(crash_site),
 
		vehicle(vehicle)
 
	{}
 

	
 
	/**
 
	 * Convert an AIEvent to the real instance.
 
	 * @param instance The instance to convert.
 
	 * @return The converted instance.
 
	 */
 
	static AIEventVehicleCrashed *Convert(AIEvent *instance) { return (AIEventVehicleCrashed *)instance; }
 

	
 
	/**
 
	 * Get the VehicleID of the crashed vehicle.
 
	 * @return The crashed vehicle.
 
	 */
 
	VehicleID GetVehicleID() { return vehicle; }
 

	
 
	/**
 
	 * Find the tile the vehicle crashed.
 
	 * @return The crash site.
 
	 */
 
	TileIndex GetCrashSite() { return crash_site; }
 

	
 
	/**
 
	 * Clone the crashed vehicle and send it on its way again.
 
	 * @param depot the depot to build the vehicle in.
 
	 * @return True when the cloning succeeded.
 
	 * @note This function isn't implemented yet.
 
	 */
 
	bool CloneCrashedVehicle(TileIndex depot);
 

	
 
private:
 
	TileIndex crash_site;
 
	VehicleID vehicle;
 
};
 

	
 
/**
 
 * Event Subsidy Offered, indicating someone offered a subsidy.
 
 */
 
class AIEventSubsidyOffer : public AIEvent {
 
public:
 
	static const char *GetClassName() { return "AIEventSubsidyOffer"; }
 

	
 
	/**
 
	 * @param subsidy_id The index of this subsidy in the _subsidies array.
 
	 */
 
	AIEventSubsidyOffer(SubsidyID subsidy_id) :
 
		AIEvent(AI_ET_SUBSIDY_OFFER),
 
		subsidy_id(subsidy_id)
 
	{}
 

	
 
	/**
 
	 * Convert an AIEvent to the real instance.
 
	 * @param instance The instance to convert.
 
	 * @return The converted instance.
 
	 */
 
	static AIEventSubsidyOffer *Convert(AIEvent *instance) { return (AIEventSubsidyOffer *)instance; }
 

	
 
	/**
 
	 * Get the SubsidyID of the subsidy.
 
	 * @return The subsidy id.
 
	 */
 
	SubsidyID GetSubsidyID() { return subsidy_id; }
 

	
 
private:
 
	SubsidyID subsidy_id;
 
};
 

	
 
/**
 
 * Event Subsidy Offer Expired, indicating a subsidy will no longer be awarded.
 
 */
 
class AIEventSubsidyOfferExpired : public AIEvent {
 
public:
 
	static const char *GetClassName() { return "AIEventSubsidyOfferExpired"; }
 

	
 
	/**
 
	 * @param subsidy_id The index of this subsidy in the _subsidies array.
 
	 */
 
	AIEventSubsidyOfferExpired(SubsidyID subsidy_id) :
 
		AIEvent(AI_ET_SUBSIDY_OFFER_EXPIRED),
 
		subsidy_id(subsidy_id)
 
	{}
 

	
 
	/**
 
	 * Convert an AIEvent to the real instance.
 
	 * @param instance The instance to convert.
 
	 * @return The converted instance.
 
	 */
 
	static AIEventSubsidyOfferExpired *Convert(AIEvent *instance) { return (AIEventSubsidyOfferExpired *)instance; }
 

	
 
	/**
 
	 * Get the SubsidyID of the subsidy.
 
	 * @return The subsidy id.
 
	 */
 
	SubsidyID GetSubsidyID() { return subsidy_id; }
 

	
 
private:
 
	SubsidyID subsidy_id;
 
};
 

	
 
/**
 
 * Event Subidy Awarded, indicating a subsidy is awarded to some company.
 
 */
 
class AIEventSubsidyAwarded : public AIEvent {
 
public:
 
	static const char *GetClassName() { return "AIEventSubsidyAwarded"; }
 

	
 
	/**
 
	 * @param subsidy_id The index of this subsidy in the _subsidies array.
 
	 */
 
	AIEventSubsidyAwarded(SubsidyID subsidy_id) :
 
		AIEvent(AI_ET_SUBSIDY_AWARDED),
 
		subsidy_id(subsidy_id)
 
	{}
 

	
 
	/**
 
	 * Convert an AIEvent to the real instance.
 
	 * @param instance The instance to convert.
 
	 * @return The converted instance.
 
	 */
 
	static AIEventSubsidyAwarded *Convert(AIEvent *instance) { return (AIEventSubsidyAwarded *)instance; }
 

	
 
	/**
 
	 * Get the SubsidyID of the subsidy.
 
	 * @return The subsidy id.
 
	 */
 
	SubsidyID GetSubsidyID() { return subsidy_id; }
 

	
 
private:
 
	SubsidyID subsidy_id;
 
};
 

	
 
/**
 
 * Event Subsidy Expired, indicating a route that was once subsidized no longer is.
 
 */
 
class AIEventSubsidyExpired : public AIEvent {
 
public:
 
	static const char *GetClassName() { return "AIEventSubsidyExpired"; }
 

	
 
	/**
 
	 * @param subsidy_id The index of this subsidy in the _subsidies array.
 
	 */
 
	AIEventSubsidyExpired(SubsidyID subsidy_id) :
 
		AIEvent(AI_ET_SUBSIDY_EXPIRED),
 
		subsidy_id(subsidy_id)
 
	{}
 

	
 
	/**
 
	 * Convert an AIEvent to the real instance.
 
	 * @param instance The instance to convert.
 
	 * @return The converted instance.
 
	 */
 
	static AIEventSubsidyExpired *Convert(AIEvent *instance) { return (AIEventSubsidyExpired *)instance; }
 

	
 
	/**
 
	 * Get the SubsidyID of the subsidy.
 
	 * @return The subsidy id.
 
	 */
 
	 SubsidyID GetSubsidyID() { return subsidy_id; }
 

	
 
private:
 
	SubsidyID subsidy_id;
 
};
 

	
 
/**
 
 * Event Engine Preview, indicating a manufacturer offer you to test a new engine.
 
 *  You can get the same information about the offered engine as a real user
 
 *  would see in the offer window. And you can also accept the offer.
 
 */
 
class AIEventEnginePreview : public AIEvent {
 
public:
 
	static const char *GetClassName() { return "AIEventEnginePreview"; }
 

	
 
	/**
 
	 * @param engine The engine offered to test.
 
	 */
 
	AIEventEnginePreview(EngineID engine) :
 
		AIEvent(AI_ET_ENGINE_PREVIEW),
 
		engine(engine)
 
	{}
 

	
 
	/**
 
	 * Convert an AIEvent to the real instance.
 
	 * @param instance The instance to convert.
 
	 * @return The converted instance.
 
	 */
 
	static AIEventEnginePreview *Convert(AIEvent *instance) { return (AIEventEnginePreview *)instance; }
 

	
 
	/**
 
	 * Get the name of the offered engine.
 
	 * @return The name the engine has.
 
	 */
 
	const char *GetName();
 

	
 
	/**
 
	 * Get the cargo-type of the offered engine. In case it can transport 2 cargos, it
 
	 *  returns the first.
 
	 * @return The cargo-type of the engine.
 
	 */
 
	CargoID GetCargoType();
 

	
 
	/**
 
	 * Get the capacity of the offered engine. In case it can transport 2 cargos, it
 
	 *  returns the first.
 
	 * @return The capacity of the engine.
 
	 */
 
	int32 GetCapacity();
 

	
 
	/**
 
	 * Get the maximum speed of the offered engine.
 
	 * @return The maximum speed the engine has.
 
	 * @note The speed is in km/h.
 
	 */
 
	int32 GetMaxSpeed();
 

	
 
	/**
 
	 * Get the new cost of the offered engine.
 
	 * @return The new cost the engine has.
 
	 */
 
	Money GetPrice();
 

	
 
	/**
 
	 * Get the running cost of the offered engine.
 
	 * @return The running cost of the vehicle per year.
 
	 * @note Cost is per year; divide by 364 to get per day.
 
	 */
 
	Money GetRunningCost();
 

	
 
	/**
 
	 * Get the type of the offered engine.
 
	 * @return The type the engine has.
 
	 */
 
	AIVehicle::VehicleType GetVehicleType();
 

	
 
	/**
 
	 * Accept the engine preview.
 
	 * @return True when the accepting succeeded.
 
	 */
 
	bool AcceptPreview();
 

	
 
private:
 
	EngineID engine;
 
};
 

	
 
/**
 
 * Event Company New, indicating a new company has been created.
 
 */
 
class AIEventCompanyNew : public AIEvent {
 
public:
 
	static const char *GetClassName() { return "AIEventCompanyNew"; }
 

	
 
	/**
 
	 * @param owner The new company.
 
	 */
 
	AIEventCompanyNew(Owner owner) :
 
		AIEvent(AI_ET_COMPANY_NEW),
 
		owner((AICompany::CompanyID)(byte)owner)
 
	{}
 

	
 
	/**
 
	 * Convert an AIEvent to the real instance.
 
	 * @param instance The instance to convert.
 
	 * @return The converted instance.
 
	 */
 
	static AIEventCompanyNew *Convert(AIEvent *instance) { return (AIEventCompanyNew *)instance; }
 

	
 
	/**
 
	 * Get the CompanyID of the company that has been created.
 
	 * @return The CompanyID of the company.
 
	 */
 
	AICompany::CompanyID GetCompanyID() { return owner; }
 

	
 
private:
 
	AICompany::CompanyID owner;
 
};
 

	
 
/**
 
 * Event Company In Trouble, indicating a company is in trouble and might go
 
 *  bankrupt soon.
 
 */
 
class AIEventCompanyInTrouble : public AIEvent {
 
public:
 
	static const char *GetClassName() { return "AIEventCompanyInTrouble"; }
 

	
 
	/**
 
	 * @param owner The company that is in trouble.
 
	 */
 
	AIEventCompanyInTrouble(Owner owner) :
 
		AIEvent(AI_ET_COMPANY_IN_TROUBLE),
 
		owner((AICompany::CompanyID)(byte)owner)
 
	{}
 

	
 
	/**
 
	 * Convert an AIEvent to the real instance.
 
	 * @param instance The instance to convert.
 
	 * @return The converted instance.
 
	 */
 
	static AIEventCompanyInTrouble *Convert(AIEvent *instance) { return (AIEventCompanyInTrouble *)instance; }
 

	
 
	/**
 
	 * Get the CompanyID of the company that is in trouble.
 
	 * @return The CompanyID of the company in trouble.
 
	 */
 
	AICompany::CompanyID GetCompanyID() { return owner; }
 

	
 
private:
 
	AICompany::CompanyID owner;
 
};
 

	
 
/**
 
 * Event Company Merger, indicating a company has been bought by another
 
 *  company.
 
 */
 
class AIEventCompanyMerger : public AIEvent {
 
public:
 
	static const char *GetClassName() { return "AIEventCompanyMerger"; }
 

	
 
	/**
 
	 * @param old_owner The company bought off.
 
	 * @param new_owner The company that bougth owner.
 
	 */
 
	AIEventCompanyMerger(Owner old_owner, Owner new_owner) :
 
		AIEvent(AI_ET_COMPANY_MERGER),
 
		old_owner((AICompany::CompanyID)(byte)old_owner),
 
		new_owner((AICompany::CompanyID)(byte)new_owner)
 
	{}
 

	
 
	/**
 
	 * Convert an AIEvent to the real instance.
 
	 * @param instance The instance to convert.
 
	 * @return The converted instance.
 
	 */
 
	static AIEventCompanyMerger *Convert(AIEvent *instance) { return (AIEventCompanyMerger *)instance; }
 

	
 
	/**
 
	 * Get the CompanyID of the company that has been bought.
 
	 * @return The CompanyID of the company that has been bought.
 
	 * @note: The value below is not valid anymore as CompanyID, and
 
	 *  AICompany::ResolveCompanyID will return INVALID_COMPANY. It's
 
	 *  only usefull if you're keeping track of company's yourself.
 
	 */
 
	AICompany::CompanyID GetOldCompanyID() { return old_owner; }
 

	
 
	/**
 
	 * Get the CompanyID of the new owner.
 
	 * @return The CompanyID of the new owner.
 
	 */
 
	AICompany::CompanyID GetNewCompanyID() { return new_owner; }
 

	
 
private:
 
	AICompany::CompanyID old_owner;
 
	AICompany::CompanyID new_owner;
 
};
 

	
 
/**
 
 * Event Company Bankrupt, indicating a company has gone bankrupt.
 
 */
 
class AIEventCompanyBankrupt : public AIEvent {
 
public:
 
	static const char *GetClassName() { return "AIEventCompanyBankrupt"; }
 

	
 
	/**
 
	 * @param owner The company that has gone bankrupt.
 
	 */
 
	AIEventCompanyBankrupt(Owner owner) :
 
		AIEvent(AI_ET_COMPANY_BANKRUPT),
 
		owner((AICompany::CompanyID)(byte)owner)
 
	{}
 

	
 
	/**
 
	 * Convert an AIEvent to the real instance.
 
	 * @param instance The instance to convert.
 
	 * @return The converted instance.
 
	 */
 
	static AIEventCompanyBankrupt *Convert(AIEvent *instance) { return (AIEventCompanyBankrupt *)instance; }
 

	
 
	/**
 
	 * Get the CompanyID of the company that has gone bankrupt.
 
	 * @return The CompanyID of the company that has gone bankrupt.
 
	 */
 
	AICompany::CompanyID GetCompanyID() { return owner; }
 

	
 
private:
 
	AICompany::CompanyID owner;
 
};
 

	
 
/**
 
 * Event Vehicle Lost, indicating a vehicle can't find its way to its destination.
 
 */
 
class AIEventVehicleLost : public AIEvent {
 
public:
 
	static const char *GetClassName() { return "AIEventVehicleLost"; }
 

	
 
	/**
 
	 * @param vehicle_id The vehicle that is lost.
 
	 */
 
	AIEventVehicleLost(VehicleID vehicle_id) :
 
		AIEvent(AI_ET_VEHICLE_LOST),
 
		vehicle_id(vehicle_id)
 
	{}
 

	
 
	/**
 
	 * Convert an AIEvent to the real instance.
 
	 * @param instance The instance to convert.
 
	 * @return The converted instance.
 
	 */
 
	static AIEventVehicleLost *Convert(AIEvent *instance) { return (AIEventVehicleLost *)instance; }
 

	
 
	/**
 
	 * Get the VehicleID of the vehicle that is lost.
 
	 * @return The VehicleID of the vehicle that is lost.
 
	 */
 
	VehicleID GetVehicleID() { return vehicle_id; }
 

	
 
private:
 
	VehicleID vehicle_id;
 
};
 

	
 
/**
 
 * Event VehicleWaitingInDepot, indicating a vehicle has arrived a depot and is now waiting there.
 
 */
 
class AIEventVehicleWaitingInDepot : public AIEvent {
 
public:
 
	static const char *GetClassName() { return "AIEventVehicleWaitingInDepot"; }
 

	
 
	/**
 
	 * @param vehicle_id The vehicle that is waiting in a depot.
 
	 */
 
	AIEventVehicleWaitingInDepot(VehicleID vehicle_id) :
 
		AIEvent(AI_ET_VEHICLE_WAITING_IN_DEPOT),
 
		vehicle_id(vehicle_id)
 
	{}
 

	
 
	/**
 
	 * Convert an AIEvent to the real instance.
 
	 * @param instance The instance to convert.
 
	 * @return The converted instance.
 
	 */
 
	static AIEventVehicleWaitingInDepot *Convert(AIEvent *instance) { return (AIEventVehicleWaitingInDepot *)instance; }
 

	
 
	/**
 
	 * Get the VehicleID of the vehicle that is waiting in a depot.
 
	 * @return The VehicleID of the vehicle that is waiting in a depot.
 
	 */
 
	VehicleID GetVehicleID() { return vehicle_id; }
 

	
 
private:
 
	VehicleID vehicle_id;
 
};
 

	
 
/**
 
 * Event Vehicle Unprofitable, indicating a vehicle lost money last year.
 
 */
 
class AIEventVehicleUnprofitable : public AIEvent {
 
public:
 
	static const char *GetClassName() { return "AIEventVehicleUnprofitable"; }
 

	
 
	/**
 
	 * @param vehicle_id The vehicle that was unprofitable.
 
	 */
 
	AIEventVehicleUnprofitable(VehicleID vehicle_id) :
 
		AIEvent(AI_ET_VEHICLE_UNPROFITABLE),
 
		vehicle_id(vehicle_id)
 
	{}
 

	
 
	/**
 
	 * Convert an AIEvent to the real instance.
 
	 * @param instance The instance to convert.
 
	 * @return The converted instance.
 
	 */
 
	static AIEventVehicleUnprofitable *Convert(AIEvent *instance) { return (AIEventVehicleUnprofitable *)instance; }
 

	
 
	/**
 
	 * Get the VehicleID of the vehicle that lost money.
 
	 * @return The VehicleID of the vehicle that lost money.
 
	 */
 
	VehicleID GetVehicleID() { return vehicle_id; }
 

	
 
private:
 
	VehicleID vehicle_id;
 
};
 

	
 
/**
 
 * Event Industry Open, indicating a new industry has been created.
 
 */
 
class AIEventIndustryOpen : public AIEvent {
 
public:
 
	static const char *GetClassName() { return "AIEventIndustryOpen"; }
 

	
 
	/**
 
	 * @param industry_id The new industry.
 
	 */
 
	AIEventIndustryOpen(IndustryID industry_id) :
 
		AIEvent(AI_ET_INDUSTRY_OPEN),
 
		industry_id(industry_id)
 
	{}
 

	
 
	/**
 
	 * Convert an AIEvent to the real instance.
 
	 * @param instance The instance to convert.
 
	 * @return The converted instance.
 
	 */
 
	static AIEventIndustryOpen *Convert(AIEvent *instance) { return (AIEventIndustryOpen *)instance; }
 

	
 
	/**
 
	 * Get the IndustryID of the new industry.
 
	 * @return The IndustryID of the industry.
 
	 */
 
	IndustryID GetIndustryID() { return industry_id; }
 

	
 
private:
 
	IndustryID industry_id;
 
};
 

	
 
/**
 
 * Event Industry Close, indicating an industry is going to be closed.
 
 */
 
class AIEventIndustryClose : public AIEvent {
 
public:
 
	static const char *GetClassName() { return "AIEventIndustryClose"; }
 

	
 
	/**
 
	 * @param industry_id The new industry.
 
	 */
 
	AIEventIndustryClose(IndustryID industry_id) :
 
		AIEvent(AI_ET_INDUSTRY_CLOSE),
 
		industry_id(industry_id)
 
	{}
 

	
 
	/**
 
	 * Convert an AIEvent to the real instance.
 
	 * @param instance The instance to convert.
 
	 * @return The converted instance.
 
	 */
 
	static AIEventIndustryClose *Convert(AIEvent *instance) { return (AIEventIndustryClose *)instance; }
 

	
 
	/**
 
	 * Get the IndustryID of the closing industry.
 
	 * @return The IndustryID of the industry.
 
	 */
 
	IndustryID GetIndustryID() { return industry_id; }
 

	
 
private:
 
	IndustryID industry_id;
 
};
 

	
 
/**
 
 * Event Engine Available, indicating a new engine is available.
 
 */
 
class AIEventEngineAvailable : public AIEvent {
 
public:
 
	static const char *GetClassName() { return "AIEventEngineAvailable"; }
 

	
 
	/**
 
	 * @param engine The engine that is available.
 
	 */
 
	AIEventEngineAvailable(EngineID engine) :
 
		AIEvent(AI_ET_ENGINE_AVAILABLE),
 
		engine(engine)
 
	{}
 

	
 
	/**
 
	 * Convert an AIEvent to the real instance.
 
	 * @param instance The instance to convert.
 
	 * @return The converted instance.
 
	 */
 
	static AIEventEngineAvailable *Convert(AIEvent *instance) { return (AIEventEngineAvailable *)instance; }
 

	
 
	/**
 
	 * Get the EngineID of the new engine.
 
	 * @return The EngineID of the new engine.
 
	 */
 
	EngineID GetEngineID() { return engine; }
 

	
 
private:
 
	EngineID engine;
 
};
 

	
 
/**
 
 * Event Station First Vehicle, indicating a station has been visited by a vehicle for the first time.
 
 */
 
class AIEventStationFirstVehicle : public AIEvent {
 
public:
 
	static const char *GetClassName() { return "AIEventStationFirstVehicle"; }
 

	
 
	/**
 
	 * @param station The station visited for the first time.
 
	 * @param vehicle The vehicle visiting the station.
 
	 */
 
	AIEventStationFirstVehicle(StationID station, VehicleID vehicle) :
 
		AIEvent(AI_ET_STATION_FIRST_VEHICLE),
 
		station(station),
 
		vehicle(vehicle)
 
	{}
 

	
 
	/**
 
	 * Convert an AIEvent to the real instance.
 
	 * @param instance The instance to convert.
 
	 * @return The converted instance.
 
	 */
 
	static AIEventStationFirstVehicle *Convert(AIEvent *instance) { return (AIEventStationFirstVehicle *)instance; }
 

	
 
	/**
 
	 * Get the StationID of the visited station.
 
	 * @return The StationID of the visited station.
 
	 */
 
	StationID GetStationID() { return station; }
 

	
 
	/**
 
	 * Get the VehicleID of the first vehicle.
 
	 * @return The VehicleID of the first vehicle.
 
	 */
 
	VehicleID GetVehicleID() { return vehicle; }
 

	
 
private:
 
	StationID station;
 
	VehicleID vehicle;
 
};
 

	
 
#endif /* AI_EVENT_TYPES_HPP */