src/MultiPlayer/multiplaymgr.cxx

   1 //////////////////////////////////////////////////////////////////////
   2 //
   3 // multiplaymgr.hpp
   4 //
   5 // Written by Duncan McCreanor, started February 2003.
   6 // duncan.mccreanor@airservicesaustralia.com
   7 //
   8 // Copyright (C) 2003  Airservices Australia
   9 // Copyright (C) 2005  Oliver Schroeder
  10 // Copyright (C) 2006  Mathias Froehlich
  11 //
  12 // This program is free software; you can redistribute it and/or
  13 // modify it under the terms of the GNU General Public License as
  14 // published by the Free Software Foundation; either version 2 of the
  15 // License, or (at your option) any later version.
  16 //
  17 // This program is distributed in the hope that it will be useful, but
  18 // WITHOUT ANY WARRANTY; without even the implied warranty of
  19 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  20 // General Public License for more details.
  21 //
  22 // You should have received a copy of the GNU General Public License
  23 // along with this program; if not, write to the Free Software
  24 // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  25 //
  26 // $Id$
  27 //
  28 //////////////////////////////////////////////////////////////////////
  29
  30 #ifdef HAVE_CONFIG_H
  31 #include <config.h>
  32 #endif
  33
  34 #include <iostream>
  35 #include <algorithm>
  36 #include <cstring>
  37 #include <osg/Math>             // isNaN
  38
  39 #include <simgear/misc/stdint.hxx>
  40 #include <simgear/timing/timestamp.hxx>
  41 #include <simgear/debug/logstream.hxx>
  42 #include <simgear/props/props.hxx>
  43
  44 #include <AIModel/AIManager.hxx>
  45 #include <Main/fg_props.hxx>
  46 #include "multiplaymgr.hxx"
  47 #include "mpmessages.hxx"
  48
  49 using namespace std;
  50
  51 #define MAX_PACKET_SIZE 1200
  52 #define MAX_TEXT_SIZE 128
  53
  54 // These constants are provided so that the ident
  55 // command can list file versions
  56 const char sMULTIPLAYMGR_BID[] = "$Id$";
  57 const char sMULTIPLAYMGR_HID[] = MULTIPLAYTXMGR_HID;
  58
  59 // A static map of protocol property id values to property paths,
  60 // This should be extendable dynamically for every specific aircraft ...
  61 // For now only that static list
  62 const FGMultiplayMgr::IdPropertyList
  63 FGMultiplayMgr::sIdPropertyList[] = {
  64   {100, "surface-positions/left-aileron-pos-norm",  simgear::props::FLOAT},
  65   {101, "surface-positions/right-aileron-pos-norm", simgear::props::FLOAT},
  66   {102, "surface-positions/elevator-pos-norm",      simgear::props::FLOAT},
  67   {103, "surface-positions/rudder-pos-norm",        simgear::props::FLOAT},
  68   {104, "surface-positions/flap-pos-norm",          simgear::props::FLOAT},
  69   {105, "surface-positions/speedbrake-pos-norm",    simgear::props::FLOAT},
  70   {106, "gear/tailhook/position-norm",              simgear::props::FLOAT},
  71   {107, "gear/launchbar/position-norm",             simgear::props::FLOAT},
  72   {108, "gear/launchbar/state",                     simgear::props::STRING},
  73   {109, "gear/launchbar/holdback-position-norm",    simgear::props::FLOAT},
  74   {110, "canopy/position-norm",                     simgear::props::FLOAT},
  75   {111, "surface-positions/wing-pos-norm",          simgear::props::FLOAT},
  76   {112, "surface-positions/wing-fold-pos-norm",     simgear::props::FLOAT},
  77
  78   {200, "gear/gear[0]/compression-norm",           simgear::props::FLOAT},
  79   {201, "gear/gear[0]/position-norm",              simgear::props::FLOAT},
  80   {210, "gear/gear[1]/compression-norm",           simgear::props::FLOAT},
  81   {211, "gear/gear[1]/position-norm",              simgear::props::FLOAT},
  82   {220, "gear/gear[2]/compression-norm",           simgear::props::FLOAT},
  83   {221, "gear/gear[2]/position-norm",              simgear::props::FLOAT},
  84   {230, "gear/gear[3]/compression-norm",           simgear::props::FLOAT},
  85   {231, "gear/gear[3]/position-norm",              simgear::props::FLOAT},
  86   {240, "gear/gear[4]/compression-norm",           simgear::props::FLOAT},
  87   {241, "gear/gear[4]/position-norm",              simgear::props::FLOAT},
  88
  89   {300, "engines/engine[0]/n1",  simgear::props::FLOAT},
  90   {301, "engines/engine[0]/n2",  simgear::props::FLOAT},
  91   {302, "engines/engine[0]/rpm", simgear::props::FLOAT},
  92   {310, "engines/engine[1]/n1",  simgear::props::FLOAT},
  93   {311, "engines/engine[1]/n2",  simgear::props::FLOAT},
  94   {312, "engines/engine[1]/rpm", simgear::props::FLOAT},
  95   {320, "engines/engine[2]/n1",  simgear::props::FLOAT},
  96   {321, "engines/engine[2]/n2",  simgear::props::FLOAT},
  97   {322, "engines/engine[2]/rpm", simgear::props::FLOAT},
  98   {330, "engines/engine[3]/n1",  simgear::props::FLOAT},
  99   {331, "engines/engine[3]/n2",  simgear::props::FLOAT},
 100   {332, "engines/engine[3]/rpm", simgear::props::FLOAT},
 101   {340, "engines/engine[4]/n1",  simgear::props::FLOAT},
 102   {341, "engines/engine[4]/n2",  simgear::props::FLOAT},
 103   {342, "engines/engine[4]/rpm", simgear::props::FLOAT},
 104   {350, "engines/engine[5]/n1",  simgear::props::FLOAT},
 105   {351, "engines/engine[5]/n2",  simgear::props::FLOAT},
 106   {352, "engines/engine[5]/rpm", simgear::props::FLOAT},
 107   {360, "engines/engine[6]/n1",  simgear::props::FLOAT},
 108   {361, "engines/engine[6]/n2",  simgear::props::FLOAT},
 109   {362, "engines/engine[6]/rpm", simgear::props::FLOAT},
 110   {370, "engines/engine[7]/n1",  simgear::props::FLOAT},
 111   {371, "engines/engine[7]/n2",  simgear::props::FLOAT},
 112   {372, "engines/engine[7]/rpm", simgear::props::FLOAT},
 113   {380, "engines/engine[8]/n1",  simgear::props::FLOAT},
 114   {381, "engines/engine[8]/n2",  simgear::props::FLOAT},
 115   {382, "engines/engine[8]/rpm", simgear::props::FLOAT},
 116   {390, "engines/engine[9]/n1",  simgear::props::FLOAT},
 117   {391, "engines/engine[9]/n2",  simgear::props::FLOAT},
 118   {392, "engines/engine[9]/rpm", simgear::props::FLOAT},
 119
 120   {800, "rotors/main/rpm", simgear::props::FLOAT},
 121   {801, "rotors/tail/rpm", simgear::props::FLOAT},
 122   {810, "rotors/main/blade[0]/position-deg",  simgear::props::FLOAT},
 123   {811, "rotors/main/blade[1]/position-deg",  simgear::props::FLOAT},
 124   {812, "rotors/main/blade[2]/position-deg",  simgear::props::FLOAT},
 125   {813, "rotors/main/blade[3]/position-deg",  simgear::props::FLOAT},
 126   {820, "rotors/main/blade[0]/flap-deg",  simgear::props::FLOAT},
 127   {821, "rotors/main/blade[1]/flap-deg",  simgear::props::FLOAT},
 128   {822, "rotors/main/blade[2]/flap-deg",  simgear::props::FLOAT},
 129   {823, "rotors/main/blade[3]/flap-deg",  simgear::props::FLOAT},
 130   {830, "rotors/tail/blade[0]/position-deg",  simgear::props::FLOAT},
 131   {831, "rotors/tail/blade[1]/position-deg",  simgear::props::FLOAT},
 132
 133   {900, "sim/hitches/aerotow/tow/length",                       simgear::props::FLOAT},
 134   {901, "sim/hitches/aerotow/tow/elastic-constant",             simgear::props::FLOAT},
 135   {902, "sim/hitches/aerotow/tow/weight-per-m-kg-m",            simgear::props::FLOAT},
 136   {903, "sim/hitches/aerotow/tow/dist",                         simgear::props::FLOAT},
 137   {904, "sim/hitches/aerotow/tow/connected-to-property-node",   simgear::props::BOOL},
 138   {905, "sim/hitches/aerotow/tow/connected-to-ai-or-mp-callsign",   simgear::props::STRING},
 139   {906, "sim/hitches/aerotow/tow/brake-force",                  simgear::props::FLOAT},
 140   {907, "sim/hitches/aerotow/tow/end-force-x",                  simgear::props::FLOAT},
 141   {908, "sim/hitches/aerotow/tow/end-force-y",                  simgear::props::FLOAT},
 142   {909, "sim/hitches/aerotow/tow/end-force-z",                  simgear::props::FLOAT},
 143   {930, "sim/hitches/aerotow/is-slave",                         simgear::props::BOOL},
 144   {931, "sim/hitches/aerotow/speed-in-tow-direction",           simgear::props::FLOAT},
 145   {932, "sim/hitches/aerotow/open",                             simgear::props::BOOL},
 146   {933, "sim/hitches/aerotow/local-pos-x",                      simgear::props::FLOAT},
 147   {934, "sim/hitches/aerotow/local-pos-y",                      simgear::props::FLOAT},
 148   {935, "sim/hitches/aerotow/local-pos-z",                      simgear::props::FLOAT},
 149
 150   {1001, "controls/flight/slats",  simgear::props::FLOAT},
 151   {1002, "controls/flight/speedbrake",  simgear::props::FLOAT},
 152   {1003, "controls/flight/spoilers",  simgear::props::FLOAT},
 153   {1004, "controls/gear/gear-down",  simgear::props::FLOAT},
 154   {1005, "controls/lighting/nav-lights",  simgear::props::FLOAT},
 155   {1006, "controls/armament/station[0]/jettison-all",  simgear::props::BOOL},
 156
 157   {1100, "sim/model/variant", simgear::props::INT},
 158   {1101, "sim/model/livery/file", simgear::props::STRING},
 159
 160   {1200, "environment/wildfire/data", simgear::props::STRING},
 161   {1201, "environment/contrail", simgear::props::INT},
 162
 163   {1300, "tanker", simgear::props::INT},
 164
 165   {10001, "sim/multiplay/transmission-freq-hz",  simgear::props::STRING},
 166   {10002, "sim/multiplay/chat",  simgear::props::STRING},
 167
 168   {10100, "sim/multiplay/generic/string[0]", simgear::props::STRING},
 169   {10101, "sim/multiplay/generic/string[1]", simgear::props::STRING},
 170   {10102, "sim/multiplay/generic/string[2]", simgear::props::STRING},
 171   {10103, "sim/multiplay/generic/string[3]", simgear::props::STRING},
 172   {10104, "sim/multiplay/generic/string[4]", simgear::props::STRING},
 173   {10105, "sim/multiplay/generic/string[5]", simgear::props::STRING},
 174   {10106, "sim/multiplay/generic/string[6]", simgear::props::STRING},
 175   {10107, "sim/multiplay/generic/string[7]", simgear::props::STRING},
 176   {10108, "sim/multiplay/generic/string[8]", simgear::props::STRING},
 177   {10109, "sim/multiplay/generic/string[9]", simgear::props::STRING},
 178   {10110, "sim/multiplay/generic/string[10]", simgear::props::STRING},
 179   {10111, "sim/multiplay/generic/string[11]", simgear::props::STRING},
 180   {10112, "sim/multiplay/generic/string[12]", simgear::props::STRING},
 181   {10113, "sim/multiplay/generic/string[13]", simgear::props::STRING},
 182   {10114, "sim/multiplay/generic/string[14]", simgear::props::STRING},
 183   {10115, "sim/multiplay/generic/string[15]", simgear::props::STRING},
 184   {10116, "sim/multiplay/generic/string[16]", simgear::props::STRING},
 185   {10117, "sim/multiplay/generic/string[17]", simgear::props::STRING},
 186   {10118, "sim/multiplay/generic/string[18]", simgear::props::STRING},
 187   {10119, "sim/multiplay/generic/string[19]", simgear::props::STRING},
 188
 189   {10200, "sim/multiplay/generic/float[0]", simgear::props::FLOAT},
 190   {10201, "sim/multiplay/generic/float[1]", simgear::props::FLOAT},
 191   {10202, "sim/multiplay/generic/float[2]", simgear::props::FLOAT},
 192   {10203, "sim/multiplay/generic/float[3]", simgear::props::FLOAT},
 193   {10204, "sim/multiplay/generic/float[4]", simgear::props::FLOAT},
 194   {10205, "sim/multiplay/generic/float[5]", simgear::props::FLOAT},
 195   {10206, "sim/multiplay/generic/float[6]", simgear::props::FLOAT},
 196   {10207, "sim/multiplay/generic/float[7]", simgear::props::FLOAT},
 197   {10208, "sim/multiplay/generic/float[8]", simgear::props::FLOAT},
 198   {10209, "sim/multiplay/generic/float[9]", simgear::props::FLOAT},
 199   {10210, "sim/multiplay/generic/float[10]", simgear::props::FLOAT},
 200   {10211, "sim/multiplay/generic/float[11]", simgear::props::FLOAT},
 201   {10212, "sim/multiplay/generic/float[12]", simgear::props::FLOAT},
 202   {10213, "sim/multiplay/generic/float[13]", simgear::props::FLOAT},
 203   {10214, "sim/multiplay/generic/float[14]", simgear::props::FLOAT},
 204   {10215, "sim/multiplay/generic/float[15]", simgear::props::FLOAT},
 205   {10216, "sim/multiplay/generic/float[16]", simgear::props::FLOAT},
 206   {10217, "sim/multiplay/generic/float[17]", simgear::props::FLOAT},
 207   {10218, "sim/multiplay/generic/float[18]", simgear::props::FLOAT},
 208   {10219, "sim/multiplay/generic/float[19]", simgear::props::FLOAT},
 209
 210   {10300, "sim/multiplay/generic/int[0]", simgear::props::INT},
 211   {10301, "sim/multiplay/generic/int[1]", simgear::props::INT},
 212   {10302, "sim/multiplay/generic/int[2]", simgear::props::INT},
 213   {10303, "sim/multiplay/generic/int[3]", simgear::props::INT},
 214   {10304, "sim/multiplay/generic/int[4]", simgear::props::INT},
 215   {10305, "sim/multiplay/generic/int[5]", simgear::props::INT},
 216   {10306, "sim/multiplay/generic/int[6]", simgear::props::INT},
 217   {10307, "sim/multiplay/generic/int[7]", simgear::props::INT},
 218   {10308, "sim/multiplay/generic/int[8]", simgear::props::INT},
 219   {10309, "sim/multiplay/generic/int[9]", simgear::props::INT},
 220   {10310, "sim/multiplay/generic/int[10]", simgear::props::INT},
 221   {10311, "sim/multiplay/generic/int[11]", simgear::props::INT},
 222   {10312, "sim/multiplay/generic/int[12]", simgear::props::INT},
 223   {10313, "sim/multiplay/generic/int[13]", simgear::props::INT},
 224   {10314, "sim/multiplay/generic/int[14]", simgear::props::INT},
 225   {10315, "sim/multiplay/generic/int[15]", simgear::props::INT},
 226   {10316, "sim/multiplay/generic/int[16]", simgear::props::INT},
 227   {10317, "sim/multiplay/generic/int[17]", simgear::props::INT},
 228   {10318, "sim/multiplay/generic/int[18]", simgear::props::INT},
 229   {10319, "sim/multiplay/generic/int[19]", simgear::props::INT}
 230 };
 231
 232 const unsigned
 233 FGMultiplayMgr::numProperties = (sizeof(FGMultiplayMgr::sIdPropertyList)
 234                                  / sizeof(FGMultiplayMgr::sIdPropertyList[0]));
 235
 236 // Look up a property ID using binary search.
 237 namespace
 238 {
 239   struct ComparePropertyId
 240   {
 241     bool operator()(const FGMultiplayMgr::IdPropertyList& lhs,
 242                     const FGMultiplayMgr::IdPropertyList& rhs)
 243     {
 244       return lhs.id < rhs.id;
 245     }
 246     bool operator()(const FGMultiplayMgr::IdPropertyList& lhs,
 247                     unsigned id)
 248     {
 249       return lhs.id < id;
 250     }
 251     bool operator()(unsigned id,
 252                     const FGMultiplayMgr::IdPropertyList& rhs)
 253     {
 254       return id < rhs.id;
 255     }
 256   };
 257
 258 }
 259 const FGMultiplayMgr::IdPropertyList* FGMultiplayMgr::findProperty(unsigned id)
 260 {
 261   std::pair<const IdPropertyList*, const IdPropertyList*> result
 262     = std::equal_range(sIdPropertyList, sIdPropertyList + numProperties, id,
 263                        ComparePropertyId());
 264   if (result.first == result.second) {
 265     return 0;
 266   } else {
 267     return result.first;
 268   }
 269 }
 270
 271 namespace
 272 {
 273   bool verifyProperties(const xdr_data_t* data, const xdr_data_t* end)
 274   {
 275     using namespace simgear;
 276     const xdr_data_t* xdr = data;
 277     while (xdr < end) {
 278       unsigned id = XDR_decode_uint32(*xdr);
 279       const FGMultiplayMgr::IdPropertyList* plist
 280         = FGMultiplayMgr::findProperty(id);
 281
 282       if (plist) {
 283         xdr++;
 284         // How we decode the remainder of the property depends on the type
 285         switch (plist->type) {
 286         case props::INT:
 287         case props::BOOL:
 288         case props::LONG:
 289           xdr++;
 290           break;
 291         case props::FLOAT:
 292         case props::DOUBLE:
 293           {
 294             float val = XDR_decode_float(*xdr);
 295             if (osg::isNaN(val))
 296               return false;
 297             xdr++;
 298             break;
 299           }
 300         case props::STRING:
 301         case props::UNSPECIFIED:
 302           {
 303             // String is complicated. It consists of
 304             // The length of the string
 305             // The string itself
 306             // Padding to the nearest 4-bytes.
 307             // XXX Yes, each byte is padded out to a word! Too late
 308             // to change...
 309             uint32_t length = XDR_decode_uint32(*xdr);
 310             xdr++;
 311             // Old versions truncated the string but left the length
 312             // unadjusted.
 313             if (length > MAX_TEXT_SIZE)
 314               length = MAX_TEXT_SIZE;
 315             xdr += length;
 316             // Now handle the padding
 317             while ((length % 4) != 0)
 318               {
 319                 xdr++;
 320                 length++;
 321                 //cout << "0";
 322               }
 323           }
 324           break;
 325         default:
 326           // cerr << "Unknown Prop type " << id << " " << type << "\n";
 327           xdr++;
 328           break;
 329         }
 330       }
 331       else {
 332         // give up; this is a malformed property list.
 333         return false;
 334       }
 335     }
 336     return true;
 337   }
 338 }
 339 //////////////////////////////////////////////////////////////////////
 340 //
 341 //  MultiplayMgr constructor
 342 //
 343 //////////////////////////////////////////////////////////////////////
 344 FGMultiplayMgr::FGMultiplayMgr()
 345 {
 346   mSocket        = 0;
 347   mInitialised   = false;
 348   mHaveServer    = false;
 349 } // FGMultiplayMgr::FGMultiplayMgr()
 350 //////////////////////////////////////////////////////////////////////
 351
 352 //////////////////////////////////////////////////////////////////////
 353 //
 354 //  MultiplayMgr destructor
 355 //
 356 //////////////////////////////////////////////////////////////////////
 357 FGMultiplayMgr::~FGMultiplayMgr()
 358 {
 359   Close();
 360 } // FGMultiplayMgr::~FGMultiplayMgr()
 361 //////////////////////////////////////////////////////////////////////
 362
 363 //////////////////////////////////////////////////////////////////////
 364 //
 365 //  Initialise object
 366 //
 367 //////////////////////////////////////////////////////////////////////
 368 void
 369 FGMultiplayMgr::init (void)
 370 {
 371   //////////////////////////////////////////////////
 372   //  Initialise object if not already done
 373   //////////////////////////////////////////////////
 374   if (mInitialised) {
 375     SG_LOG(SG_NETWORK, SG_WARN, "FGMultiplayMgr::init - already initialised");
 376     return;
 377   }
 378   //////////////////////////////////////////////////
 379   //  Set members from property values
 380   //////////////////////////////////////////////////
 381   short rxPort = fgGetInt("/sim/multiplay/rxport");
 382   string rxAddress = fgGetString("/sim/multiplay/rxhost");
 383   short txPort = fgGetInt("/sim/multiplay/txport");
 384   string txAddress = fgGetString("/sim/multiplay/txhost");
 385   mCallsign = fgGetString("/sim/multiplay/callsign");
 386   if (txPort > 0 && !txAddress.empty()) {
 387     mServer.set(txAddress.c_str(), txPort);
 388     if (strncmp (mServer.getHost(), "0.0.0.0", 8) == 0) {
 389       mHaveServer = false;
 390       SG_LOG(SG_NETWORK, SG_DEBUG,
 391         "FGMultiplayMgr - could not resolve '"
 392         << txAddress << "', Multiplayermode disabled");
 393     } else {
 394       mHaveServer = true;
 395     }
 396     if (rxPort <= 0)
 397       rxPort = txPort;
 398   }
 399   if (rxPort <= 0) {
 400     SG_LOG(SG_NETWORK, SG_DEBUG,
 401       "FGMultiplayMgr - No receiver port, Multiplayermode disabled");
 402     return;
 403   }
 404   if (mCallsign.empty())
 405     mCallsign = "JohnDoe"; // FIXME: use getpwuid
 406   SG_LOG(SG_NETWORK,SG_INFO,"FGMultiplayMgr::init-txaddress= "<<txAddress);
 407   SG_LOG(SG_NETWORK,SG_INFO,"FGMultiplayMgr::init-txport= "<<txPort );
 408   SG_LOG(SG_NETWORK,SG_INFO,"FGMultiplayMgr::init-rxaddress="<<rxAddress );
 409   SG_LOG(SG_NETWORK,SG_INFO,"FGMultiplayMgr::init-rxport= "<<rxPort);
 410   SG_LOG(SG_NETWORK,SG_INFO,"FGMultiplayMgr::init-callsign= "<<mCallsign);
 411   Close(); // Should Init be called twice, close Socket first
 412            // A memory leak was reported here by valgrind
 413   mSocket = new simgear::Socket();
 414   if (!mSocket->open(false)) {
 415     SG_LOG( SG_NETWORK, SG_DEBUG,
 416             "FGMultiplayMgr::init - Failed to create data socket" );
 417     return;
 418   }
 419   mSocket->setBlocking(false);
 420   if (mSocket->bind(rxAddress.c_str(), rxPort) != 0) {
 421     perror("bind");
 422     SG_LOG( SG_NETWORK, SG_DEBUG,
 423             "FGMultiplayMgr::Open - Failed to bind receive socket" );
 424     return;
 425   }
 426
 427   mInitialised = true;
 428 } // FGMultiplayMgr::init()
 429 //////////////////////////////////////////////////////////////////////
 430
 431 //////////////////////////////////////////////////////////////////////
 432 //
 433 //  Closes and deletes the local player object. Closes
 434 //  and deletes the tx socket. Resets the object state to unitialised.
 435 //
 436 //////////////////////////////////////////////////////////////////////
 437 void
 438 FGMultiplayMgr::Close (void)
 439 {
 440   mMultiPlayerMap.clear();
 441
 442   if (mSocket) {
 443     mSocket->close();
 444     delete mSocket;
 445     mSocket = 0;
 446   }
 447   mInitialised = false;
 448 } // FGMultiplayMgr::Close(void)
 449 //////////////////////////////////////////////////////////////////////
 450
 451 //////////////////////////////////////////////////////////////////////
 452 //
 453 //  Description: Sends the position data for the local position.
 454 //
 455 //////////////////////////////////////////////////////////////////////
 456
 457 /**
 458  * The buffer that holds a multi-player message, suitably aligned.
 459  */
 460 union FGMultiplayMgr::MsgBuf
 461 {
 462     MsgBuf()
 463     {
 464         memset(&Msg, 0, sizeof(Msg));
 465     }
 466
 467     T_MsgHdr* msgHdr()
 468     {
 469         return &Header;
 470     }
 471
 472     const T_MsgHdr* msgHdr() const
 473     {
 474         return reinterpret_cast<const T_MsgHdr*>(&Header);
 475     }
 476
 477     T_PositionMsg* posMsg()
 478     {
 479         return reinterpret_cast<T_PositionMsg*>(Msg + sizeof(T_MsgHdr));
 480     }
 481
 482     const T_PositionMsg* posMsg() const
 483     {
 484         return reinterpret_cast<const T_PositionMsg*>(Msg + sizeof(T_MsgHdr));
 485     }
 486
 487     xdr_data_t* properties()
 488     {
 489         return reinterpret_cast<xdr_data_t*>(Msg + sizeof(T_MsgHdr)
 490                                              + sizeof(T_PositionMsg));
 491     }
 492
 493     const xdr_data_t* properties() const
 494     {
 495         return reinterpret_cast<const xdr_data_t*>(Msg + sizeof(T_MsgHdr)
 496                                                    + sizeof(T_PositionMsg));
 497     }
 498     /**
 499      * The end of the properties buffer.
 500      */
 501     xdr_data_t* propsEnd()
 502     {
 503         return reinterpret_cast<xdr_data_t*>(Msg + MAX_PACKET_SIZE);
 504     };
 505
 506     const xdr_data_t* propsEnd() const
 507     {
 508         return reinterpret_cast<const xdr_data_t*>(Msg + MAX_PACKET_SIZE);
 509     };
 510     /**
 511      * The end of properties actually in the buffer. This assumes that
 512      * the message header is valid.
 513      */
 514     xdr_data_t* propsRecvdEnd()
 515     {
 516         return reinterpret_cast<xdr_data_t*>(Msg + Header.MsgLen);
 517     }
 518
 519     const xdr_data_t* propsRecvdEnd() const
 520     {
 521         return reinterpret_cast<const xdr_data_t*>(Msg + Header.MsgLen);
 522     }
 523
 524     xdr_data2_t double_val;
 525     char Msg[MAX_PACKET_SIZE];
 526     T_MsgHdr Header;
 527 };
 528
 529 void
 530 FGMultiplayMgr::SendMyPosition(const FGExternalMotionData& motionInfo)
 531 {
 532   if ((! mInitialised) || (! mHaveServer))
 533         return;
 534   if (! mHaveServer) {
 535     SG_LOG( SG_NETWORK, SG_DEBUG, "FGMultiplayMgr::SendMyPosition - no server");
 536     return;
 537   }
 538
 539   MsgBuf msgBuf;
 540   T_PositionMsg* PosMsg = msgBuf.posMsg();
 541
 542   strncpy(PosMsg->Model, fgGetString("/sim/model/path"), MAX_MODEL_NAME_LEN);
 543   PosMsg->Model[MAX_MODEL_NAME_LEN - 1] = '\0';
 544
 545   PosMsg->time = XDR_encode_double (motionInfo.time);
 546   PosMsg->lag = XDR_encode_double (motionInfo.lag);
 547   for (unsigned i = 0 ; i < 3; ++i)
 548     PosMsg->position[i] = XDR_encode_double (motionInfo.position(i));
 549   SGVec3f angleAxis;
 550   motionInfo.orientation.getAngleAxis(angleAxis);
 551   for (unsigned i = 0 ; i < 3; ++i)
 552     PosMsg->orientation[i] = XDR_encode_float (angleAxis(i));
 553   for (unsigned i = 0 ; i < 3; ++i)
 554     PosMsg->linearVel[i] = XDR_encode_float (motionInfo.linearVel(i));
 555   for (unsigned i = 0 ; i < 3; ++i)
 556     PosMsg->angularVel[i] = XDR_encode_float (motionInfo.angularVel(i));
 557   for (unsigned i = 0 ; i < 3; ++i)
 558     PosMsg->linearAccel[i] = XDR_encode_float (motionInfo.linearAccel(i));
 559   for (unsigned i = 0 ; i < 3; ++i)
 560     PosMsg->angularAccel[i] = XDR_encode_float (motionInfo.angularAccel(i));
 561
 562   xdr_data_t* ptr = msgBuf.properties();
 563   std::vector<FGPropertyData*>::const_iterator it;
 564   it = motionInfo.properties.begin();
 565   //cout << "OUTPUT PROPERTIES\n";
 566   xdr_data_t* msgEnd = msgBuf.propsEnd();
 567   while (it != motionInfo.properties.end() && ptr + 2 < msgEnd) {
 568
 569     // First element is the ID. Write it out when we know we have room for
 570     // the whole property.
 571     xdr_data_t id =  XDR_encode_uint32((*it)->id);
 572     // The actual data representation depends on the type
 573     switch ((*it)->type) {
 574       case simgear::props::INT:
 575       case simgear::props::BOOL:
 576       case simgear::props::LONG:
 577         *ptr++ = id;
 578         *ptr++ = XDR_encode_uint32((*it)->int_value);
 579         //cout << "Prop:" << (*it)->id << " " << (*it)->type << " "<< (*it)->int_value << "\n";
 580         break;
 581       case simgear::props::FLOAT:
 582       case simgear::props::DOUBLE:
 583         *ptr++ = id;
 584         *ptr++ = XDR_encode_float((*it)->float_value);
 585         //cout << "Prop:" << (*it)->id << " " << (*it)->type << " "<< (*it)->float_value << "\n";
 586         break;
 587       case simgear::props::STRING:
 588       case simgear::props::UNSPECIFIED:
 589         {
 590           // String is complicated. It consists of
 591           // The length of the string
 592           // The string itself
 593           // Padding to the nearest 4-bytes.
 594           const char* lcharptr = (*it)->string_value;
 595
 596           if (lcharptr != 0)
 597           {
 598             // Add the length
 599             ////cout << "String length: " << strlen(lcharptr) << "\n";
 600             uint32_t len = strlen(lcharptr);
 601             if (len > MAX_TEXT_SIZE)
 602               len = MAX_TEXT_SIZE;
 603             // XXX This should not be using 4 bytes per character!
 604             // If there's not enough room for this property, drop it
 605             // on the floor.
 606             if (ptr + 2 + ((len + 3) & ~3) > msgEnd)
 607                 goto escape;
 608             //cout << "String length unint32: " << len << "\n";
 609             *ptr++ = id;
 610             *ptr++ = XDR_encode_uint32(len);
 611             if (len != 0)
 612             {
 613               // Now the text itself
 614               // XXX This should not be using 4 bytes per character!
 615               int lcount = 0;
 616               while ((*lcharptr != '\0') && (lcount < MAX_TEXT_SIZE))
 617               {
 618                 *ptr++ = XDR_encode_int8(*lcharptr);
 619                 lcharptr++;
 620                 lcount++;
 621               }
 622
 623               //cout << "Prop:" << (*it)->id << " " << (*it)->type << " " << len << " " << (*it)->string_value;
 624
 625               // Now pad if required
 626               while ((lcount % 4) != 0)
 627               {
 628                 *ptr++ = XDR_encode_int8(0);
 629                 lcount++;
 630                 //cout << "0";
 631               }
 632
 633               //cout << "\n";
 634             }
 635           }
 636           else
 637           {
 638             // Nothing to encode
 639             *ptr++ = id;
 640             *ptr++ = XDR_encode_uint32(0);
 641             //cout << "Prop:" << (*it)->id << " " << (*it)->type << " 0\n";
 642           }
 643         }
 644         break;
 645
 646       default:
 647         //cout << " Unknown Type: " << (*it)->type << "\n";
 648         *ptr++ = id;
 649         *ptr++ = XDR_encode_float((*it)->float_value);;
 650         //cout << "Prop:" << (*it)->id << " " << (*it)->type << " "<< (*it)->float_value << "\n";
 651         break;
 652     }
 653
 654     ++it;
 655   }
 656 escape:
 657   unsigned msgLen = reinterpret_cast<char*>(ptr) - msgBuf.Msg;
 658   FillMsgHdr(msgBuf.msgHdr(), POS_DATA_ID, msgLen);
 659   mSocket->sendto(msgBuf.Msg, msgLen, 0, &mServer);
 660   SG_LOG(SG_NETWORK, SG_DEBUG, "FGMultiplayMgr::SendMyPosition");
 661 } // FGMultiplayMgr::SendMyPosition()
 662
 663 //////////////////////////////////////////////////////////////////////
 664
 665 //////////////////////////////////////////////////////////////////////
 666 //
 667 //  Name: SendTextMessage
 668 //  Description: Sends a message to the player. The message must
 669 //  contain a valid and correctly filled out header and optional
 670 //  message body.
 671 //
 672 //////////////////////////////////////////////////////////////////////
 673 void
 674 FGMultiplayMgr::SendTextMessage(const string &MsgText)
 675 {
 676   if (!mInitialised || !mHaveServer)
 677     return;
 678
 679   T_MsgHdr MsgHdr;
 680   FillMsgHdr(&MsgHdr, CHAT_MSG_ID);
 681   //////////////////////////////////////////////////
 682   // Divide the text string into blocks that fit
 683   // in the message and send the blocks.
 684   //////////////////////////////////////////////////
 685   unsigned iNextBlockPosition = 0;
 686   T_ChatMsg ChatMsg;
 687
 688   char Msg[sizeof(T_MsgHdr) + sizeof(T_ChatMsg)];
 689   while (iNextBlockPosition < MsgText.length()) {
 690     strncpy (ChatMsg.Text,
 691              MsgText.substr(iNextBlockPosition, MAX_CHAT_MSG_LEN - 1).c_str(),
 692              MAX_CHAT_MSG_LEN);
 693     ChatMsg.Text[MAX_CHAT_MSG_LEN - 1] = '\0';
 694     memcpy (Msg, &MsgHdr, sizeof(T_MsgHdr));
 695     memcpy (Msg + sizeof(T_MsgHdr), &ChatMsg, sizeof(T_ChatMsg));
 696     mSocket->sendto (Msg, sizeof(T_MsgHdr) + sizeof(T_ChatMsg), 0, &mServer);
 697     iNextBlockPosition += MAX_CHAT_MSG_LEN - 1;
 698
 699   }
 700
 701
 702 } // FGMultiplayMgr::SendTextMessage ()
 703 //////////////////////////////////////////////////////////////////////
 704
 705 //////////////////////////////////////////////////////////////////////
 706 //
 707 //  Name: ProcessData
 708 //  Description: Processes data waiting at the receive socket. The
 709 //  processing ends when there is no more data at the socket.
 710 //
 711 //////////////////////////////////////////////////////////////////////
 712 void
 713 FGMultiplayMgr::update(double)
 714 {
 715   if (!mInitialised)
 716     return;
 717
 718   /// Just for expiry
 719   long stamp = SGTimeStamp::now().getSeconds();
 720
 721   //////////////////////////////////////////////////
 722   //  Read the receive socket and process any data
 723   //////////////////////////////////////////////////
 724   ssize_t bytes;
 725   do {
 726     MsgBuf msgBuf;
 727     //////////////////////////////////////////////////
 728     //  Although the recv call asks for
 729     //  MAX_PACKET_SIZE of data, the number of bytes
 730     //  returned will only be that of the next
 731     //  packet waiting to be processed.
 732     //////////////////////////////////////////////////
 733     simgear::IPAddress SenderAddress;
 734     bytes = mSocket->recvfrom(msgBuf.Msg, sizeof(msgBuf.Msg), 0,
 735                               &SenderAddress);
 736     //////////////////////////////////////////////////
 737     //  no Data received
 738     //////////////////////////////////////////////////
 739     if (bytes <= 0) {
 740       if (errno != EAGAIN && errno != 0) // MSVC output "NoError" otherwise
 741         perror("FGMultiplayMgr::MP_ProcessData");
 742       break;
 743     }
 744     if (bytes <= static_cast<ssize_t>(sizeof(T_MsgHdr))) {
 745       SG_LOG( SG_NETWORK, SG_DEBUG, "FGMultiplayMgr::MP_ProcessData - "
 746               << "received message with insufficient data" );
 747       break;
 748     }
 749     //////////////////////////////////////////////////
 750     //  Read header
 751     //////////////////////////////////////////////////
 752     T_MsgHdr* MsgHdr = msgBuf.msgHdr();
 753     MsgHdr->Magic       = XDR_decode_uint32 (MsgHdr->Magic);
 754     MsgHdr->Version     = XDR_decode_uint32 (MsgHdr->Version);
 755     MsgHdr->MsgId       = XDR_decode_uint32 (MsgHdr->MsgId);
 756     MsgHdr->MsgLen      = XDR_decode_uint32 (MsgHdr->MsgLen);
 757     MsgHdr->ReplyPort   = XDR_decode_uint32 (MsgHdr->ReplyPort);
 758     MsgHdr->Callsign[MAX_CALLSIGN_LEN -1] = '\0';
 759     if (MsgHdr->Magic != MSG_MAGIC) {
 760       SG_LOG( SG_NETWORK, SG_DEBUG, "FGMultiplayMgr::MP_ProcessData - "
 761               << "message has invalid magic number!" );
 762       break;
 763     }
 764     if (MsgHdr->Version != PROTO_VER) {
 765       SG_LOG( SG_NETWORK, SG_DEBUG, "FGMultiplayMgr::MP_ProcessData - "
 766               << "message has invalid protocoll number!" );
 767       break;
 768     }
 769     if (MsgHdr->MsgLen != bytes) {
 770       SG_LOG(SG_NETWORK, SG_DEBUG, "FGMultiplayMgr::MP_ProcessData - "
 771              << "message from " << MsgHdr->Callsign << " has invalid length!");
 772       break;
 773     }
 774     //////////////////////////////////////////////////
 775     //  Process messages
 776     //////////////////////////////////////////////////
 777     switch (MsgHdr->MsgId) {
 778     case CHAT_MSG_ID:
 779       ProcessChatMsg(msgBuf, SenderAddress);
 780       break;
 781     case POS_DATA_ID:
 782       ProcessPosMsg(msgBuf, SenderAddress, stamp);
 783       break;
 784     case UNUSABLE_POS_DATA_ID:
 785     case OLD_OLD_POS_DATA_ID:
 786     case OLD_PROP_MSG_ID:
 787     case OLD_POS_DATA_ID:
 788       break;
 789     default:
 790       SG_LOG( SG_NETWORK, SG_DEBUG, "FGMultiplayMgr::MP_ProcessData - "
 791               << "Unknown message Id received: " << MsgHdr->MsgId );
 792       break;
 793     }
 794   } while (bytes > 0);
 795
 796   // check for expiry
 797   MultiPlayerMap::iterator it = mMultiPlayerMap.begin();
 798   while (it != mMultiPlayerMap.end()) {
 799     if (it->second->getLastTimestamp() + 10 < stamp) {
 800       std::string name = it->first;
 801       it->second->setDie(true);
 802       mMultiPlayerMap.erase(it);
 803       it = mMultiPlayerMap.upper_bound(name);
 804     } else
 805       ++it;
 806   }
 807 } // FGMultiplayMgr::ProcessData(void)
 808 //////////////////////////////////////////////////////////////////////
 809
 810 //////////////////////////////////////////////////////////////////////
 811 //
 812 //  handle a position message
 813 //
 814 //////////////////////////////////////////////////////////////////////
 815 void
 816 FGMultiplayMgr::ProcessPosMsg(const FGMultiplayMgr::MsgBuf& Msg,
 817                               const simgear::IPAddress& SenderAddress, long stamp)
 818 {
 819   const T_MsgHdr* MsgHdr = Msg.msgHdr();
 820   if (MsgHdr->MsgLen < sizeof(T_MsgHdr) + sizeof(T_PositionMsg)) {
 821     SG_LOG( SG_NETWORK, SG_DEBUG, "FGMultiplayMgr::MP_ProcessData - "
 822             << "Position message received with insufficient data" );
 823     return;
 824   }
 825   const T_PositionMsg* PosMsg = Msg.posMsg();
 826   FGExternalMotionData motionInfo;
 827   motionInfo.time = XDR_decode_double(PosMsg->time);
 828   motionInfo.lag = XDR_decode_double(PosMsg->lag);
 829   for (unsigned i = 0; i < 3; ++i)
 830     motionInfo.position(i) = XDR_decode_double(PosMsg->position[i]);
 831   SGVec3f angleAxis;
 832   for (unsigned i = 0; i < 3; ++i)
 833     angleAxis(i) = XDR_decode_float(PosMsg->orientation[i]);
 834   motionInfo.orientation = SGQuatf::fromAngleAxis(angleAxis);
 835   for (unsigned i = 0; i < 3; ++i)
 836     motionInfo.linearVel(i) = XDR_decode_float(PosMsg->linearVel[i]);
 837   for (unsigned i = 0; i < 3; ++i)
 838     motionInfo.angularVel(i) = XDR_decode_float(PosMsg->angularVel[i]);
 839   for (unsigned i = 0; i < 3; ++i)
 840     motionInfo.linearAccel(i) = XDR_decode_float(PosMsg->linearAccel[i]);
 841   for (unsigned i = 0; i < 3; ++i)
 842     motionInfo.angularAccel(i) = XDR_decode_float(PosMsg->angularAccel[i]);
 843
 844
 845   //cout << "INPUT MESSAGE\n";
 846
 847   // There was a bug in 1.9.0 and before: T_PositionMsg was 196 bytes
 848   // on 32 bit architectures and 200 bytes on 64 bit, and this
 849   // structure is put directly on the wire. By looking at the padding,
 850   // we can sort through the mess, mostly:
 851   // If padding is 0 (which is not a valid property type), then the
 852   // message was produced by a new client or an old 64 bit client that
 853   // happened to have 0 on the stack;
 854   // Else if the property list starting with the padding word is
 855   // well-formed, then the client is probably an old 32 bit client and
 856   // we'll go with that;
 857   // Else it is an old 64-bit client and properties start after the
 858   // padding.
 859   // There is a chance that we could be fooled by garbage in the
 860   // padding looking like a valid property, so verifyProperties() is
 861   // strict about the validity of the property values.
 862   const xdr_data_t* xdr = Msg.properties();
 863   if (PosMsg->pad != 0) {
 864     if (verifyProperties(&PosMsg->pad, Msg.propsRecvdEnd()))
 865       xdr = &PosMsg->pad;
 866     else if (!verifyProperties(xdr, Msg.propsRecvdEnd()))
 867       goto noprops;
 868   }
 869   while (xdr < Msg.propsRecvdEnd()) {
 870     FGPropertyData* pData = new FGPropertyData;
 871     // simgear::props::Type type = simgear::props::UNSPECIFIED;
 872
 873     // First element is always the ID
 874     pData->id = XDR_decode_uint32(*xdr);
 875     //cout << pData->id << " ";
 876     xdr++;
 877
 878     // Check the ID actually exists and get the type
 879     const IdPropertyList* plist = findProperty(pData->id);
 880
 881     if (plist)
 882     {
 883       pData->type = plist->type;
 884       // How we decode the remainder of the property depends on the type
 885       switch (pData->type) {
 886         case simgear::props::INT:
 887         case simgear::props::BOOL:
 888         case simgear::props::LONG:
 889           pData->int_value = XDR_decode_uint32(*xdr);
 890           xdr++;
 891           //cout << pData->int_value << "\n";
 892           break;
 893         case simgear::props::FLOAT:
 894         case simgear::props::DOUBLE:
 895           pData->float_value = XDR_decode_float(*xdr);
 896           xdr++;
 897           //cout << pData->float_value << "\n";
 898           break;
 899         case simgear::props::STRING:
 900         case simgear::props::UNSPECIFIED:
 901           {
 902             // String is complicated. It consists of
 903             // The length of the string
 904             // The string itself
 905             // Padding to the nearest 4-bytes.
 906             uint32_t length = XDR_decode_uint32(*xdr);
 907             xdr++;
 908             //cout << length << " ";
 909             // Old versions truncated the string but left the length unadjusted.
 910             if (length > MAX_TEXT_SIZE)
 911               length = MAX_TEXT_SIZE;
 912             pData->string_value = new char[length + 1];
 913             //cout << " String: ";
 914             for (unsigned i = 0; i < length; i++)
 915               {
 916                 pData->string_value[i] = (char) XDR_decode_int8(*xdr);
 917                 xdr++;
 918                 //cout << pData->string_value[i];
 919               }
 920
 921             pData->string_value[length] = '\0';
 922
 923             // Now handle the padding
 924             while ((length % 4) != 0)
 925               {
 926                 xdr++;
 927                 length++;
 928                 //cout << "0";
 929               }
 930             //cout << "\n";
 931           }
 932           break;
 933
 934         default:
 935           pData->float_value = XDR_decode_float(*xdr);
 936           SG_LOG(SG_NETWORK, SG_DEBUG, "Unknown Prop type " << pData->id << " " << pData->type);
 937           xdr++;
 938           break;
 939       }
 940
 941       motionInfo.properties.push_back(pData);
 942     }
 943     else
 944     {
 945       // We failed to find the property. We'll try the next packet immediately.
 946       SG_LOG(SG_NETWORK, SG_INFO, "FGMultiplayMgr::ProcessPosMsg - "
 947              "message from " << MsgHdr->Callsign << " has unknown property id "
 948              << pData->id);
 949     }
 950   }
 951  noprops:
 952   FGAIMultiplayer* mp = getMultiplayer(MsgHdr->Callsign);
 953   if (!mp)
 954     mp = addMultiplayer(MsgHdr->Callsign, PosMsg->Model);
 955   mp->addMotionInfo(motionInfo, stamp);
 956 } // FGMultiplayMgr::ProcessPosMsg()
 957 //////////////////////////////////////////////////////////////////////
 958
 959 //////////////////////////////////////////////////////////////////////
 960 //
 961 //  handle a chat message
 962 //  FIXME: display chat message withi flightgear
 963 //
 964 //////////////////////////////////////////////////////////////////////
 965 void
 966 FGMultiplayMgr::ProcessChatMsg(const MsgBuf& Msg,
 967                                const simgear::IPAddress& SenderAddress)
 968 {
 969   const T_MsgHdr* MsgHdr = Msg.msgHdr();
 970   if (MsgHdr->MsgLen < sizeof(T_MsgHdr) + 1) {
 971     SG_LOG( SG_NETWORK, SG_DEBUG, "FGMultiplayMgr::MP_ProcessData - "
 972             << "Chat message received with insufficient data" );
 973     return;
 974   }
 975
 976   char *chatStr = new char[MsgHdr->MsgLen - sizeof(T_MsgHdr)];
 977   const T_ChatMsg* ChatMsg
 978       = reinterpret_cast<const T_ChatMsg *>(Msg.Msg + sizeof(T_MsgHdr));
 979   strncpy(chatStr, ChatMsg->Text,
 980           MsgHdr->MsgLen - sizeof(T_MsgHdr));
 981   chatStr[MsgHdr->MsgLen - sizeof(T_MsgHdr) - 1] = '\0';
 982
 983   SG_LOG (SG_NETWORK, SG_WARN, "Chat [" << MsgHdr->Callsign << "]"
 984            << " " << chatStr);
 985
 986   delete [] chatStr;
 987 } // FGMultiplayMgr::ProcessChatMsg ()
 988 //////////////////////////////////////////////////////////////////////
 989
 990 void
 991 FGMultiplayMgr::FillMsgHdr(T_MsgHdr *MsgHdr, int MsgId, unsigned _len)
 992 {
 993   uint32_t len;
 994   switch (MsgId) {
 995   case CHAT_MSG_ID:
 996     len = sizeof(T_MsgHdr) + sizeof(T_ChatMsg);
 997     break;
 998   case POS_DATA_ID:
 999     len = _len;
1000     break;
1001   default:
1002     len = sizeof(T_MsgHdr);
1003     break;
1004   }
1005   MsgHdr->Magic           = XDR_encode_uint32(MSG_MAGIC);
1006   MsgHdr->Version         = XDR_encode_uint32(PROTO_VER);
1007   MsgHdr->MsgId           = XDR_encode_uint32(MsgId);
1008   MsgHdr->MsgLen          = XDR_encode_uint32(len);
1009   MsgHdr->ReplyAddress    = 0; // Are obsolete, keep them for the server for
1010   MsgHdr->ReplyPort       = 0; // now
1011   strncpy(MsgHdr->Callsign, mCallsign.c_str(), MAX_CALLSIGN_LEN);
1012   MsgHdr->Callsign[MAX_CALLSIGN_LEN - 1] = '\0';
1013 }
1014
1015 FGAIMultiplayer*
1016 FGMultiplayMgr::addMultiplayer(const std::string& callsign,
1017                                const std::string& modelName)
1018 {
1019   if (0 < mMultiPlayerMap.count(callsign))
1020     return mMultiPlayerMap[callsign].get();
1021
1022   FGAIMultiplayer* mp = new FGAIMultiplayer;
1023   mp->setPath(modelName.c_str());
1024   mp->setCallSign(callsign);
1025   mMultiPlayerMap[callsign] = mp;
1026
1027   FGAIManager *aiMgr = (FGAIManager*)globals->get_subsystem("ai_model");
1028   if (aiMgr) {
1029     aiMgr->attach(mp);
1030
1031     /// FIXME: that must follow the attach ATM ...
1032     for (unsigned i = 0; i < numProperties; ++i)
1033       mp->addPropertyId(sIdPropertyList[i].id, sIdPropertyList[i].name);
1034   }
1035
1036   return mp;
1037 }
1038
1039 FGAIMultiplayer*
1040 FGMultiplayMgr::getMultiplayer(const std::string& callsign)
1041 {
1042   if (0 < mMultiPlayerMap.count(callsign))
1043     return mMultiPlayerMap[callsign].get();
1044   else
1045     return 0;
1046 }