EXAMPLE_MultiMap_Config.xml

<!-- EXAMPLE: Multi-Map Configuration for DGScope (NEW SYSTEM) -->
<!-- This shows how to configure multiple video maps with the NEW VideoMapFiles feature -->

<!-- NEW FEATURE: Configure multiple GeoJSON files directly in XML! -->
<!-- Each file can have its own map number, mnemonic, name, brightness group, and DCB button -->

<VideoMapFiles>
  <VideoMapFile>
    <Filepath>C:\maps\runways.geojson</Filepath>
    <MapNumber>1</MapNumber>
    <ShortName>RWY</ShortName>
    <FullName>ILM Runways</FullName>
    <BrightnessGroup>A</BrightnessGroup>
    <DCBButton>1</DCBButton>  <!-- DCB Button 1 (top-left on main menu) -->
  </VideoMapFile>
  <VideoMapFile>
    <Filepath>C:\maps\boundaries.geojson</Filepath>
    <MapNumber>2</MapNumber>
    <ShortName>BDRY</ShortName>
    <FullName>Airspace Boundaries</FullName>
    <BrightnessGroup>A</BrightnessGroup>
    <DCBButton>2</DCBButton>  <!-- DCB Button 2 (bottom-left on main menu) -->
  </VideoMapFile>
  <VideoMapFile>
    <Filepath>C:\maps\taxiways.geojson</Filepath>
    <MapNumber>3</MapNumber>
    <ShortName>TWY</ShortName>
    <FullName>Taxiways</FullName>
    <BrightnessGroup>B</BrightnessGroup>
    <DCBButton>3</DCBButton>  <!-- DCB Button 3 (on main menu) -->
  </VideoMapFile>
  <VideoMapFile>
    <Filepath>C:\maps\terrain.geojson</Filepath>
    <MapNumber>4</MapNumber>
    <ShortName>TERR</ShortName>
    <FullName>Terrain Features</FullName>
    <BrightnessGroup>B</BrightnessGroup>
    <DCBButton>4,5</DCBButton>  <!-- MULTIPLE DCB BUTTONS: Buttons 4 and 5 both control this map -->
  </VideoMapFile>
  <VideoMapFile>
    <!-- OPTIONAL FIELDS EXAMPLE: Minimal configuration with all defaults -->
    <Filepath>C:\maps\mva_sectors.geojson</Filepath>
    <!-- MapNumber omitted: will auto-assign next available number (5) -->
    <!-- ShortName omitted: will default to "mva_sectors" (filename) -->
    <!-- FullName omitted: will default to "mva_sectors" (filename) -->
    <!-- BrightnessGroup omitted: will default to A -->
    <!-- DCBButton omitted/0: will NOT appear on DCB, only in Ctrl+F2 selector -->
  </VideoMapFile>
  <VideoMapFile>
    <!-- ULTRA MINIMAL EXAMPLE: Only filepath required! -->
    <Filepath>C:\maps\obstacles.geojson</Filepath>
  </VideoMapFile>
</VideoMapFiles>

<!-- BACKWARD COMPATIBILITY: Old single-file system still works -->
<!-- If VideoMapFiles is empty or not present, falls back to VideoMapFilename -->
<!-- <VideoMapFilename>C:\maps\legacy_all_maps.geojson</VideoMapFilename> -->

<!-- TCP Configuration -->
<TCP>
  <DCBMapList>
    <!-- Auto-populated by VideoMapFile.DCBButton during load -->
    <!-- Button 0-5 are on main DCB menu -->
    <int>1</int>  <!-- Button 0 -> Map 1 (auto-set) -->
    <int>2</int>  <!-- Button 1 -> Map 2 (auto-set) -->
    <int>3</int>  <!-- Button 2 -> Map 3 (auto-set) -->
    <int>4</int>  <!-- Button 3 -> Map 4 (auto-set) -->
    <int>0</int>  <!-- Button 4 -> None -->
    <int>0</int>  <!-- Button 5 -> None -->
    <!-- Buttons 6-31 are in MAPS submenu -->
    <int>0</int>
    <int>0</int>
    <!-- ... continue to 36 total entries ... -->
  </DCBMapList>
</TCP>

<!-- Preference Set (Initial visibility and brightness) -->
<CurrentPrefSet>
  <DisplayedMaps>
    <int>1</int>  <!-- Map 1 visible on startup -->
    <int>2</int>  <!-- Map 2 visible on startup -->
  </DisplayedMaps>
  <Brightness>
    <MapA>100</MapA>  <!-- Category A brightness (5-100) -->
    <MapB>80</MapB>   <!-- Category B brightness (5-100) -->
  </Brightness>
</CurrentPrefSet>

<!-- Colors for each category -->
<VideoMapLineColor>-12566464</VideoMapLineColor>   <!-- Category A color (ARGB) -->
<VideoMapLineColorB>-14671840</VideoMapLineColorB> <!-- Category B color (ARGB) -->

<!--
KEY FEATURES:
1. Filepath: Path to each GeoJSON file (can be absolute or relative) [REQUIRED]
2. MapNumber: Unique number for the map (used for DCB mapping and visibility) [OPTIONAL - auto-assigns]
3. ShortName: Mnemonic shown on DCB button (e.g., "RWY", "BDRY") [OPTIONAL - defaults to filename]
4. FullName: Descriptive name shown in map selector [OPTIONAL - defaults to filename]
5. BrightnessGroup: A or B (determines which brightness control affects it) [OPTIONAL - defaults to A]
6. DCBButton: Which button(s) (1-36) control this map [OPTIONAL - if omitted/0, map only shows in Ctrl+F2]
   - Single button: <DCBButton>3</DCBButton>
   - Multiple buttons: <DCBButton>3,11</DCBButton> (same map on buttons 3 and 11)

OPTIONAL FIELD DEFAULTS:
- MapNumber: If omitted or 0, auto-assigns next available number starting from 1
- ShortName: If omitted or empty, uses filename without extension
- FullName: If omitted or empty, uses filename without extension
- BrightnessGroup: If omitted, defaults to A (MapCategory.A)
- DCBButton: If omitted, empty, or 0, map will NOT appear on DCB buttons but WILL appear in Ctrl+F2 selector

MULTIPLE DCB BUTTONS:
- You can assign the same map to multiple DCB buttons using comma or semicolon separators
- Examples: "3,11" or "3;11" - both buttons 3 and 11 will control the same map
- Useful when you want the same map accessible from different DCB pages/locations

NOTES:
- Each GeoJSON file becomes ONE map in the system
- XML metadata overrides any properties in the GeoJSON file itself
- DCBButton automatically updates TCP.DCBMapList during load
- Maps can be toggled on/off via DCB buttons or Ctrl+F2 selector
- Category A and B have independent brightness controls (MPA/MPB)
- Supported geometry types: LineString, Polygon, MultiLineString, MultiPolygon, GeometryCollection
-->