English manual · Home

Photo viewpoint

Comandi e finestre di dialogo · GIF

Presentazione e manuale · versione sperimentale 0.7.6

Presentazione

Photo viewpoint è un plugin QGIS per collegare le fotografie di sopralluogo alla posizione di presa, alla direzione dello sguardo e alla documentazione cartografica. Permette di creare punti in tre clic oppure importare più immagini usando i metadati GPS, assegnare codice e didascalia, visualizzare gli originali, correggere le prese con maniglie e generare richiami fotografici nei layout di stampa.

I metadati GPS rimangono separati dalla geometria modificabile. Un campo misura lo scostamento dalla posizione GPS originaria. Gli stili riutilizzabili offrono raggi classici, fotocamera orientata vista dall'alto, freccia di direzione o settore semitrasparente. Dati e oggetti del layout restano elementi nativi QGIS.

Installazione e compatibilità

Il target è QGIS 3 / Qt 5 e QGIS 4 / Qt 6. Il flusso principale è stato provato su QGIS 4.2.3. Le versioni precedenti sono state collaudate dall'utente su QGIS 3.44.14/macOS. Nuovo schema, stili portabili e conversione dei campi richiedono il collaudo desktop. Installa lo ZIP da Plugin → Gestisci e installa plugin → Installa da ZIP. Per aggiornare salva il lavoro, disabilita il plugin, sostituiscilo e riavvia QGIS.

Il pacchetto interno resta prese_fotografiche: è lo stesso plugin. I comandi e le finestre del plugin seguono la lingua configurata in QGIS: italiano se impostato, inglese negli altri casi. La documentazione è disponibile in inglese e italiano.

Creare il layer

Create photo layer apre nome (Photo viewpoint), CRS proiettato in metri, formato e cartella. Puoi scegliere layer temporaneo, GeoPackage, SHP, SQLite o FlatGeobuf, quando il driver è disponibile. La cartella del progetto salvato è proposta inizialmente. Non si sovrascrivono dataset esistenti. Il temporaneo va esportato prima di chiudere; sui file salva normalmente le modifiche. Salva anche il progetto.

Campi e didascalie lunghe

I nuovi campi gestiti dal plugin iniziano con code, caption, distGPS, poi seguono quelli di servizio nello stesso ordine relativo precedente. Un provider può aggiungere una propria chiave, come fid nel GeoPackage; l'ordine visualizzato in QGIS mette davanti i tre campi utente.

CampoContenuto
codeNome/identificativo della presa e sua etichetta.
captionDescrizione sotto codice e nome file nel layout. Nei nuovi formati diversi da SHP è lungo 2.000 caratteri.
distGPSDistanza planimetrica in metri fra GPS e geometria; NULL se manca uno dei due.
azimuth / fov / distanceAzimut di griglia, apertura totale e lunghezza grafica dei raggi.
photo / noteRiferimento all'immagine e note.
gps_* / exif_*Metadati originali e posizione GPS trasformata nel CRS del layer.
vp_statusneeds_pos oppure positioned, secondo la presenza della geometria.
pf_x / pf_y / pf_map / dimX / dimYPosizione nel foglio, mappa associata e dimensioni effettive della foto in mm.

Il DBF dello Shapefile ha un limite breve espresso in byte: il plugin usa larghezza 254 e non può garantire almeno 255 caratteri Unicode. Per didascalie lunghe scegli GeoPackage. Non vengono ampliate o riscritte silenziosamente le colonne dei vecchi file.

Layer precedenti e conversione inglese

I vecchi codice e Didascalia restano leggibili e modificabili. In QGIS vengono impostati alias inglesi e ordine delle colonne, senza cambiare i nomi fisici o i dati originali.

Per uno schema fisicamente inglese apri Apply viewpoint style → Create English-field GeoPackage copy…. Scegli un nuovo file. La copia usa code/caption, didascalie lunghe e l'ordine richiesto; l'originale rimane intatto. Seleziona la copia per usarla. La copia ha nuovi ID di feature e layer: rigenera i richiami fotografici dei layout associandoli al nuovo layer.

Inserimento in tre clic

  1. Seleziona il layer e premi Create viewpoint then link photo.
  2. Primo clic: posizione del fotografo.
  3. Secondo clic: direzione e lunghezza grafica.
  4. Terzo clic: un bordo del campo visivo; l'altro è simmetrico.
  5. Inserisci codice univoco e, facoltativamente, riferimento alla foto.

Esc annulla la presa incompleta, Backspace torna al passaggio precedente. FOV fra 1° e 179°. La lunghezza grafica non è la distanza dei soggetti.

