Come importare livelli e overlay MilX

Questo capitolo mostra come importare i livelli MilX, oppure come importare livelli personalizzati da grafica vettoriale o immagini bitmap.

Panoramica

I seguenti tipi di livelli dati possono essere importati in map.army :

TipoDescrizione
MilXSituazione tattica creata in map.army ed esportata.
Grafica vettorialeQualsiasi grafica in formato vettoriale
Grafica immagineQualsiasi immagine raster

Livelli MilX

I file con estensione .milxlyz sono stati esportati dal generatore di situazioni militari. Questi possono essere reimportati, visualizzati ed elaborati ulteriormente.

Se hai già creato livelli sulla tua mappa, i livelli importati vengono sempre aggiunti. I livelli esistenti non vengono modificati.

Livelli vettoriali

È possibile importare grafica vettoriale come livelli e visualizzarla nella carta della situazione. Sono possibili i seguenti formati grafici:

EstensioneFormato
*.kmlKeyhole Markup Language (ad es. da Google Earth)
*.gpxIl formato GPS Exchange è un formato dati per memorizzare dati geospaziali
*.jsonJavaScript Object Notation — formato dati per lo scambio di dati tra applicazioni
*.geojsonGeoJSON — formato aperto per rappresentare dati geografici secondo la specifica Simple Feature Access

Note sull’importazione KML

I file KML spesso fanno riferimento a icone personalizzate tramite attributi href all’interno dei segnaposto. map.army non conserva queste riferimenti alle icone all’importazione — ogni elemento viene visualizzato con un simbolo di base generico. I file KML di dimensioni moderate si importano in modo affidabile; input vettoriali molto grandi possono superare i limiti di punti per simbolo — dividili in file più piccoli se necessario.

Dopo l’importazione, un livello vettoriale può essere convertito in livello MilX tramite la finestra di dialogo delle impostazioni del livello. Il livello MilX risultante accetta l’editor grafico tattico completo ed esporta come .milxlyz. Una volta convertito, il simbolo di base assegnato durante la conversione non può essere modificato nell’applicazione — vedi la voce FAQ su come cambiare il simbolo di un elemento importato per l’alternativa nel flusso di lavoro del progetto.

Preservazione di stile e colore

map.army analizza la geometria e le proprietà di stile standard dalle importazioni vettoriali, ma gli attributi di colore e stile per elemento di strumenti di terze parti potrebbero non essere preservati:

  • GPX non ha una proprietà di colore standardizzata nello schema di base. Alcuni strumenti (Garmin, Scribblemaps) scrivono un’estensione non standard topografix:color che map.army non analizza — gli elementi importati tornano allo stile predefinito.
  • JSON / GeoJSON non hanno nemmeno un attributo di stile obbligatorio per schema; gli stili variano per produttore e la maggior parte delle estensioni non vengono analizzate.
  • Gli stili KML (<Style> con colore <LineStyle>, href <IconStyle>) sono parzialmente rispettati per la geometria ma le icone href non vengono preservate (vedi Note sull’importazione KML sopra).

Se il colore è importante, modifica il livello vettoriale o MilX risultante in map.army dopo l’importazione, oppure genera il file sorgente con dichiarazioni di stile conformi agli standard.

Livelli immagine

È possibile importare grafica raster come livello e visualizzarla nella carta della situazione. Sono possibili i seguenti formati grafici:

EstensioneFormato
*.pngPortable Network Graphics — formato di grafica raster con compressione dati senza perdita
*.svgScalable Vector Graphics — grafica vettoriale visualizzata come livello immagine
*.jfifFormato grafico JPEG File Interchange Format
*.pjpegJPEG progressivo bitmap
*.jpeg, *.jpgFormato immagine JPEG — uno dei formati di immagine più comuni
*.pjpJPEG progressivo (estensione alternativa)
*.bmpWindows Bitmap — formato grafico raster bidimensionale sviluppato per Microsoft Windows
*.webpWebP — formato grafico sviluppato da Google per immagini compresse

