3DG PhotoMatch
per SketchUp

1Cos'è 3DG PhotoMatch

3DG PhotoMatch ricava la camera da cui è stata scattata una fotografia. Il risultato è una scena di SketchUp che guarda il modello esattamente come l'obiettivo guardava la realtà, con la foto sullo sfondo.

Ti servono tre cose:

• una fotografia (JPG, PNG, BMP o TIFF);
• un modello 3D, anche semplice, della parte che si vede nella foto;
• alcuni punti riconoscibili sia nella foto sia nel modello: spigoli, angoli, basi di pilastri, incroci.

Tu indichi le coppie di punti: un clic sulla foto, un clic sullo stesso punto nel modello. Il plugin calcola posizione, orientamento e focale della camera, e ti dice di quanti pixel sbaglia ogni punto.

2Requisiti

Senza connessione il plugin continua a lavorare per 72 ore (vedi il capitolo 8).

La licenza per SketchUp vale solo per SketchUp: quella per 3ds Max è separata.

3Installazione

Il pacchetto è un file 3DG_PhotoMatch_SketchUp_<versione>.rbz, lo stesso per tutte le versioni di SketchUp.

1. Apri SketchUp.
2. Finestra › Extension Manager.
3. Premi Installa estensione e scegli il file .rbz.
4. SketchUp avvisa che l'estensione non è firmata o chiede conferma: conferma l'installazione.

Nell'Extension Manager il plugin compare come 3DG PhotoMatch - Camera Matching.

Il plugin parla la lingua di SketchUp; la cambi dal pannello (vedi 6.2).

Più versioni di SketchUp. L'installazione vale solo per la versione in cui la fai: installa il file .rbz dall'Extension Manager di ognuna. La licenza invece vale per il computer: la attivi una volta e la trovano tutte.

4Primo avvio

4.1Dove si trova il comando

Menu Estensioni › 3DG PhotoMatch e barra degli strumenti 3DG PhotoMatch (due pulsanti con la stessa icona: il suggerimento che compare col mouse dice quale è quale). I nomi dei comandi sono in inglese in qualunque lingua:

4.2Prova gratuita

La prima volta che apri il plugin su un computer senza licenza, compare una domanda che spiega la prova, con i collegamenti al Contratto di licenza e all'Informativa privacy. Le risposte sono tre: Sì = Comincia la prova gratuita, No = Ho già una chiave, Annulla = Chiudi.

1. Scegli Sì, scrivi il tuo indirizzo nella casella Email e conferma.
2. Ti arriva un codice di sei cifre. Scrivilo nella casella Codice e conferma.
   Se non arriva, chiudi la finestra del codice con Annulla: il plugin ti chiede se mandarlo di nuovo (Sì = Invia di nuovo).
3. La prova dura 7 giorni, con tutte le funzioni attive.

Reinstallare il plugin non fa ripartire il conteggio.

Se chiudi la finestra della prova senza attivare niente, il pannello non si apre.

4.3Attivare la licenza acquistata

1. Scegli No = Ho già una chiave nella domanda della prova, oppure apri il collegamento Licenza... nella barra in alto del pannello e premi Inserisci una chiave.
2. Nella casella Inserisci una chiave scrivi la chiave ricevuta con l'acquisto (formato XXXXX-XXXXX-XXXXX-XXXXX).
3. Conferma. Compare Licenza attivata su questo computer.

5Come si usa, passo per passo

5.1Carica la foto

Apri Create: il pannello si apre vuoto. Premi Carica foto e scegli la foto; lo stesso pulsante serve per cambiarla dopo.

Se la foto è stata scattata in verticale e la fotocamera l'ha scritto nell'EXIF, il plugin la raddrizza da solo.

5.2Metti le coppie di punti

Per ogni coppia:

1. Clic sulla foto nel punto scelto. Il punto compare con il suo numero e la scritta (scegli il 3D), e pulsa in arancione finché la coppia non è completa.
2. Clic sullo stesso punto nel modello. Valgono le inferenze abituali di SketchUp (estremo, punto medio, intersezione...).
3. Nel modello compare un marker numerato e il punto sulla foto diventa verde. La coppia entra nell'elenco.

