This is the file format of the Falcon BMS weather maps (“FMAPs”). The file is in binary format with fixed field lengths.
| Field | Type | Description | Conditions/Notes |
|---|---|---|---|
ver |
DWORD (4 bytes) |
File version, currently 8. | Must be >= 4 |
XCELLS, YCELLS |
int (4 bytes each) |
Grid dimensions for weather map. | Must match predefined constants TheaterXCells and TheaterYCells. Otherwise, processing stops. |
m_nMap_New_Wind_Heading |
int (4 bytes) |
Global wind heading. | Represents the global direction shifting of the whole map. |
m_fMap_New_Wind_Speed |
float (4 bytes) |
Global wind speed (kts). | Represents the global speed in which the whole map is shifting. |
m_nMap_New_StratusZ_Fair |
int (4 bytes) |
Altitude of fair weather stratus clouds (ft). | - |
m_nMap_New_StratusZ_Incl |
int (4 bytes) |
Altitude of inclement stratus clouds (ft). | - |
m_nMap_New_ContrailLayer |
int[4] (4 × 4 bytes) |
Contrail layer data (ft). | Array of four integers, each representing a contrail layer: SUNNY, FAIR, POOR, INCLEMENT |
m_n_New_BasicCondition |
int (4 bytes per cell) |
Basic weather condition per cell. | SUNNY=0,FAIR=1,POOR=2,INCLEMENT=3. Loops over all XCELLS × YCELLS grid cells. |
m_f_New_Pressure |
float (4 bytes per cell) |
Atmospheric pressure per cell (mBar). | - |
m_f_New_Temperature |
float (4 bytes per cell) |
Temperature per cell (deg. Celsius). | - |
m_f_New_WindSpeed |
float[10] (40 bytes/cell) |
Array of wind speeds at different altitudes for each cell (kts). | - |
m_f_New_WindHeading |
float[10] (40 bytes/cell) |
Array of wind headings at different altitudes for each cell (degrees). | |
m_f_New_CumulusZ |
float (4 bytes per cell) |
Altitude of cumulus clouds for each cell (ft). | |
m_n_New_CumulusDensity |
int (4 bytes per cell) |
Density of cumulus clouds for each cell (1-13). | - |
m_f_New_CumulusSize |
float (4 bytes per cell) |
Size of cumulus clouds for each cell (0-5). | - |
m_n_New_HasTowerCumulus |
int (4 bytes per cell) |
Indicates presence of tower cumulus clouds in each cell (0-1). | - |
m_n_New_HasShowerCumulus |
int (4 bytes per cell) |
Indicates presence of shower cumulus clouds in each cell (0-1). | If ver < 7, this value defaults to 1 for all cells. |
m_f_New_FogEndBelowLayerMapData |
float (4 bytes per cell) |
Fog layer boundary for each cell (km). | |
m_f_New_FogLayerZ |
float (4 bytes per cell) |
Altitude of fog layer for each cell (ft). | If ver < 8, defaults to m_f_New_CumulusZ. |