Come aggiungere un livello immagine

  1. Apri Livelli mappa → Aggiungi livello → Immagine.
  2. Il testo del pulsante varia per browser e sistema operativo: in Chrome / Edge su desktop spesso indica Seleziona directory di lavoro (selettore di cartella), mentre in Safari e browser mobili indica Seleziona file (selettore di file singolo). Entrambi portano allo stesso risultato.
  3. Seleziona il file immagine. Per il posizionamento georeferenziato, includi anche il file world corrispondente (.pgw per PNG, .jgw per JPG — vedi Export as Georeferenced Image).
  4. Posiziona l’immagine con le maniglie di trascinamento / zoom / rotazione fino al punto desiderato.
  5. Fai clic sul pulsante verde Aggiungi livello per confermare il livello sulla mappa. Fino a quando non premi Add Layer, il livello è in attesa nella finestra di dialogo di importazione ma non ancora visibile — questo passaggio di conferma finale è quello più comunemente mancato ed è la causa delle segnalazioni «il livello immagine importato non viene visualizzato».
Suggerimento: Limiti pratici di dimensione: gli overlay immagine molto grandi (diverse decine di MB, o dimensioni in pixel superiori a ~10 000 px per lato) potrebbero non essere visualizzati in alcuni browser. Se una grande immagine sorgente non appare, dividila in riquadri e aggiungi ogni riquadro come livello immagine separato.

Overlay immagine e il formato .milxlyz

Le coordinate di posizionamento del livello immagine vengono scritte in un file sidecar config.json accanto al file immagine. Per preservare un overlay immagine tra le sessioni, tieni il file immagine e il JSON insieme — quando riapri il selettore di immagini e selezioni la stessa directory, map.army ripristina automaticamente il posizionamento originale.

I livelli immagine non sono incorporati nelle esportazioni .milxlyz. Quando condividi o salvi il tuo lavoro come MilX, il contenuto del livello immagine viene tralasciato. Per condividere una mappa che include un overlay immagine, condividi il file immagine separatamente, oppure usa un livello immagine sorgente online — vedi Share Online-Source Layers.

Overlay immagine per grafica personalizzata e mappe fittizie

Gli overlay immagine sono la soluzione alternativa supportata per qualsiasi caso d’uso che necessita di grafica non standard sulla mappa:

  • Mappe di campagna scansite o mappe storiche come sfondo.
  • Mappe di nazioni fittizie per scenari di wargame o gioco di ruolo.
  • Emblemi personalizzati, stemmi di unità o altro artwork sopra i simboli MIL-STD-2525.

Queste grafiche si trovano su un livello immagine separato; non sono incorporate nei singoli simboli militari (il formato di scambio MIL-STD-2525 / JC3IEDM non può portare immagini arbitrarie sui simboli). Per icone amplificatrici che si allegano a un simbolo, usa l’Modificatore di estensione icona in modalità Extended — vedi Simboli → Editor simboli.

Overlay immagine nella PWA desktop — comportamento aggiuntivo

Quando map.army viene eseguito come Progressive Web App (installata sul desktop), gli overlay immagine si comportano in modo leggermente diverso rispetto alla scheda del browser:

Suggerimento: Eliminare un livello immagine nella PWA desktop elimina anche il file immagine sorgente dal disco (non solo il riferimento al livello). L’eliminazione va direttamente al file system — non al cestino. Conserva una copia dell’immagine sorgente altrove prima di aggiungerla come livello, oppure usa la scheda del browser per la sperimentazione.

Un secondo comportamento specifico della PWA riguarda l’ordine di caricamento: se apri prima un .milxlyz e poi aggiungi un livello immagine nella stessa sessione, il livello immagine potrebbe non essere recuperato automaticamente al successivo ricaricamento della sessione. Il flusso di lavoro affidabile è aggiungere il livello immagine prima, posizionarlo, poi caricare qualsiasi livello MilX sopra. Se ti trovi in uno stato in cui il livello immagine non torna al ricaricamento, aggiungilo nuovamente manualmente dalla coppia immagine + config.json salvata.

Overlay immagine vs cambio mappa di base

L’importazione di un overlay immagine è supportata nell’app web pubblica ed è lo strumento corretto per aggiungere uno sfondo personalizzato a una mappa.

Cambiare la mappa di base stessa verso un fornitore WMTS / WMS privato (in modo che le tessere della mappa sottostante cambino) è una capacità separata, disponibile solo nel deployment professionale / in rete chiusa. Vedi la voce FAQ sulla versione professionale.