Per interrompere una coppia a metà: ESC.

Quanti punti e dove:

• ne servono almeno 4;
• meglio 6–8, ben distribuiti su tutta la foto, anche vicino ai bordi e agli angoli;
• su profondità diverse: non tutti sulla stessa facciata, ma anche davanti e dietro;
• evita punti allineati o ammassati in una zona;
• scegli punti che vedi con sicurezza sia nella foto sia nel modello.

Con almeno 6 punti ben sparsi il calcolo può anche verificare la focale della foto (vedi 6.1).

5.3Calcola la camera

Da 4 coppie in su compare Calcola camera: premilo. La vista passa a una scena provvisoria, 3DG PhotoMatch preview, con la camera calcolata e la foto dietro.

Dopo il primo calcolo, ogni modifica ai punti (aggiunta, spostamento, cancellazione, annullamento) ricalcola la camera da sola.

Sulla foto vedi i tuoi punti (verdi) e, in azzurro, dove la camera calcolata proietta gli stessi punti.

5.4Leggi lo scarto di ogni punto

L'elenco dei punti sta a destra della foto: il pulsante Punti lo chiude e lo riapre. Dopo il calcolo, la colonna scarto px dice di quanti pixel della foto il punto calcolato cade lontano da quello che hai messo.

Se un punto è rosso:

1. Controlla sulla foto che sia davvero nel posto giusto. Zooma e trascinalo se serve.
2. Controlla nel modello che il marker stia sul punto giusto. Puoi spostarlo, oppure rifare il clic sul modello con Ripicca il 3D del punto scelto (vedi 5.6).
3. Se non trovi l'errore, eliminalo: la camera si ricalcola senza di lui.
4. Aggiungi altri punti in zone della foto ancora vuote.

Se lo scarto resta alto su tutti i punti, controlla che il modello corrisponda davvero alla realtà fotografata (misure, proporzioni).

5.5Salva la scena

Premi Salva in SketchUp. Nasce una scena che si chiama 3DG PhotoMatch001 (poi 002, 003...), con la camera calcolata e la foto come sfondo Match Photo. Il Resoconto si apre da solo: focale, campo visivo, scarto medio, confronto con i dati EXIF. Lo riapri quando vuoi con il pulsante Resoconto.

Dopo il salvataggio i punti e i marker vengono tolti. I punti non sono persi: restano scritti nella scena e li riprendi con Modifica camera (capitolo 7).

Se chiudi il pannello a metà lavoro, il plugin chiede cosa fare:

• camera calcolata ma non ancora salvata: Sì = Crea camera (nasce la scena, come con Salva in SketchUp), No = Scarta e chiudi, Annulla = Annulla (torni al pannello);
• punti messi ma calcolo non ancora fatto: OK = Scarta e chiudi, Annulla = Annulla.

Chiudendo senza salvare, la vista torna com'era e i marker vengono tolti.

5.6Mouse e tasti

Sulla foto:

Nel modello: i marker sono gruppi PM_Point_N. Puoi spostarli con lo strumento Sposta: il pannello rilegge la posizione. Se ne cancelli uno, la sua coppia viene tolta.

Nell'elenco dei punti: un clic su una riga evidenzia il punto sulla foto e seleziona il marker; la ✕ in fondo alla riga (Cancella questo punto) elimina la coppia. Il pulsante Cancella tutto, nella barra in alto, le toglie tutte.

6Opzioni

6.1Focale dall'EXIF

Casella focale dall'EXIF, nella barra in alto.

Quando la foto porta una focale attendibile, la posizione della camera è molto più precisa. È accesa di serie; se la spegni, il plugin ricorda la scelta per le volte successive.

La casella cambia da sola a seconda della foto:

• EXIF non disponibile (grigia): la foto non porta una focale utilizzabile, per esempio perché è stata ritoccata e risalvata o ritagliata. La focale viene cercata dal calcolo;
• EXIF ignorato: con almeno 6 punti ben distribuiti il plugin confronta la focale della foto con quella dei punti. Se differiscono di oltre il 15% crede ai punti. Succede spesso con i telefoni. Il resoconto dice perché. La casella resta così, grigia, fino alla foto successiva.

