1 // positioned.hxx - base class for objects which are positioned
3 // Copyright (C) 2008 James Turner
5 // This program is free software; you can redistribute it and/or
6 // modify it under the terms of the GNU General Public License as
7 // published by the Free Software Foundation; either version 2 of the
8 // License, or (at your option) any later version.
10 // This program is distributed in the hope that it will be useful, but
11 // WITHOUT ANY WARRANTY; without even the implied warranty of
12 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 // General Public License for more details.
15 // You should have received a copy of the GNU General Public License
16 // along with this program; if not, write to the Free Software
17 // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
21 #ifndef FG_POSITIONED_HXX
22 #define FG_POSITIONED_HXX
28 #include <simgear/sg_inlines.h>
29 #include <simgear/structure/SGSharedPtr.hxx>
30 #include <simgear/math/SGMath.hxx>
33 typedef SGSharedPtr<FGPositioned> FGPositionedRef;
35 typedef int64_t PositionedID;
36 typedef std::vector<PositionedID> PositionedIDVec;
38 namespace flightgear { class NavDataCache; }
40 class FGPositioned : public SGReferenced
63 /// important that DME & TACAN are adjacent to keep the TacanFilter
64 /// efficient - DMEs are proxies for TACAN/VORTAC stations
69 /// an actual airport tower - not a radio comms facility!
70 /// some airports have multiple towers, eg EHAM, although our data source
71 /// doesn't necessarily include them
82 PARKING, ///< parking position - might be a gate, or stand
92 typedef std::vector<FGPositionedRef> List;
94 virtual ~FGPositioned();
99 const std::string& ident() const
103 * Return the name of this positioned. By default this is the same as the
104 * ident, but for many derived classes it's more meaningful - the aiport or
105 * navaid name, for example.
107 virtual const std::string& name() const
110 const SGGeod& geod() const
111 { return mPosition; }
113 PositionedID guid() const
117 * The cartesian position associated with this object
119 const SGVec3d& cart() const;
121 double latitude() const
122 { return mPosition.getLatitudeDeg(); }
124 double longitude() const
125 { return mPosition.getLongitudeDeg(); }
127 double elevation() const
128 { return mPosition.getElevationFt(); }
131 * Predicate class to support custom filtering of FGPositioned queries
132 * Default implementation of this passes any FGPositioned instance.
137 virtual ~Filter() { ; }
140 * Over-rideable filter method. Default implementation returns true.
142 virtual bool pass(FGPositioned* aPos) const
145 virtual Type minType() const
148 virtual Type maxType() const
152 bool operator()(FGPositioned* aPos) const
153 { return pass(aPos); }
156 class TypeFilter : public Filter
159 TypeFilter(Type aTy);
160 virtual bool pass(FGPositioned* aPos) const;
162 virtual Type minType() const
165 virtual Type maxType() const
168 void addType(Type aTy);
170 std::vector<Type> types;
171 Type mMinType, mMaxType;
174 static List findWithinRange(const SGGeod& aPos, double aRangeNm, Filter* aFilter = NULL);
176 static List findWithinRangePartial(const SGGeod& aPos, double aRangeNm, Filter* aFilter, bool& aPartial);
178 static FGPositionedRef findClosestWithIdent(const std::string& aIdent, const SGGeod& aPos, Filter* aFilter = NULL);
180 static FGPositionedRef findFirstWithIdent(const std::string& aIdent, Filter* aFilter = NULL);
183 * Find all items with the specified ident
184 * @param aFilter - optional filter on items
186 static List findAllWithIdent(const std::string& aIdent, Filter* aFilter = NULL, bool aExact = true);
189 * As above, but searches names instead of idents
191 static List findAllWithName(const std::string& aName, Filter* aFilter = NULL, bool aExact = true);
194 * Sort an FGPositionedList by distance from a position
196 static void sortByRange(List&, const SGGeod& aPos);
199 * Find the closest item to a position, which pass the specified filter
200 * A cutoff range in NM must be specified, to constrain the search acceptably.
201 * Very large cutoff values will make this slow.
203 * @result The closest item passing the filter, or NULL
204 * @param aCutoffNm - maximum distance to search within, in nautical miles
206 static FGPositionedRef findClosest(const SGGeod& aPos, double aCutoffNm, Filter* aFilter = NULL);
209 * Find the closest N items to a position, which pass the specified filter
210 * A cutoff range in NM must be specified, to constrain the search acceptably.
211 * Very large cutoff values will make this slow.
213 * @result The matches (possibly less than N, depending on the filter and cutoff),
214 * sorted by distance from the search pos
215 * @param aN - number of matches to find
216 * @param aCutoffNm - maximum distance to search within, in nautical miles
218 static List findClosestN(const SGGeod& aPos, unsigned int aN, double aCutoffNm, Filter* aFilter = NULL);
221 * Same as above, but with a time-bound in msec too.
223 static List findClosestNPartial(const SGGeod& aPos, unsigned int aN, double aCutoffNm, Filter* aFilter,
227 * Map a candidate type string to a real type. Returns INVALID if the string
228 * does not correspond to a defined type.
230 static Type typeFromName(const std::string& aName);
233 * Map a type to a human-readable string
235 static const char* nameForType(Type aTy);
237 static FGPositioned* createUserWaypoint(const std::string& aIdent, const SGGeod& aPos);
238 static void deleteUserWaypoint(const std::string& aIdent);
240 friend class flightgear::NavDataCache;
242 FGPositioned(PositionedID aGuid, Type ty, const std::string& aIdent, const SGGeod& aPos);
244 void modifyPosition(const SGGeod& newPos);
246 const PositionedID mGuid;
247 const SGGeod mPosition;
250 const std::string mIdent;
253 SG_DISABLE_COPY(FGPositioned);
256 #endif // of FG_POSITIONED_HXX