source/libr2c2/trainrouter.h

   1 #ifndef LIBR2C2_TRAINROUTER_H_
   2 #define LIBR2C2_TRAINROUTER_H_
   3
   4 #include <list>
   5 #include <msp/datafile/objectloader.h>
   6 #include "trackchain.h"
   7 #include "trainai.h"
   8
   9 namespace R2C2 {
  10
  11 class Block;
  12 class Layout;
  13 class Track;
  14 class TrainRouteMetric;
  15 class TrainRoutePlanner;
  16
  17 class TrainRouter: public TrainAI
  18 {
  19 public:
  20         class Loader: public Msp::DataFile::ObjectLoader<TrainRouter>
  21         {
  22         public:
  23                 Loader(TrainRouter &);
  24         private:
  25                 void route(const std::string &);
  26         };
  27
  28         struct Waypoint
  29         {
  30                 const TrackChain *chain;
  31                 TrackChain::Direction direction;
  32
  33                 Waypoint(const TrackChain &, TrackChain::Direction = TrackChain::UNSPECIFIED);
  34         };
  35
  36         struct SequencePoint
  37         {
  38                 Block *block;
  39                 Train *preceding_train;
  40                 unsigned sequence_in;
  41                 unsigned sequence_out;
  42
  43                 SequencePoint(Block &, unsigned);
  44
  45                 bool is_cleared() const;
  46         };
  47
  48 private:
  49         typedef std::list<const Route *> RouteList;
  50
  51         enum TravelState
  52         {
  53                 ON_THE_WAY,
  54                 WAITING_FOR_SEQUENCE,
  55                 SEQUENCE_CHECK_PENDING,
  56                 RESERVED_TO_END,
  57                 ADVANCED_TO_END,
  58                 ARRIVED
  59         };
  60
  61 public:
  62         sigc::signal<void, const Route *> signal_route_changed;
  63         sigc::signal<void> signal_departed;
  64         sigc::signal<void, const TrackChain *> signal_arrived;
  65         sigc::signal<void, const TrackChain *> signal_waypoint_reached;
  66
  67 private:
  68         int priority;
  69         RouteList routes;
  70         RouteList::iterator reserving_route;
  71         TravelState state;
  72         std::vector<Waypoint> waypoints;
  73         bool waypoints_changed;
  74         std::vector<TrainRouteMetric *> metrics;
  75         bool metrics_stale;
  76         std::list<SequencePoint> sequence_points;
  77         unsigned current_sequence;
  78         Msp::Time::TimeDelta delay;
  79         Msp::Time::TimeDelta duration;
  80         Msp::RefPtr<TrainRoutePlanner> planner;
  81
  82 public:
  83         TrainRouter(Train &);
  84         ~TrainRouter();
  85
  86         void set_priority(int);
  87         int get_priority() const { return priority; }
  88
  89         bool set_route(const Route *);
  90         const Route *get_route() const;
  91         unsigned get_current_sequence() const { return current_sequence; }
  92 private:
  93         void use_planned_route();
  94         void route_changed();
  95
  96 public:
  97         void set_destination(const TrackChain &);
  98         const TrackChain *get_destination() const { return waypoints.empty() ? 0 : waypoints.back().chain; }
  99         void add_waypoint(const TrackChain &, TrackChain::Direction = TrackChain::UNSPECIFIED);
 100         unsigned get_n_waypoints() const { return waypoints.size(); }
 101         const Waypoint &get_waypoint(unsigned) const;
 102         const TrainRouteMetric &get_metric(int = -1) const;
 103         void set_departure_delay(const Msp::Time::TimeDelta &);
 104         const Msp::Time::TimeDelta &get_departure_delay() const { return delay; }
 105         void set_trip_duration(const Msp::Time::TimeDelta &);
 106         const Msp::Time::TimeDelta &get_trip_duration() const { return duration; }
 107
 108         virtual void message(const Message &);
 109         virtual void tick(const Msp::Time::TimeDelta &);
 110
 111         void save(std::list<Msp::DataFile::Statement> &) const;
 112
 113 private:
 114         void block_reserved(Block &, Train *);
 115         void train_advanced(Block &);
 116         void train_rear_advanced(Block &);
 117
 118         void create_metrics();
 119         bool create_lead_route();
 120         bool advance_to_track(RouteList::iterator &, const TrackIter &);
 121
 122         static void get_routers(Layout &, std::vector<TrainRouter *> &, TrainRoutePlanner * = 0);
 123         static void start_planning(Layout &);
 124         static void apply_plan(Layout &, TrainRoutePlanner &);
 125 };
 126
 127 } // namespace R2C2
 128
 129 #endif