Spegnila se i dati EXIF peggiorano il risultato: a volte non sono corretti già all'origine. Toccarla fa ripartire il calcolo; riaccenderla fa ripetere il confronto con i punti.

6.2Lingua

La tendina nel pannello: otto lingue (italiano, inglese, tedesco, francese, spagnolo, portoghese, russo, cinese). Il cambio vale subito nel pannello e resta per le volte successive. Il testo che compare nella barra di stato di SketchUp passando sui comandi cambia lingua al prossimo avvio; i nomi dei comandi restano in inglese.

6.3La camera in SketchUp

SketchUp non ha tipi di camera fra cui scegliere. Il risultato è sempre una scena con la camera calcolata e la foto come sfondo Match Photo. Le camere di SketchUp non portano la distorsione dell'obiettivo: se la foto è molto distorta ai bordi, correggila prima nel tuo programma di sviluppo RAW.

7Riprendere il lavoro

7.1Modifica camera

1. Menu Estensioni › 3DG PhotoMatch › Edit, oppure pulsante Modifica camera nel pannello.
2. Se nel modello ci sono più scene di 3DG PhotoMatch, scegli quale dall'elenco. Quella attiva è proposta per prima.
3. Il pannello si apre con la foto, i punti e i marker, e ricalcola.
4. Correggi i punti e premi Aggiorna camera: si aggiorna la stessa scena.

La foto di sfondo della scena resta quella. Se il file della foto non si trova più, il plugin te lo dice e ti chiede di sceglierla: i punti vanno rimessi.

La scena porta già con sé camera e foto: per tornare a un'inquadratura basta cliccare la sua scheda.

8Licenza

Prova. 7 giorni con tutte le funzioni, per un indirizzo email e un computer. Nella riga della licenza, in alto nel pannello, vedi quanti giorni restano (Prova: restano N giorni, poi Prova: ultimo giorno). Alla fine il plugin ti dice che la prova gratuita è terminata e propone Sì = Acquista, No = Ho già una chiave, Annulla = Chiudi.

Licenza completa. Perpetua, aggiornamenti futuri compresi.

Due computer, uno alla volta. Puoi registrare la licenza su due computer, ma usarla su uno per volta.

• Se apri il plugin sul secondo computer mentre la licenza è in uso sul primo, il plugin chiede se spostarla qui (La sposto su questo computer?). Se rispondi Sì, il primo la perde finché non se la riprende: quando lo riapri, gli chiede se riprenderla (Riprenderla su questo computer?).
• Un terzo computer non si può registrare finché non ne liberi uno.

