-- X-Space (release 2b) ---------------------------- Best viewed in monospace --

This is the X-Plane spaceflight enhancement plugin. It makes the following changes:
 - Fixes integration errors in X-Plane
 - Adds atmospheric scattering visible from orbit
 - Adds reaction control system/custom thrusters support
 - Extra camera views
 - Makes X-Plane Earth & Mars to rotate
 - Adds datarefs for inertial/non-inertial coordinate systems
 - Adds WMM (magnetic model) and datarefs for it
 - Makes it possible to launch from launch pads
 
This is a test release of a sort. It's not useable for making rockets that fly
yet, but it's good enough to start working on those rockets.


--------------------------------------------------------------------------------
 AUTHORSHIP
--------------------------------------------------------------------------------

 X-Space plugin written by Black Phoenix
 XGDC OS written by Black Phoenix
 WMM model implementation by Manoj C Nair and Adam Woods
 NRLMSISE-00 model implementation by Dominik Brodowski
 RV-550 Ares-1 with Orion capsule X-Plane model by Curt Boyll
 SASL plugin by A.A.Babichev
 
 
--------------------------------------------------------------------------------
 VERSION INFORMATION
--------------------------------------------------------------------------------

 X-Space (release 2b)
 RV-550 Ares-1 (XSAG SVN R213)
 XGDC OS (XSAG SVN R213)
 WMM (WMM2010)
 NORAD element sets (June 2011)
 
 
 Changes from release 2a:
   - Added more features to the RV-550 rocket
   - Fixed orbital counter
   - Fixed problems with launch pad "escaping" under ground
   - RCS jets are now drawn in a bit nicer way
   - Changed camera hotkey from "]" to "SHIFT+]"

 
--------------------------------------------------------------------------------
 INSTALLING
--------------------------------------------------------------------------------

Just copy contents of folders in this archive into corresponding folders in
X-Plane 9 folder. The folders must be merged together (not replace them).

To uninstall it just delete the following folders:
  \X-Plane 9\Resources\plugins\x-space
  \X-Plane 9\Aircraft\XSAG
  

--------------------------------------------------------------------------------
 CONTENTS
--------------------------------------------------------------------------------

 x-space/win.xpl       X-Space (windows, msvs)
 x-space/lin.xpl       X-Space (linux, gcc)
 x-space/mac.xpl       X-Space (mac, gcc)
 x-space/glonass.dat   GLONASS statellite data
 x-space/gps.dat       GPS satellite data
 x-space/trdss.dat     TRDSS satellite data
 x-space/pads.dat      List of launch pads
 x-space/EGM9615.BIN   Geoid model (part of WMM)
 x-space/WMM.COF       Magnetic model (part of WMM)
 x-space/obj/          Extra graphic files
 
 XSAG/RV-550           Ares-1 launcher with Orion capsule
 XSAG/XSV              Shared data (required for XSAG aircraft)
 
Updates to the magnetic model can be found at:
  http://www.ngdc.noaa.gov/geomag/WMM/DoDWMM.shtml

Updates to satellite data can be found at:
  http://celestrak.com/NORAD/elements/


--------------------------------------------------------------------------------
 MANUAL OF A SORT
--------------------------------------------------------------------------------

These are the extra camera views added by the plugin:
  SHIFT+]  Locked-orientation spot around vehicle
  X        Space-walk mode (only somewhat working in this release)
  Q        Hold this for mouse-look (Space-walk mode only)
  
Extra commands are added (that can be bound to joystick buttons or keys):
  sim/rcs/xp  X+ translation input (forward)
  sim/rcs/xm  X- translation input (backward)
  sim/rcs/yp  Y+ translation input (left)
  sim/rcs/ym  Y- translation input (right)
  sim/rcs/zp  Z+ translation input (up)
  sim/rcs/zm  Z- translation input (down)
  
Extra datarefs are added (all datarefs are doubles, can be read/written as floats):
  sim/local/magnetic/decl           Magnetic declination/variation (degrees)
  sim/local/magnetic/incl           Magnetic inclination (degrees)
  sim/local/magnetic/F              Strength of magnetic field (nT)
  sim/local/magnetic/H              Strength of horizontal component of magnetc field (nT)
  sim/local/magnetic/X              X component of magnetic field (nT)
  sim/local/magnetic/Y              Y component of magnetic field (nT)
  sim/local/magnetic/Z              Z component of magnetic field (nT)
  sim/local/magnetic/GV             Grid variation (degrees)
  
  sim/noninertial/magnetic/X        X component of magnetic field (nT)
  sim/noninertial/magnetic/Y        Y component of magnetic field (nT)
  sim/noninertial/magnetic/Z        Z component of magnetic field (nT)
  
  sim/inertial/magnetic/X           X component of magnetic field (nT)
  sim/inertial/magnetic/Y           Y component of magnetic field (nT)
  sim/inertial/magnetic/Z           Z component of magnetic field (nT)
  
  sim/space/pad_release             Write 1.0 to release vehicle from pad
  sim/space/pad_locked              Is vehicle released from launch pad (1 or 0)?
  
  sim/noninertial/energy/total      Total energy (KJ)
  sim/noninertial/energy/kinetic    Kinetic energy (KJ)
  sim/noninertial/energy/potential  Potential energy (KJ)
  sim/noninertial/energy/error      Error in energy due to integration (J)
  
  sim/orbital/count                 How many orbits have been made so far
  
  sim/inertial/position/rx          Inertial position
  sim/inertial/position/ry
  sim/inertial/position/rz
  sim/inertial/position/vx          Inertial velocity
  sim/inertial/position/vy
  sim/inertial/position/vz
  sim/inertial/position/ax          Inertial acceleration
  sim/inertial/position/ay
  sim/inertial/position/az
  
  sim/noninertial/position/rx       Noninertial position
  sim/noninertial/position/ry
  sim/noninertial/position/rz
  sim/noninertial/position/vx       Noninertial velocity
  sim/noninertial/position/vy
  sim/noninertial/position/vz
  sim/noninertial/position/ax       Noninertial acceleration
  sim/noninertial/position/ay
  sim/noninertial/position/az
  
  sim/local/position/rx             Local position (always zero)
  sim/local/position/ry
  sim/local/position/rz
  sim/local/position/vx             Local velocity
  sim/local/position/vy
  sim/local/position/vz
  sim/local/position/ax             Local acceleration
  sim/local/position/ay
  sim/local/position/az
  
  sim/noninertial/position/vmag     Velocity in non-inertial system
  sim/noninertial/position/vvert    Vertical velocity in non-inertial system
  sim/noninertial/position/vgnd     Groundspeed in non-inertial system
  sim/inertial/position/vmag        Velocity in inertial system
  sim/inertial/position/vvert       Vertical velocity in inertial system
  sim/inertial/position/vgnd        Groundspeed in inertial system
  sim/local/position/vmag           Local velocity (along X axis)
  sim/local/position/vvert          Local vertical speed (along Z axis)
  sim/local/position/vgnd           Groundspeed in local coordinate system
  
  sim/inertial/earth/vgnd           True groundspeed of Earth rotation in inertial system
