In questa pagina

Formato di file MilX — Guida al formato di scambio map.army

map.army utilizza MilX (Military Exchange Format) come formato di file nativo per salvare, condividere e importare situazioni militari. Questa pagina è un riferimento orientativo: cos’è il formato, quali file vi appartengono e come ottenere la specifica completa.

Cos’è MilX

MilX è un formato di scambio basato su XML che trasporta la simbologia militare MIL-STD-2525 e le grafiche tattiche tra sistemi. È gestito da gs-soft AG insieme a MSS (Military Symbol Service) ed è lo stesso formato usato da partner industriali, sistemi di comando e controllo e applicazioni di simulazione militare che scambiano dati situazionali con map.army.

Concettualmente, un documento MilX contiene:

• Livelli (Layers) (1) — contenitori nominati e ordinati per simboli e grafiche tattiche.
• Simboli (Symbols) (2) — posizionamenti con un identificatore di simbolo MIL-STD-2525, posizione, atteggiamento, stato e i modificatori pertinenti.
• Grafici tattici (Tactical graphics) (3) — forme multipunto (linee, aree, anelli di portata, ecc.) con la loro geometria e i modificatori.
• Metadati (Metadata) (4) — creatore, timestamp, sistema di coordinate, versione MilX opzionale.

La compatibilità con MIL-STD-2525C / JC3IEDM è un vincolo di progettazione: un file MilX è leggibile da qualsiasi consumer che comprenda lo standard.

Questo non significa che un file MilX sia limitato a ciò che il semplice standard può esprimere. MilX trasporta ogni simbolo come una stringa MSS opaca, modificatori inclusi, invece di modellare esso stesso la simbologia — quindi le estensioni di map.army viaggiano intatte. I set svizzeri disponibili in modalità di lavoro Estesa e gli Icon Extension Modifiers sopravvivono entrambi a un salvataggio e a una condivisione.

Ciò che vede l’altra estremità dipende da cosa si tratta:

• Un consumer basato su MSS che possiede solo la libreria MIL-STD-2525C mostra il simbolo di fallback che la libreria definisce per quel simbolo esteso — un sostituto 2525C designato, non un simbolo vuoto.
• Un consumer che legge solo l’identificatore di simbolo grezzo vede un codice che non riconosce, e lo gestisce come gestisce qualsiasi identificatore sconosciuto.

Estensioni di file

Entrambe le estensioni trasportano lo stesso contenuto; la forma compressa è la predefinita per lo scambio perché le mappe di situazione tipiche con molti simboli si comprimono in modo efficiente.

Vincoli noti

Alcuni vincoli pratici da conoscere quando si genera o si modifica MilX al di fuori dell’applicazione:

• Gli identificatori di simboli seguono MIL-STD-2525. map.army non ne controlla la lunghezza da sé — un file che torna con qualcosa di sbagliato al suo interno è stato rifiutato o corretto dal servizio di conversione, e l’app segnala cosa è successo invece di scartare gli elementi in silenzio.
• I livelli immagine e vettoriali non sono incorporati. Quando map.army salva un .milxlyz, i livelli di immagini sovrapposte e i livelli vettoriali da sorgente online non vengono serializzati nel file. Solo la simbologia MilX viaggia con l’esportazione. (Vedere Importare livelli per il meccanismo del file sidecar delle immagini sovrapposte.)
• Sistema di coordinate. Il sistema di coordinate predefinito nelle esportazioni MilX è WGS84. L’opzione «Impostazioni avanzate livello MilX» in Opzioni → Generale consente di convertire in un sistema di coordinate diverso o in una versione MilX precedente prima del download.
• Puntare a una versione precedente riscrive i modificatori. Per impostazione predefinita non viene sostituito nulla — l’esportazione usa la libreria dei simboli corrente. Ma se attivate le impostazioni avanzate e scegliete una versione della libreria più vecchia, il servizio esegue ogni conversione legacy più recente della versione scelta, e alcune di queste sostituiscono un modificatore con un altro (per esempio un indicatore di distruzione che diventa un modificatore di stato d’impiego). Usatela solo quando il sistema ricevente ha davvero bisogno della versione precedente, e verificate il risultato; l’impostazione predefinita è la scelta senza perdita di dati.
• SysCustPropList non è per lo scambio dati. Il formato porta uno slot di proprietà personalizzate per livello e per grafica destinato ai sistemi partner, e lo schema dichiara esplicitamente che è per uso interno e non deve essere considerato affidabile quando si scambiano dati con altri partner. map.army lo usa per apporre i metadati del documento NVG su un livello. Non basate un’integrazione su di esso.

Ottenere lo schema completo

Lo schema MilX completo e le regole di validazione non sono pubblicati su questo sito di documentazione. Se si integra MilX nel proprio software o si desidera generare file .milxly tramite programmazione (ad esempio tramite uno script o una pipeline di strumenti assistita da LLM), contattare gs-soft AG per la specifica corrente:

• Modulo di contatto
• mss@gs-soft.com

gs-soft collabora con partner industriali sull’integrazione MilX nell’ambito di una licenza MSS / MilX più ampia — vedere la voce FAQ I Web Service MSS e MilX possono essere utilizzati da altri? per il contesto.