OpenTTD AI API 20251231-master-g2a6798cc43
Public Member Functions | Static Public Member Functions
AIEventEnginePreview Class Reference

Event Engine Preview, indicating a manufacturer offer you to test a new engine. More...

#include <script_event_types.hpp>

Inheritance diagram for AIEventEnginePreview:
AIEvent

Public Member Functions

string GetName () const
 Get the name of the offered engine.
 
CargoType GetCargoType () const
 Get the cargo-type of the offered engine.
 
int GetCapacity () const
 Get the capacity of the offered engine.
 
int GetMaxSpeed () const
 Get the maximum speed of the offered engine.
 
Money GetPrice () const
 Get the new cost of the offered engine.
 
Money GetRunningCost () const
 Get the running cost of the offered engine.
 
AIVehicle::VehicleType GetVehicleType () const
 Get the type of the offered engine.
 
bool AcceptPreview ()
 Accept the engine preview.
 
- Public Member Functions inherited from AIEvent
AIEventType GetEventType () const
 Get the event-type.
 

Static Public Member Functions

static AIEventEnginePreviewConvert (AIEvent *instance)
 Convert an AIEvent to the real instance.
 

Additional Inherited Members

- Public Types inherited from AIEvent
enum  AIEventType {
  ET_INVALID ,
  ET_TEST ,
  ET_SUBSIDY_OFFER ,
  ET_SUBSIDY_OFFER_EXPIRED ,
  ET_SUBSIDY_AWARDED ,
  ET_SUBSIDY_EXPIRED ,
  ET_ENGINE_PREVIEW ,
  ET_COMPANY_NEW ,
  ET_COMPANY_IN_TROUBLE ,
  ET_COMPANY_ASK_MERGER ,
  ET_COMPANY_MERGER ,
  ET_COMPANY_BANKRUPT ,
  ET_VEHICLE_CRASHED ,
  ET_VEHICLE_LOST ,
  ET_VEHICLE_WAITING_IN_DEPOT ,
  ET_VEHICLE_UNPROFITABLE ,
  ET_INDUSTRY_OPEN ,
  ET_INDUSTRY_CLOSE ,
  ET_ENGINE_AVAILABLE ,
  ET_STATION_FIRST_VEHICLE ,
  ET_DISASTER_ZEPPELINER_CRASHED ,
  ET_DISASTER_ZEPPELINER_CLEARED ,
  ET_TOWN_FOUNDED ,
  ET_AIRCRAFT_DEST_TOO_FAR ,
  ET_ADMIN_PORT ,
  ET_WINDOW_WIDGET_CLICK ,
  ET_GOAL_QUESTION_ANSWER ,
  ET_EXCLUSIVE_TRANSPORT_RIGHTS ,
  ET_ROAD_RECONSTRUCTION ,
  ET_VEHICLE_AUTOREPLACED ,
  ET_STORYPAGE_BUTTON_CLICK ,
  ET_STORYPAGE_TILE_SELECT ,
  ET_STORYPAGE_VEHICLE_SELECT ,
  ET_COMPANY_RENAMED ,
  ET_PRESIDENT_RENAMED
}
 The type of event. More...
 

Detailed Description

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.

Member Function Documentation

◆ AcceptPreview()

bool AIEventEnginePreview::AcceptPreview ( )

Accept the engine preview.

Returns
True when the accepting succeeded.

◆ Convert()

static AIEventEnginePreview * AIEventEnginePreview::Convert ( AIEvent instance)
inlinestatic

Convert an AIEvent to the real instance.

Parameters
instanceThe instance to convert.
Returns
The converted instance.

◆ GetCapacity()

int AIEventEnginePreview::GetCapacity ( ) const

Get the capacity of the offered engine.

In case it can transport multiple cargoes, it returns the first/main.

Returns
The capacity of the engine.

◆ GetCargoType()

CargoType AIEventEnginePreview::GetCargoType ( ) const

Get the cargo-type of the offered engine.

In case it can transport multiple cargoes, it returns the first/main.

Returns
The cargo-type of the engine.

◆ GetMaxSpeed()

int AIEventEnginePreview::GetMaxSpeed ( ) const

Get the maximum speed of the offered engine.

Returns
The maximum speed the engine has.
Note
The speed is in OpenTTD's internal speed unit. This is mph / 1.6, which is roughly km/h. To get km/h multiply this number by 1.00584.

◆ GetName()

string AIEventEnginePreview::GetName ( ) const

Get the name of the offered engine.

Returns
The name the engine has.

◆ GetPrice()

Money AIEventEnginePreview::GetPrice ( ) const

Get the new cost of the offered engine.

Returns
The new cost the engine has.

◆ GetRunningCost()

Money AIEventEnginePreview::GetRunningCost ( ) const

Get the running cost of the offered engine.

Returns
The running cost of the vehicle per economy-year.
See also
AIEconomyTime

◆ GetVehicleType()

AIVehicle::VehicleType AIEventEnginePreview::GetVehicleType ( ) const

Get the type of the offered engine.

Returns
The type the engine has.