src/MultiPlayer/mpmessages.hxx

   1 // mpmessages.hxx -- Message definitions for multiplayer communications
   2 // within a multiplayer Flightgear
   3 //
   4 // Written by Duncan McCreanor, started February 2003.
   5 // duncan.mccreanor@airservicesaustralia.com
   6 //
   7 // Copyright (C) 2003  Airservices Australia
   8 //
   9 // This program is free software; you can redistribute it and/or
  10 // modify it under the terms of the GNU General Public License as
  11 // published by the Free Software Foundation; either version 2 of the
  12 // License, or (at your option) any later version.
  13 //
  14 // This program is distributed in the hope that it will be useful, but
  15 // WITHOUT ANY WARRANTY; without even the implied warranty of
  16 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  17 // General Public License for more details.
  18 //
  19 // You should have received a copy of the GNU General Public License
  20 // along with this program; if not, write to the Free Software
  21 // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  22 //
  23
  24 #ifndef MPMESSAGES_H
  25 #define MPMESSAGES_H
  26
  27 #define MPMESSAGES_HID "$Id$"
  28
  29 /****************************************************************
  30 * @version $Id$
  31 *
  32 * Description: Each message used for multiplayer communications
  33 * consists of a header and optionally a block of data. The combined
  34 * header and data is sent as one IP packet.
  35 *
  36 ******************************************************************/
  37
  38 #include <vector>
  39
  40 #include <plib/sg.h>
  41 #include <simgear/compiler.h>
  42 #include <simgear/props/props.hxx>
  43 #include <simgear/math/SGMath.hxx>
  44 #include "tiny_xdr.hxx"
  45
  46 // magic value for messages
  47 const uint32_t MSG_MAGIC = 0x46474653;  // "FGFS"
  48 // protocoll version
  49 const uint32_t PROTO_VER = 0x00010001;  // 1.1
  50
  51 // Message identifiers
  52 #define CHAT_MSG_ID             1
  53 #define UNUSABLE_POS_DATA_ID    2
  54 #define OLD_OLD_POS_DATA_ID     3
  55 #define OLD_POS_DATA_ID         4
  56 #define OLD_PROP_MSG_ID         5
  57 #define RESET_DATA_ID           6
  58 #define POS_DATA_ID             7
  59
  60 // XDR demands 4 byte alignment, but some compilers use8 byte alignment
  61 // so it's safe to let the overall size of a network message be a
  62 // multiple of 8!
  63 #define MAX_CALLSIGN_LEN        8
  64 #define MAX_CHAT_MSG_LEN        256
  65 #define MAX_MODEL_NAME_LEN      96
  66 #define MAX_PROPERTY_LEN        52
  67
  68 // Header for use with all messages sent
  69 struct T_MsgHdr {
  70     xdr_data_t  Magic;                  // Magic Value
  71     xdr_data_t  Version;                // Protocoll version
  72     xdr_data_t  MsgId;                  // Message identifier
  73     xdr_data_t  MsgLen;                 // absolute length of message
  74     xdr_data_t  ReplyAddress;           // (player's receiver address
  75     xdr_data_t  ReplyPort;              // player's receiver port
  76     char Callsign[MAX_CALLSIGN_LEN];    // Callsign used by the player
  77 };
  78
  79 // Chat message
  80 struct T_ChatMsg {
  81     char Text[MAX_CHAT_MSG_LEN];       // Text of chat message
  82 };
  83
  84 // Position message
  85 struct T_PositionMsg {
  86     char Model[MAX_MODEL_NAME_LEN];    // Name of the aircraft model
  87
  88     // Time when this packet was generated
  89     xdr_data2_t time;
  90     xdr_data2_t lag;
  91
  92     // position wrt the earth centered frame
  93     xdr_data2_t position[3];
  94     // orientation wrt the earth centered frame, stored in the angle axis
  95     // representation where the angle is coded into the axis length
  96     xdr_data_t orientation[3];
  97
  98     // linear velocity wrt the earth centered frame measured in
  99     // the earth centered frame
 100     xdr_data_t linearVel[3];
 101     // angular velocity wrt the earth centered frame measured in
 102     // the earth centered frame
 103     xdr_data_t angularVel[3];
 104
 105     // linear acceleration wrt the earth centered frame measured in
 106     // the earth centered frame
 107     xdr_data_t linearAccel[3];
 108     // angular acceleration wrt the earth centered frame measured in
 109     // the earth centered frame
 110     xdr_data_t angularAccel[3];
 111 };
 112
 113 struct FGPropertyData {
 114   unsigned id;
 115
 116   // While the type isn't transmitted, it is needed for the destructor
 117   SGPropertyNode::Type type;
 118   union {
 119     int int_value;
 120     float float_value;
 121     char* string_value;
 122   };
 123
 124   ~FGPropertyData() {
 125     if ((type == SGPropertyNode::STRING) || (type == SGPropertyNode::UNSPECIFIED))
 126     {
 127       delete [] string_value;
 128     }
 129   }
 130 };
 131
 132
 133
 134 // Position message
 135 struct FGExternalMotionData {
 136   // simulation time when this packet was generated
 137   double time;
 138   // the artificial lag the client should stay behind the average
 139   // simulation time to arrival time diference
 140   // FIXME: should be some 'per model' instead of 'per packet' property
 141   double lag;
 142
 143   // position wrt the earth centered frame
 144   SGVec3d position;
 145   // orientation wrt the earth centered frame
 146   SGQuatf orientation;
 147
 148   // linear velocity wrt the earth centered frame measured in
 149   // the earth centered frame
 150   SGVec3f linearVel;
 151   // angular velocity wrt the earth centered frame measured in
 152   // the earth centered frame
 153   SGVec3f angularVel;
 154
 155   // linear acceleration wrt the earth centered frame measured in
 156   // the earth centered frame
 157   SGVec3f linearAccel;
 158   // angular acceleration wrt the earth centered frame measured in
 159   // the earth centered frame
 160   SGVec3f angularAccel;
 161
 162   // The set of properties recieved for this timeslot
 163   std::vector<FGPropertyData*> properties;
 164 };
 165
 166 #endif