Importare dalle immagini

Create viewpoints from photos apre la selezione multipla e il riepilogo GPS/direzione. I default sono azimut 0°, FOV 40° e lunghezza 20 m, modificabili. Ogni foto spuntata crea un record; il nome del file diventa code, con suffissi per duplicati. La direzione EXIF rispetto al nord vero viene convertita in azimut di griglia; direzioni magnetiche o non definite usano il default. FOV e lunghezza restano quelli predefiniti.

Le foto senza GPS utilizzabile si possono escludere o conservare con geometria NULL. Photos to position le elenca: scegli la foto, premi Place on map e clicca la posizione. Non si assegnano coordinate fittizie. Puoi eliminare il record con conferma, senza cancellare il file. Refresh list aggiorna dopo Annulla o altre modifiche. Salva layer e progetto.

Modifica, anteprima e metadati

Edit viewpoint mostra le maniglie per posizione, asse/lunghezza e apertura. Trascina e rilascia; un clic sul vuoto deseleziona e nasconde le maniglie. Il movimento non cambia i GPS originali. distGPS si aggiorna con un'espressione predefinita QGIS applicata agli aggiornamenti: salva il progetto per conservarne la configurazione. Un altro programma che modifica il solo SHP non esegue quell'espressione.

View photo apre l'anteprima con Open image, Open folder e Change image. Gli URL web si aprono nel browser. Cambiando immagine si aggiornano i metadati e si svuotano quelli non presenti nella nuova foto. Read photo metadata rilegge le feature selezionate, oppure tutte se non c'è selezione.

Si leggono EXIF convenzionali JPEG APP1/TIFF senza dipendenze aggiuntive: latitudine/longitudine, quota e riferimento, direzione e riferimento, data, fotocamera e datum. Per gps_x/gps_y si assume WGS84 se il datum non è dichiarato; altri datum non vengono indovinati. HEIC/RAW, MakerNotes e GPS solo XMP non sono decodificati. Nessun valore viene inventato, nessun originale è modificato o caricato online.

Apply viewpoint style

Il pulsante tavolozza apre stile, dimensione del simbolo, etichette e salvataggio riutilizzabile:

Applicare lo stile modifica simbologia ed etichette, non geometrie o parametri. La grafica SVG è incorporata come base64, senza dipendere dalla cartella del plugin.

Stile riutilizzabile in altri progetti

I nuovi layer locali salvano automaticamente un QML. In Apply viewpoint style lascia attivo Save a reusable QML / database default style per aggiornarlo. Con SHP/FlatGeobuf il file ha lo stesso nome base: rilievo.shp e rilievo.qml. Trasferiscili insieme: QGIS può caricare lo stile corrispondente quando aggiungi i dati.

Per GeoPackage/SQLite viene scritto un QML distinto per tabella e si prova a salvare anche lo stile predefinito nel database tramite QGIS. Provider o blocchi del file possono impedirlo: controlla il messaggio. Se il salvataggio interno non riesce, carica il QML da Proprietà layer → Stile → Carica stile. Salva prima le modifiche del layer. Un progetto che contiene già un proprio stile può continuare a usarlo finché non lo ricarichi.

QML conserva generatori di geometria QGIS, etichette, alias e default. Non si usa SLD come esportazione fedele perché non rappresenta tutte queste funzioni specifiche. Lo stile è portabile fra progetti QGIS, non una proprietà universale del formato SHP.

Foto nei layout

Apri Foto nel layout dalla barra del layout di stampa e scegli mappa e layer. Generate / Update aggiorna foto, didascalie e linee mantenendo posizione e dimensioni dei riquadri esistenti. Salva il progetto per conservarli. Per poter ricreare i riquadri mancanti, puoi salvare posizioni e dimensioni nel layer e confermare le modifiche del layer. I campi conservano una sola copia per presa, associata alla mappa. Le impostazioni iniziali si applicano ai nuovi riquadri senza copia. Solo layout statici in millimetri.

Verifica e pubblicazione

I test Python coprono metadati, default, record senza geometria, annullamento, schema compatibile, percorsi degli stili e calcoli di layout. Rendering nativo, salvataggio predefinito nei database e finestre richiedono il collaudo QGIS. Nel pacchetto trovi smoke_test_styles.py e gli altri test per la console QGIS.

Homepage e materiali GitHub sono preparatori: non è stato creato un repository né ottenuta approvazione QGIS. Prima della distribuzione servono contatti e URL reali, collaudo sui sistemi supportati e revisione ufficiale.

Crediti e licenza

