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
57 void update (double dt);
59 void insertWayptAtIndex(flightgear::Waypt* aWpt, int aIndex);
60 flightgear::WayptRef removeWayptAtIndex(int index);
65 ROUTE_HIGH_AIRWAYS, ///< high-level airways routing
66 ROUTE_LOW_AIRWAYS, ///< low-level airways routing
67 ROUTE_VOR ///< VOR-VOR routing
71 * Insert waypoints from index-1 to index. In practice this means you can
72 * 'fill in the gaps' between defined waypoints. If index=0, the departure
73 * airport is used as index-1; if index is -1, the destination airport is
74 * used as the final waypoint.
76 bool routeToIndex(int index, RouteType aRouteType);
80 bool isRouteActive() const;
82 int currentIndex() const
83 { return _currentIndex; }
85 flightgear::Waypt* currentWaypt() const;
86 flightgear::Waypt* nextWaypt() const;
87 flightgear::Waypt* previousWaypt() const;
89 const flightgear::WayptVec& waypts() const
93 { return _route.size(); }
95 flightgear::Waypt* wayptAtIndex(int index) const;
97 SGPropertyNode_ptr wayptNodeAtIndex(int index) const;
100 * Find a waypoint in the route, by position, and return its index, or
101 * -1 if no matching waypoint was found in the route.
103 int findWayptIndex(const SGGeod& aPos) const;
106 * Activate a built route. This checks for various mandatory pieces of
107 * data, such as departure and destination airports, and creates waypoints
108 * for them on the route structure.
110 * returns true if the route was activated successfully, or false if the
111 * route could not be activated for some reason
116 * Step to the next waypoint on the active route
121 * Set the current waypoint to the specified index.
123 void jumpToIndex(int index);
125 bool saveRoute(const SGPath& p);
126 bool loadRoute(const SGPath& p);
129 * Helper command to setup current airport/runway if necessary
131 void initAtPosition();
134 * Create a WayPoint from a string in the following format:
135 * - simple identifier
136 * - decimal-lon,decimal-lat
137 * - airport-id/runway-id
138 * - navaid/radial-deg/offset-nm
140 flightgear::WayptRef waypointFromString(const std::string& target);
142 FGAirportRef departureAirport() const;
143 FGAirportRef destinationAirport() const;
145 FGRunway* departureRunway() const;
146 FGRunway* destinationRunway() const;
148 flightgear::WayptVec _route;
152 time_t _touchdownTime;
153 FGAirportRef _departure;
154 FGAirportRef _destination;
157 SGPropertyNode_ptr lon;
158 SGPropertyNode_ptr lat;
159 SGPropertyNode_ptr alt;
160 SGPropertyNode_ptr magvar;
163 SGPropertyNode_ptr departure; ///< departure airport information
164 SGPropertyNode_ptr destination; ///< destination airport information
165 SGPropertyNode_ptr alternate; ///< alternate airport information
166 SGPropertyNode_ptr cruise; ///< cruise information
168 SGPropertyNode_ptr totalDistance;
169 SGPropertyNode_ptr ete;
170 SGPropertyNode_ptr elapsedFlightTime;
172 SGPropertyNode_ptr active;
173 SGPropertyNode_ptr airborne;
175 SGPropertyNode_ptr wp0;
176 SGPropertyNode_ptr wp1;
177 SGPropertyNode_ptr wpn;
180 SGPropertyNode_ptr _pathNode;
181 SGPropertyNode_ptr _currentWpt;
183 /// integer property corresponding to the RouteType enum
184 SGPropertyNode_ptr _routingType;
187 * Signal property to notify people that the route was edited
189 SGPropertyNode_ptr _edited;
192 * Signal property to notify when the last waypoint is reached
194 SGPropertyNode_ptr _finished;
196 void setETAPropertyFromDistance(SGPropertyNode_ptr aProp, double aDistance);
198 class InputListener : public SGPropertyChangeListener {
200 InputListener(FGRouteMgr *m) : mgr(m) {}
201 virtual void valueChanged (SGPropertyNode * prop);
206 SGPropertyNode_ptr input;
207 SGPropertyNode_ptr weightOnWheels;
209 InputListener *listener;
210 SGPropertyNode_ptr mirror;
212 void departureChanged();
213 void buildDeparture(flightgear::WayptRef enroute, flightgear::WayptVec& wps);
215 void arrivalChanged();
216 void buildArrival(flightgear::WayptRef enroute, flightgear::WayptVec& wps);
219 * Helper to keep various pieces of state in sync when the route is
220 * modified (waypoints added, inserted, removed). Notably, this fires the
223 void waypointsChanged();
225 void update_mirror();
227 void currentWaypointChanged();
230 * Parse a route/wp node (from a saved, property-lsit formatted route)
232 void parseRouteWaypoint(SGPropertyNode* aWP);
235 * Check if we've reached the final waypoint.
236 * Returns true if we have.
238 bool checkFinished();
241 bool loadPlainTextRoute(const SGPath& path);
243 void loadVersion1XMLRoute(SGPropertyNode_ptr routeData);
244 void loadVersion2XMLRoute(SGPropertyNode_ptr routeData);
245 void loadXMLRouteHeader(SGPropertyNode_ptr routeData);
246 flightgear::WayptRef parseVersion1XMLWaypt(SGPropertyNode* aWP);
249 * Predicate for helping the UI - test if at least one waypoint was
250 * entered by the user (as opposed to being generated by the route-manager)
252 bool haveUserWaypoints() const;
254 // tied getters and setters
255 const char* getDepartureICAO() const;
256 const char* getDepartureName() const;
257 void setDepartureICAO(const char* aIdent);
259 const char* getDestinationICAO() const;
260 const char* getDestinationName() const;
261 void setDestinationICAO(const char* aIdent);
263 PropertyWatcher* _departureWatcher;
264 PropertyWatcher* _arrivalWatcher;
268 #endif // _ROUTE_MGR_HXX