User:Callahanp/Flightgear and Simgear Code/Subsystems

From FlightGear wiki
< User:Callahanp‎ | Flightgear and Simgear Code
Revision as of 20:57, 28 May 2018 by Callahanp (Talk | contribs) (mark as obsolete due to recent changes in subsystems.)

Jump to: navigation, search

As of Flightgear 2018.2.1, the material below is bsoleted by recent changes in the way subsystems and groups of subsystems are managed.

What it's intended to cover is partially covered in From Command Line to Holding_Short

The Flightgear and Simgear codebase can be broken down into subsystems. Some of these are Managed and accessed through simgear's SGSubsystemMgr. Others have their own componentManager independent of SGSubsystemMgr. Still others have no Manager function per se.

The lists below give starting points for exploration of the various subsystems in Flightgear/Simgear. As a person new to the Flightgear projects codebase, I think its important to understand the code in the following areas in some detail. It is also important to know that as of March 2018 subsystems and their management was under active discussion on the mailing list. The result of these discussions is a change in the way subsystems are created, initialized, bound and deleted. Work in this area is significant and will have an impact on both testing and the HLA/RTI or other parallelization efforts.

  • Edward d'Auvergne's e-mail on testing
    • Factory Methods
    • globals, constructors, init, bind, Incremental Init, update, sub-system dependencies
    • syncronizing a global property tree with local property trees
  • FGPrecipitationMgr
  • FGTrafficMgr
  • How Sub-Systems are managed
  • Subsystems that are not managed
  • How the main event loop works
  • How properties are set and how their values are accessed. This includes understanding the concept of "tied" properties.
  • How I/O works, especially I/O used for communications over HTTP or Telnet.

Simgear Subsystem Groups

The information below is intended to serve as a starting point for exploring code releated to these subsystems.

WIP.png Work in progress
This article or section will be worked on in the upcoming hours or days.
See history for the latest developments.
Subsystems - Managed by the Subsystem Manager
Subsystem Name Folder Class Description / Comments
ai-model flightgear/src/AIModel/AIManager.cxx <FGAIManager>
aircraft-performance-db flightgear/src/AIModel/performancedb.cxx
airport-dynamics src/Airports/airportDynamicsManager.cxx <AirportDynamicsManager>
ATC src/ATC see flightgear/src/ATC/atc_mgr.hxx
CanvasMgr, Canvas & CanvasGUI flightgear/src/Canvas/canvas_mgr.cxx
controls src/Aircraft/controls.cxx <FGControls>
dns src/Network/DNSClient.cxx <FGDNSClient>
environment src/Environment/environment_mgr.cxx
ephemeris src/Environment/ephemeris.cxx
http src/Network/HTTPClient.cxx <FGHTTPClient>
input-mouse /src/Input <FGMouserInput>
scenery /src/Scenery <scenery> <FGScenery>
view-manager /src/Viewer <FGViewMgr>
gui /src/GUI <NewGUI> See PUI
history tracks position and appends it to a buffer (used by the map dialog)
input /src/input
kln89 /src/Instrumentation/kln89 legacy GPS implementation, OD_Gauge based
logger src/Main/logger.cxx
model-manager /src/Model/modelmgr.cxx
nasal flightgear/src/Scripting <FGNasalSys> scripting subsystem
realwx /src/Environment
route-manager /src/Navaids Route manager
sound /src/Sound/soundmanager.cxx <SGSoundManager> <FGSoundManager>
terrasync $SG_SRC simgear/simgear/scene/tsync/terrasync.cxx <SGTerraSync> (terrasync in sim [1]
time /src/Time/TimeManager.cxx <TimeManager>
traffic-manager /src/Traffic/TrafficMgr.cxx
Subsystems - Independently Managed
Subsystem Name Module Class Name Description
Add-Ons src/Add-ons/
Cockpit src/Cockpit/CockpitDisplayManager.cxx
Events src/Instrumentation/instrument_manager.cxx
Embedded Resources simgear/embedded_resources/EmbeddedResourceManager.cxx
Instrument src/Instrumentation/instrument_manager.cxx
Magnetic Variance src/Environment/magvarmanager.cxx
Multiplay src/Multiplayer/multiplaymgr.cxx
Systems src/Systems/system_mgr.cxx
Subsystems simgear/Systems/SGSubsystemMgr.cxx
Subsystems - Unmanaged
Subsystem Name Folder or Module Classes Description
Aircraft src/Aircraft
Autopilot src/Autopilot (FDM-interleaved)
Flight Dynamics Models src/FDM
Navigational Aids /src/Navaids see also Navcache
Network /src/Network
scripts/python/Terrasync folder
Properties /src/Main/fg_props.cxx
ChangeListener Classes
SGCondition and sub-classes
Easing Functions
See also flightgear/docs-mini/Nasal.html
Radio /src/Radio
Systems /src/Systems
Viewer /src/Viewer