Il riepilogo Licenza... mostra lo stato della licenza, l'email, la chiave (in parte nascosta), la scadenza della prova, il nome di questo computer e l'ultimo controllo. I pulsanti sono Inserisci una chiave, Libera questo computer, Diagnostica (apre il testo da copiare con Copia), Acquista (non c'è con la licenza completa) e Chiudi.

Lavorare senza connessione. Il calcolo è sul tuo computer, quindi senza rete lavori lo stesso. La connessione serve solo a ricontrollare la licenza ogni tanto.

• Se il controllo non raggiunge il server, il plugin continua a lavorare per 72 ore, contate dal primo controllo non riuscito, e riprova da solo.
• Nella riga della licenza compare (senza collegamento, restano N ore). Una finestra di avviso si apre solo quando mancano meno di 24 ore.
• Passate le 72 ore il calcolo si ferma. Collega il computer a internet e riapri il pannello: riparte tutto da solo.

Cambiare computer.

1. Sul computer vecchio: Licenza... › Libera questo computer, e conferma con Sì. Il posto torna libero.
2. Sul computer nuovo: installa il plugin e attiva la stessa chiave.

Se il computer vecchio non c'è più (guasto, formattato, sostituito) e non hai potuto liberarlo, scrivi a [email protected] dall'indirizzo email usato per l'acquisto.

9Aggiornamenti

Il plugin controlla da solo se c'è una versione nuova, poco dopo l'apertura del pannello e al massimo una volta ogni 20 ore. Non scarica e non installa niente senza di te.

Quando c'è una novità, nella barra in alto del pannello, accanto a Licenza..., compare il collegamento Aggiornamento … disponibile. Cliccandolo vedi le novità e scegli con Sì / No / Annulla; ogni riga della domanda spiega a cosa corrisponde ciascun pulsante:

La seconda domanda è Come vuoi installare 3DG PhotoMatch …?:

Se il plugin non può installarsi da solo, nella prima domanda il Sì dice Scarica adesso e porta dritto alla scelta della cartella.

Dopo aver scelto l'installazione al prossimo avvio, la riga in alto dice Aggiornamento …: si installa al prossimo avvio. Cliccandola puoi tenerla (Sì = Va bene, lascia così) o rinunciare (No = Annullalo: non verrà installato niente).

Con più versioni di SketchUp, l'aggiornamento scaricato si installa nella versione da cui l'hai chiesto. Le altre te lo proporranno da sole.

La licenza resta com'è: dopo un aggiornamento non c'è niente da riscrivere.

10Rimozione

1. Finestra › Extension Manager.
2. Trova 3DG PhotoMatch - Camera Matching e premi Disinstalla.
3. Riavvia SketchUp.

Ripeti in ogni versione di SketchUp in cui l'avevi installato. Le scene già create restano nel modello.

Licenza e dati degli aggiornamenti restano in %APPDATA%\3DG PhotoMatch (sketchup.license.dat, sketchup.updates.json e le cartelle 3dg_update_sketchup e backups). Se reinstalli il plugin, lasciali: la licenza è già lì. Se lo togli per sempre puoi cancellarli, ma prima libera il computer: cancellare il file non libera il posto sul server. Lingua, casella dell'EXIF e posizione della finestra le tiene SketchUp nelle sue preferenze.

11Problemi frequenti

Il firewall o l'antivirus bloccano la connessione. Il plugin comunica con api.3dgsoftware.com (licenza) e 3dgsoftware.com (aggiornamenti). Se il computer è in rete ma la licenza non si verifica, controlla che il firewall, l'antivirus o il proxy aziendale lascino uscire in rete SketchUp.exe. Nel frattempo lavori per 72 ore.

Un punto è rosso. Vedi 5.4: controlla il punto sulla foto e il marker nel modello, spostalo o eliminalo, aggiungi punti in zone vuote.

Il calcolo non riesce (Impossibile calcolare la camera). Controlla che i punti siano corretti, non tutti allineati e non tutti sullo stesso piano. Aggiungi punti su profondità diverse.

La focale dell'EXIF è sbagliata. Succede con i telefoni e con le foto ritagliate o ridimensionate. Con almeno 6 punti ben sparsi il plugin se ne accorge da solo (EXIF ignorato). Altrimenti spegni tu la casella focale dall'EXIF: il calcolo riparte da solo.

Il pannello non compare. Controlla nell'Extension Manager che l'estensione sia attiva. Se hai annullato la finestra della prova o della licenza, il pannello non si apre: riprova e attiva la prova o la chiave. Le righe [3DG PM] nella Console Ruby dicono cosa è successo.

La foto è coricata. Il plugin la raddrizza secondo l'EXIF. Se non ci riesce, girala col tuo programma di fotoritocco e ricaricala.

Sono rimasti marker nel modello (dopo una chiusura improvvisa di SketchUp). Si tolgono da soli quando riapri il pannello.

12Assistenza

Scrivi a [email protected]. Risponde chi sviluppa il plugin.

Per aiutarci a capire subito, scrivi:

1. la versione del plugin: nel titolo del pannello, oppure nell'Extension Manager;
2. la versione di SketchUp (per esempio 2024);
3. cosa hai fatto e cosa è successo, passo per passo;
4. una foto dello schermo;
5. per i problemi di licenza: Licenza... › Diagnostica, premi Copia e incolla il testo nel messaggio. La diagnostica non apre nessuna connessione: sono i dati che il plugin ha già.

Per il cambio di computer o i problemi con la chiave, scrivi dall'indirizzo email usato per l'acquisto.

↑ Torna su