1 // route_mgr.hxx - manage a route (i.e. a collection of waypoints)
3 // Written by Curtis Olson, started January 2004.
5 // Copyright (C) 2004 Curtis L. Olson - http://www.flightgear.org/~curt
7 // This program is free software; you can redistribute it and/or
8 // modify it under the terms of the GNU General Public License as
9 // published by the Free Software Foundation; either version 2 of the
10 // License, or (at your option) any later version.
12 // This program is distributed in the hope that it will be useful, but
13 // WITHOUT ANY WARRANTY; without even the implied warranty of
14 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 // General Public License for more details.
17 // You should have received a copy of the GNU General Public License
18 // along with this program; if not, write to the Free Software
19 // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
24 #ifndef _ROUTE_MGR_HXX
25 #define _ROUTE_MGR_HXX 1
27 #include <simgear/props/props.hxx>
28 #include <simgear/route/waypoint.hxx>
29 #include <simgear/structure/subsystem_mgr.hxx>
31 #include <Navaids/route.hxx>
35 class PropertyWatcher;
40 typedef SGSharedPtr<FGAirport> FGAirportRef;
43 * Top level route manager class
47 class FGRouteMgr : public SGSubsystem,
48 public flightgear::FlightPlan::Delegate
58 void update (double dt);
61 ROUTE_HIGH_AIRWAYS, ///< high-level airways routing
62 ROUTE_LOW_AIRWAYS, ///< low-level airways routing
63 ROUTE_VOR ///< VOR-VOR routing
67 * Insert waypoints from index-1 to index. In practice this means you can
68 * 'fill in the gaps' between defined waypoints. If index=0, the departure
69 * airport is used as index-1; if index is -1, the destination airport is
70 * used as the final waypoint.
72 bool routeToIndex(int index, RouteType aRouteType);
74 bool isRouteActive() const;
76 int currentIndex() const;
78 void setFlightPlan(flightgear::FlightPlan* plan);
79 flightgear::FlightPlan* flightPlan() const;
83 flightgear::Waypt* currentWaypt() const;
92 flightgear::Waypt* wayptAtIndex(int index) const;
94 SGPropertyNode_ptr wayptNodeAtIndex(int index) const;
96 void removeLegAtIndex(int aIndex);
99 * Activate a built route. This checks for various mandatory pieces of
100 * data, such as departure and destination airports, and creates waypoints
101 * for them on the route structure.
103 * returns true if the route was activated successfully, or false if the
104 * route could not be activated for some reason
109 * Step to the next waypoint on the active route
114 * Set the current waypoint to the specified index.
116 void jumpToIndex(int index);
118 bool saveRoute(const SGPath& p);
119 bool loadRoute(const SGPath& p);
121 flightgear::WayptRef waypointFromString(const std::string& target);
124 * Helper command to setup current airport/runway if necessary
126 void initAtPosition();
129 flightgear::FlightPlan* _plan;
132 time_t _touchdownTime;
135 SGPropertyNode_ptr magvar;
138 SGPropertyNode_ptr departure; ///< departure airport information
139 SGPropertyNode_ptr destination; ///< destination airport information
140 SGPropertyNode_ptr alternate; ///< alternate airport information
141 SGPropertyNode_ptr cruise; ///< cruise information
143 SGPropertyNode_ptr totalDistance;
144 SGPropertyNode_ptr distanceToGo;
145 SGPropertyNode_ptr ete;
146 SGPropertyNode_ptr elapsedFlightTime;
148 SGPropertyNode_ptr active;
149 SGPropertyNode_ptr airborne;
151 SGPropertyNode_ptr wp0;
152 SGPropertyNode_ptr wp1;
153 SGPropertyNode_ptr wpn;
156 SGPropertyNode_ptr _pathNode;
157 SGPropertyNode_ptr _currentWpt;
159 /// integer property corresponding to the RouteType enum
160 SGPropertyNode_ptr _routingType;
163 * Signal property to notify people that the route was edited
165 SGPropertyNode_ptr _edited;
168 * Signal property to notify when the last waypoint is reached
170 SGPropertyNode_ptr _finished;
172 SGPropertyNode_ptr _flightplanChanged;
174 void setETAPropertyFromDistance(SGPropertyNode_ptr aProp, double aDistance);
177 * retrieve the cached path distance along a leg
179 double cachedLegPathDistanceM(int index) const;
180 double cachedWaypointPathTotalDistance(int index) const;
182 class InputListener : public SGPropertyChangeListener {
184 InputListener(FGRouteMgr *m) : mgr(m) {}
185 virtual void valueChanged (SGPropertyNode * prop);
190 SGPropertyNode_ptr input;
191 SGPropertyNode_ptr weightOnWheels;
192 SGPropertyNode_ptr groundSpeed;
194 InputListener *listener;
195 SGPropertyNode_ptr mirror;
197 virtual void departureChanged();
198 void buildDeparture(flightgear::WayptRef enroute, flightgear::WayptVec& wps);
200 virtual void arrivalChanged();
201 void buildArrival(flightgear::WayptRef enroute, flightgear::WayptVec& wps);
204 * Helper to keep various pieces of state in sync when the route is
205 * modified (waypoints added, inserted, removed). Notably, this fires the
208 virtual void waypointsChanged();
210 void update_mirror();
212 virtual void currentWaypointChanged();
215 * Check if we've reached the final waypoint.
216 * Returns true if we have.
218 bool checkFinished();
221 * Predicate for helping the UI - test if at least one waypoint was
222 * entered by the user (as opposed to being generated by the route-manager)
224 bool haveUserWaypoints() const;
226 // tied getters and setters
227 const char* getDepartureICAO() const;
228 const char* getDepartureName() const;
229 void setDepartureICAO(const char* aIdent);
231 const char* getDepartureRunway() const;
232 void setDepartureRunway(const char* aIdent);
234 const char* getSID() const;
235 void setSID(const char* aIdent);
237 const char* getDestinationICAO() const;
238 const char* getDestinationName() const;
239 void setDestinationICAO(const char* aIdent);
241 const char* getDestinationRunway() const;
242 void setDestinationRunway(const char* aIdent);
244 const char* getApproach() const;
245 void setApproach(const char* aIdent);
247 const char* getSTAR() const;
248 void setSTAR(const char* aIdent);
250 double getDepartureFieldElevation() const;
251 double getDestinationFieldElevation() const;
255 #endif // _ROUTE_MGR_HXX