Ideazione, requisiti e collaudo pratico: Riccardo Casoli. Assistenza a codice, icone originali e documentazione: ChatGPT / Codex (OpenAI), mediante lavoro iterativo. La manutenzione pubblica richiede un responsabile umano. Non è un prodotto ufficiale QGIS o OpenAI. GPL-3.0-or-later, testo completo in LICENSE.

Comandi e finestre di dialogo

Le schermate mostrano le finestre reali con dati dimostrativi; aspetto e traduzione dei controlli nativi dipendono da QGIS e dal sistema operativo. Dimostrazioni animate.

ComandoA cosa serve
Crea nuovo Layer ViewpointsCrea un layer vuoto.
Inserimento manualeTre clic, poi codice e foto.
Importazione di fotoImporta più immagini e leggi il GPS.
Foto da posizionareCompleta le prese senza GPS.
Modifica presaSeleziona la presa e trascina le maniglie.
Anteprima fotoApri l’anteprima grande con un clic.
Stile delle preseScegli simbolo e dimensione.
Metadati fotoRileggi i metadati delle immagini del layer.
Foto nel layoutDa menu o barra del layout di stampa.

Crea nuovo Layer Viewpoints · Create new Viewpoints layer

Nome layer/file: assegna un nome. Formato di salvataggio: temporaneo o uno dei formati disponibili. CRS: scegli un sistema proiettato con unità in metri. Cartella: indica dove scrivere il file, se hai scelto un formato persistente. Conferma con OK.

Crea nuovo Layer Viewpoints
Crea nuovo Layer Viewpoints · esempio

Inserimento manuale · Create viewpoint then link photo

Fai clic nell’ordine su posizione, asse di ripresa (direzione e lunghezza grafica), poi su un bordo del campo visivo (apertura totale 1–179°). Nella finestra successiva conferma il codice univoco e, facoltativamente, seleziona il file della foto. Annulla interrompe l’inserimento; salva poi le modifiche del layer.

Inserimento manuale
Inserimento manuale · esempio

Importazione di foto · Create viewpoints from photos

La tabella mostra quali immagini hanno una posizione GPS e quali richiedono un clic manuale. Spunta le righe da importare o escludi in blocco quelle senza GPS. I tre valori sotto la tabella impostano azimut predefinito, apertura e lunghezza grafica. Una direzione EXIF valida riferita al nord vero ha precedenza sull’azimut predefinito.

Importazione di foto
Importazione di foto · esempio

Foto da posizionare · Photos to position

Nel pannello seleziona una riga, attiva il posizionamento e fai clic in mappa. Eliminare la riga rimuove il record, non il file immagine.

Foto da posizionare
Pannello delle foto da posizionare

Modifica presa · Edit viewpoint

Fai clic sulla presa. Trascina il cerchio centrale per spostarla, il quadrato sull’asse per cambiare direzione e lunghezza, il quadrato sul bordo per cambiare apertura. Rilascia per applicare, usa Esc per annullare un trascinamento in corso. Un clic lontano dalle prese toglie la selezione. Salva le modifiche del layer.

Anteprima foto · Open photo preview (click a viewpoint)

La miniatura compare automaticamente sulla mappa quando il layer delle prese è attivo e la foto è locale. Attiva questo comando e fai clic sulla presa per aprire la finestra grande. I pulsanti permettono di aprire il file, aprire la cartella o cambiare immagine.

Anteprima foto
Anteprima foto · esempio

Stile delle prese · Apply viewpoint style

Simbolo sceglie raggi, fotocamera, freccia o settore. Dimensione simbolo controlla la dimensione in millimetri. Puoi mostrare il codice, salvare uno stile riutilizzabile o creare una copia GeoPackage con campi inglesi.

Stile delle prese
Stile delle prese · esempio

Metadati foto · Read photo metadata

Rilegge le foto collegate alle prese selezionate, o a tutto il layer se non c’è una selezione, e aggiorna i valori EXIF/GPS nel layer, senza spostare le prese. Controlla i campi aggiornati e salva le modifiche del layer.

Foto nel layout · Layout Photos

Scegli mappa e layer. I valori in mm impostano dimensioni massime e spaziatura per i nuovi riquadri. In Contenuto e aspetto della didascalia spunta e ordina i campi; “Nome file immagine” ricava il nome da photo. Imposta carattere, dimensione, allineamento, colore e opacità. Genera / aggiorna conserva i riquadri già sistemati; salva il progetto. Salva posizioni e dimensioni dei riquadri nel layer crea una copia per recuperare riquadri rimossi: per conservarla conferma anche le modifiche del layer.

Foto nel layout
Foto nel layout · esempio